本文へジャンプします。

ニフクラ ユーザーガイド

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

ChangeResourceRecordSets

処理概要

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

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

1つのリクエスト内で複数のレコード作成/削除操作を指定できますが、処理の途中でエラーになった場合部分的な反映になる場合があります。

同じゾーンに対して同時に作成/削除操作のリクエストを行うと、エラーになる場合があります。

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

LBRレコードがある場合は非同期の動作ですが、同期されたことは GetChange の ChangeInfo レスポンスフィールドにて確認できます。

リクエストURL

POST https://dns.api.nifcloud.com/2012-12-12N2013-12-16/hostedzone/{ZoneID}/rrset

指定するパラメーター

パスパラメーター
パラメーター 説明 必須
ZoneID string ゾーンID
リクエストボディ
パラメーター 説明 必須
ChangeResourceRecordSetsRequest structure ルート
ChangeBatch structure レコード操作トランザクション処理
Changes list 付加情報
Change structure レコード操作の一覧
Action string レコード操作の種別
値:
  • CREATE
  • DELETE
ResourceRecordSet structure 更新リクエスト情報
Name string ゾーンID
Type string レコード種別
値:
  • NS
  • A
  • AAAA
  • CNAME
  • MX
  • TXT
  • PTR
  • LBR
SetIdentifier string レコード識別情報
Weight integer 重み付け値
備考: WRR利用時のみ設定
Region string リージョン情報
備考: 登録時無視/表示時空
XniftyDefaultHost string デフォルトホスト情報
備考: LBR利用時のみ設定、空可
Failover string フェイルオーバー種別
値:
  • PRIMARY
  • SECONDARY
備考: Failover利用時のみ設定
XniftyHealthCheckConfig structure ヘルスチェック情報
備考: Failover利用時のみ設定
IPAddress string ヘルスチェック先IPアドレス
Port integer ヘルスチェック先ポート
Protocol string ヘルスチェック種別
値:
  • HTTP
  • HTTPS
  • TCP
ResourcePath string ヘルスチェック先パス
備考: ProtocalがHTTPの場合のみ
FullyQualifiedDomainName string ヘルスチェック先ドメイン
備考: ProtocalがHTTPの場合のみ
TTL integer TTL値
備考: LBRの場合不要
ResourceRecords list レコードの応答情報のリスト
ResourceRecord structure レコードの応答情報
Value string レコードの応答値
XniftyComment string コメント

応答フィールド

フィールド (項目) 説明
ChangeResourceRecordSetsResponse structure ルート
ChangeInfo structure 更新リクエスト情報
Id string 更新リクエストID
Status string 反映ステータス
値:
  • PENDING
  • INSYNC
SubmittedAt string

更新リクエスト発行日時

  • 値:yyyy-mm-ddThh:mm:ss.mmmZ

エラー

コード メッセージ タイプ HTTPステータスコード 説明
NoSuchHostedZone

No hosted zone found

Sender 404 URLパラメーター「marker」で指定されたゾーンIDが存在しない
AccessDenied

Locked zone

Sender 403 対象ゾーンを更新中のためアクセス不可

リクエストサンプル

    POST /2012-12-12N2013-12-16/hostedzone/example.com/rrset HTTP/1.1
Host: dns.api.nifcloud.com
Date: Thu, 17 Jun 2021 08:53:44 GMT
X-Nifty-Authorization: NIFTY3-HTTPS NiftyAccessKeyId=<Nifty Cloud Access Key>,Algorithm=<HmacSHA1|HmacSHA256>,Signature=<Signature>

<?xml version="1.0" encoding="UTF-8"?>
<ChangeResourceRecordSetsRequest xmlns="https://route53.amazonaws.com/doc/2012-12-12/">
<ChangeBatch>
  <Changes>
    <Change>
      <Action>CREATE</Action>
      <ResourceRecordSet>
        <Name>test.example.com</Name>
        <Type>A</Type>
        <TTL>60</TTL>
        <ResourceRecords>
          <ResourceRecord>
            <Value>1.1.1.1</Value>
          </ResourceRecord>
        </ResourceRecords>
      </ResourceRecordSet>
    </Change>
  </Changes>
  <Comment>コメント</Comment>
</ChangeBatch>
</ChangeResourceRecordSetsRequest>

  

応答サンプル

    <?xml version="1.0" encoding="UTF-8"?>
<ChangeResourceRecordSetsResponse xmlns="https://route53.amazonaws.com/doc/2012-12-12/">
  <ChangeInfo>
    <Id>63d71bec8c03bb55f9e7bfe021297542</Id>
    <Status>INSYNC</Status>
    <SubmittedAt>2021-06-17T08:53:44.110Z</SubmittedAt>
  </ChangeInfo>
</ChangeResourceRecordSetsResponse>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2021年9月17日時点の情報です。

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