GET recipient/(mails)

API情報

管理権限HTTPメソッドAPI名/(サブAPI名)目的
不要GETrecipient/(mails)通知先メール情報一覧の取得
  • 通知先メールアドレスの一覧を取得します。

 

個別パラメータ

URL
フィールドタイプ必須意味
DoServiceCodeString

DNSアウトソースサービスのサービスコード

DowOptionCodeStringサイトフェイルオーバーオプションのサービスコード
ZoneNameString操作対象のゾーン名 (例: example.jp)
  • 操作対象のゾーン名は、 GET zonesで取得した文字列を指定してください。
HTTPリクエストボディ
  • なし

 

レスポンス

フィールドタイプ意味

MailRecipientList

Array

通知先メール情報のリスト

MailRecipientList.MailRecipientIdString通知先メール情報のID
MailRecipientList.MailAddressString通知先メールアドレス

 

エラーコード

エラーHTTP Status CodeErrorTypeErrorMessage説明備考
パラメータエラー200
ParameterErrorThere are invalid parameters.

以下のパラメータの形式が不正

  • DoServiceCode
  • DowOptionCode
  • ZoneName
 
リソースエラー200ResourceNotExistResource is not found.

以下いずれかのリソースが存在しない

  • 契約情報
  • オプション情報
  • ゾーン 

 

UnrelateErrorResource is unrelated to other resources.

以下それぞれのリソースの組み合わせが正しくない

  • 契約情報
  • オプション情報
  • ゾーン 
 

 

制限

  • 契約外のゾーン情報は取得できません。

サンプル

リクエスト

GET /r/(APIVersion)/(DoServiceCode)/(DowOptionCode)/(ZoneName)/recipient/mails.json HTTP/1.1
Host: do.api.iij.jp
Date: Mon, 20 Jan 2014 12:34:56 GMT
x-iijapi-Expire: (Expire)
x-iijapi-SignatureMethod: (SignatureMethod)
x-iijapi-SignatureVersion: (SignatureVersion)
Authorization: IIJAPI (AccessKeyId):(Signature)

レスポンスボディ

JSON
{
    "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
    "MailRecipientList": [
        {
            "MailRecipientId": "12",
            "MailAddress": "aaaa@example.com"
        },
        {
            "MailRecipientId": "15",
            "MailAddress": "bbbb@example.com"
        },
    ]
}