ニフクラAPI (DNS: GetChange)

GetChange

処理概要

更新リクエスト情報を取得します。

情報を取得する更新リクエスト情報は、リクエスト内で更新リクエストIDを指定することで行います。

本APIは更新系API成功時の更新リクエストIDのみ対応しています。

リクエストURL

GET https://dns.api.nifcloud.com/2012-12-12N2013-12-16/change/{ChangeID}

指定するパラメーター

パスパラメーター

パラメーター	型	説明	必須
ChangeID	string	更新リクエストID	○

応答フィールド

フィールド (項目)	型	説明
GetChangeResponse	structure	ルート
␣ChangeInfo	structure	更新リクエスト情報
␣␣Id	string	更新リクエストID
␣␣Status	string	反映ステータス 値: PENDING INSYNC
␣␣SubmittedAt	string	更新リクエスト発行日時 値：yyyy-mm-ddThh:mm:ss.mmmZ

エラー

コード	メッセージ	タイプ	HTTPステータスコード	説明
NoSuchChange	No change found	Sender	404	URLパス内に記述された更新リクエストIDが存在しない

リクエストサンプル

    GET /2012-12-12N2013-12-16/change/d3b94826ee9e598b36e40ee1e95ec72e 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"?>
<GetChangeResponse xmlns="https://route53.amazonaws.com/doc/2012-12-12/">
  <ChangeInfo>
    <Id>d3b94826ee9e598b36e40ee1e95ec72e</Id>
    <Status>INSYNC</Status>
    <SubmittedAt>2021-06-17T08:53:44.110Z</SubmittedAt>
  </ChangeInfo>
</GetChangeResponse>