Media typeオブジェクト

次のオブジェクトは、mediatypeAPIに直接関連しています。

メディアタイプ

メディアタイプオブジェクトには、次のプロパティがあります。

プロパティ 型 説明
mediatypeid ID メディアタイプのID。

プロパティの動作:
- 読み取り専用
- 更新操作では必須
name string メディアタイプの名前。

プロパティの動作:
- 作成操作では必須
type integer メディアタイプで使用する転送方式。

指定可能な値:
0 - メール;
1 - スクリプト;
2 - SMS;
4 - webhook。

プロパティの動作:
- 作成操作では必須
exec_path string AlertScriptsPath サーバー設定パラメータで指定されたディレクトリに配置されているスクリプトファイルの名前（例: notification.sh）。

プロパティの動作:
- type が「Script」に設定されている場合は必須
gsm_modem string GSMモデムのシリアルデバイス名。

プロパティの動作:
- type が「SMS」に設定されている場合は必須
passwd string 認証パスワード。

プロパティの動作:
- smtp_authentication が「Normal password」に設定されている場合にサポート
provider integer メールプロバイダー。

指定可能な値:
0 - (デフォルト) 汎用SMTP;
1 - Gmail;
2 - Gmailリレー;
3 - Office365;
4 - Office365リレー。
smtp_email string 通知の送信元となるメールアドレス。

プロパティの動作:
- type が「Email」に設定されている場合は必須
smtp_helo string SMTP HELO。

プロパティの動作:
- type が「Email」に設定されている場合にサポート
smtp_server string SMTPサーバー。

プロパティの動作:
- type が「Email」に設定されている場合は必須
smtp_port integer 接続先のSMTPサーバーポート。

デフォルト: 25。

プロパティの動作:
- type が「Email」に設定されている場合にサポート
smtp_security integer 使用するSMTP接続のセキュリティレベル。

指定可能な値:
0 - (デフォルト) なし;
1 - STARTTLS;
2 - SSL/TLS。

プロパティの動作:
- type が「Email」に設定されている場合にサポート
smtp_verify_host integer SMTPのSSLホスト検証。

指定可能な値:
0 - (デフォルト) いいえ;
1 - はい。

プロパティの動作:
- smtp_security が「STARTTLS」または「SSL/TLS」に設定されている場合にサポート
smtp_verify_peer integer SMTPのSSLピア検証。

指定可能な値:
0 - (デフォルト) いいえ;
1 - はい。

プロパティの動作:
- smtp_security が「STARTTLS」または「SSL/TLS」に設定されている場合にサポート
smtp_authentication integer 使用するSMTP認証方式。

指定可能な値:
0 - (デフォルト) なし;
1 - 通常のパスワード。

プロパティの動作:
- type が「Email」に設定されている場合にサポート
status integer メディアタイプが有効かどうか。

指定可能な値:
0 - (デフォルト) 有効;
1 - 無効。
username string ユーザー名。

プロパティの動作:
- smtp_authentication が「Normal password」に設定されている場合にサポート
maxsessions integer 並列処理できるアラートの最大数。

type が「SMS」に設定されている場合の指定可能な値: 1。

type が「Email」、「Script」、または「Webhook」に設定されている場合の指定可能な値: 0-100。

デフォルト: 1。
maxattempts integer アラートの送信を試行する最大回数。

指定可能な値: 1-100。

デフォルト: 3。
attempt_interval string 再試行間隔。
秒数（例: 1、60、300）、または時間のサフィックス付きの値（例: 30s、1m、1h）を指定できます。

指定可能な値: 0-1h。

デフォルト: 10s。
content_type
(非推奨)		 integer このパラメータは非推奨です。代わりに message_format を使用してください。
メッセージ形式。

指定可能な値:
0 - プレーンテキスト;
1 - (デフォルト) HTML。

プロパティの動作:
- type が「Email」に設定されている場合にサポート
message_format integer メッセージ形式。

指定可能な値:
0 - プレーンテキスト;
1 - (デフォルト) HTML。

プロパティの動作:
- type が「Email」に設定されている場合にサポート
script text webhookスクリプト本体（JavaScript）。

プロパティの動作:
- type が「Webhook」に設定されている場合は必須
timeout string webhookスクリプトのタイムアウト。
秒数（例: 1、60）、または時間のサフィックス付きの値（例: 30s、1m）を指定できます。

指定可能な値: 1-60s。

デフォルト: 30s。

プロパティの動作:
- type が「Webhook」に設定されている場合にサポート
process_tags integer webhookスクリプトのレスポンスに含まれるJSONプロパティの値をタグとして処理します。これらのタグは、既存の障害タグに追加されます。

指定可能な値:
0 - (デフォルト) webhookスクリプトのレスポンスを無視;
1 - webhookスクリプトのレスポンスをタグとして処理。

プロパティの動作:
- type が「Webhook」に設定されている場合にサポート
show_event_menu integer カスタムURLへのリンクを含む項目をevent menuに追加します。また、problem.getおよびevent.getの出力に urls プロパティを追加します。

指定可能な値:
0 - (デフォルト) event menu項目または urls プロパティを含めない;
1 - event menu項目と urls プロパティを含める。

プロパティの動作:
- type が「Webhook」に設定されている場合にサポート
event_menu_url string event menu項目およびproblem.getとevent.getが返す urls プロパティで使用するURL。

プロパティの動作:
- show_event_menu が「Include event menu entry and urls property」に設定されている場合にサポート
event_menu_name string event menu項目およびproblem.getとevent.getが返す urls プロパティで使用する名前。

プロパティの動作:
- show_event_menu が「Include event menu entry and urls property」に設定されている場合にサポート
parameters array Webhookまたはスクリプトのパラメータ。

プロパティの動作:
- type が「Webhook」または「Script」に設定されている場合にサポート
description text メディアタイプの説明。

webhookパラメータ

webhookパラメータには以下のプロパティがあります。

プロパティ 型 説明
name string パラメータ名。

プロパティの動作:
- 必須
value string パラメータ値。マクロをサポートします。
サポートされるマクロについては、サポートされるマクロページを参照してください。

スクリプトパラメータ

スクリプトパラメータには、以下のプロパティがあります。

プロパティ Type 説明
sortorder integer パラメータ値がコマンドライン引数としてスクリプトに渡される順序です。最初の引数は 0 から始まります。

プロパティの動作:
- 必須
value string パラメータ値です。マクロをサポートします。
サポートされるマクロについては、サポートされるマクロ ページを参照してください。

メッセージテンプレート

メッセージテンプレートオブジェクトは、通知を送信するためのアクションの実行時にデフォルトメッセージとして使用されるテンプレートを定義します。次のプロパティがあります。

プロパティ Type 説明
eventsource integer イベントソース。

使用可能な値:
0 - トリガー;
1 - ディスカバリ;
2 - 自動登録;
3 - 内部;
4 - サービス。

プロパティの動作:
- 必須
recovery integer 実行モード。

使用可能な値:
0 - 実行;
1 - 復旧時の実行;
2 - 更新時の実行。

プロパティの動作:
- 必須
subject string メッセージの件名。
message string メッセージ本文。