17.16 障害通知メールのテスト送信をする
- メモ
-
REST API を実行するユーザが、対象ストレージシステムのリソースをREST API でロックしている場合、このAPIは実行できません。その場合は、ロックを解除してから実行してください。
実行権限
ストレージ管理者(初期設定)
リクエストライン
PUT <ベースURL>/v1/objects/storages/<ストレージデバイスID>/alert-email-settings/instance/actions/send-email-test/invoke
このAPIはPOSTメソッドでも実行できます。
リクエストメッセージ
- オブジェクトID
-
instanceを指定します。
instanceは、単一のインスタンスしか持たないオブジェクトの場合に、オブジェクトIDとして指定する固定の値です。
- クエリパラメータ
-
なし。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
ジョブオブジェクトを返します。ジョブオブジェクトのスキーマについては、ジョブオブジェクトの説明を参照してください。このAPIはaffectedResourcesを表示しません。メール送信が成功したかどうかは、指定した送信先メールアドレスで、テストメールが受信されていることを確認してください。
ステータスコード
この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、HTTPステータスコードの説明を参照してください。
ステータスコード |
メッセージ |
説明 |
---|---|---|
412 |
Precondition Failed |
障害通知メールの送信の設定が無効な場合、テストメールを送信できません。 |
コード例
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X PUT https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/alert-email-settings/instance/actions/send-email-test/invoke -d ""