DNS:ChangeResourceRecordSets
処理概要
レコードの作成、削除を行います。
リクエストボディにて作成/削除するレコード情報を入力し、それにもとづいてレコード情報の作成/削除が行われます。
1つのリクエスト内で複数のレコード作成/削除操作を指定できますが、処理の途中でエラーになった場合部分的な反映になる場合があります。
同じレコードに対して同時に作成/削除操作のリクエストを行うと、エラーになる場合があります。
レコード作成/削除は即時反映ではないため、レスポンスには作成された更新リクエスト情報が含まれ、これの反映ステータスがPENDINGからINSYNCに変わったタイミングが反映完了となります。
リクエストURL
https://dns.api.nifcloud.com/2012-12-12N2013-12-16/hostedzone/[ゾーンID]/rrset
リクエスト方法
POST
呼び出しタイプ
非同期(LBRレコードがない場合同期)
リクエスト
パラメーター
なし
ボディ
要素名 | 説明 | 必須 | 値 | 最大値 | デフォルト値 | 備考 |
---|---|---|---|---|---|---|
ChangeResourceRecordSetsRequest | ルート | ○ | − | − | − | |
ChangeBatch | レコード操作トランザクション処理 | ○ | − | − | − | |
Comment | レコード操作トランザクション処理に対するコメント | 文字列 | − | − | ||
Changes | 付加情報 | ○ | − | − | − | |
Change | レコード操作の一覧 | ○ | 文字列 | − | − | |
Action | レコード操作の種別 値:CREATE | DELETE |
○ | 文字列 | − | − | |
ResourceRecordSet | レコード情報 | ○ | − | − | − |
レスポンス
XML
要素名 | 説明 | 値 | 備考 |
---|---|---|---|
ChangeResourceRecordSetsResponse | ルート | − | |
ChangeInfo | 更新リクエスト情報 | − |
エラー
コード | メッセージ | HTTPステータスコード | 説明 |
---|---|---|---|
NoSuchHostedZone | No hosted zone found | 404 | URLパラメーター「marker」で指定されたゾーンIDが存在しない |
AccessDenied | Locked zone | 403 | 対象ゾーンを更新中のためアクセス不可 |
備考
URLのゾーンIDはゾーン名と同じです。