Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


17.12 障害通知メールの設定情報を取得する

ストレージシステムの障害情報(SIM)をメールで通知するための設定情報を取得します。

実行権限

ストレージ管理者(参照)

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/alert-email-settings/instance

リクエストメッセージ

オブジェクトID

instanceを指定します。

instanceは、単一のインスタンスしか持たないオブジェクトの場合に、オブジェクトIDとして指定する固定の値です。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "isEmailNotificationEnabled" : true,
  "mailServer" : {
    "serverName" : "server1",
    "smtpAuth" : {
      "isSmtpAuthEnabled" : false,
      "account" : "user1",
      "password" : "****"
    }
  },
  "fromAddress" : "from@example.com",
  "replyToAddress" : "replyTo@example.com",
  "toAddresses" : [
   {
    "attribute" : "to",
    "address" : "to@example.com"
   } 
  ],
  "description" : "description"
}

属性

説明

isEmailNotificationEnabled

boolean

障害通知メールの通知が有効かどうか
  • true:有効
  • false:無効

mailServer

object

メール送信サーバの設定

障害通知メールのメール送信サーバについて、メール送信サーバのIPアドレスまたはホスト名と、SMTP認証の設定の情報が出力されます。

  • serverName(string)

    メール送信サーバのIPアドレスまたはホスト名

  • smtpAuth(object)

    メール送信サーバのSMTP認証の設定

    • isSmtpAuthEnabled(boolean)

      SMTP認証が有効かどうか

      true:有効

      false:無効

    • account(string)

      SMTP認証のアカウント(ユーザ名)

    • password(string)

      SMTP認証のパスワード

      設定されている場合、****(4桁のアスタリスク)が出力されます。

      設定されていない場合、空文字が出力されます。

fromAddress

string

障害通知メールの送信元(from:)アドレス

replyToAddress

string

障害通知メールの返信先(reply-to:)アドレス

toAddresses

object[]

障害通知メールの送信先アドレスの配列

障害通知メールの送信先アドレスが設定されている場合、次の情報が出力されます。
  • attribute(string)

    障害通知メールの送信先アドレスの属性

    toccまたはbccが出力されます。

  • address(string)

    障害通知メールの送信先アドレス

description

string

障害通知メールの本文先頭に表示する内容

通知する付加情報として、障害通知メールの本文先頭に表示する内容が出力されます。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/alert-email-settings/instance