本文へジャンプします。

ニフティクラウド APIリファレンス

クラウド トップ>API>DNS>ChangeResourceRecordSets

DNS:ChangeResourceRecordSets

処理概要

レコードの作成、削除を行います。

リクエストボディにて作成/削除するレコード情報を入力し、それにもとづいてレコード情報の作成/削除が行われます。

1つのリクエスト内で複数のレコード作成/削除操作を指定でき、それらは1つのトランザクション処理として扱われ部分的に反映されることはありませんが、同じレコードに対して同時にアクセスした場合は、部分的な反映になる場合があります。

レコード作成/削除は即時反映ではないため、レスポンスには作成された更新リクエスト情報が含まれ、これの反映ステータスがPENDINGからINSYNCに変わったタイミングが反映完了となります。

リクエストURL

https://dns.api.cloud.nifty.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はゾーン名と同じです。

推奨画面サイズ 1024×768 以上