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はゾーン名と同じです。
