GetHostedZone
処理概要
ゾーン情報を取得します。
取得するゾーン情報の指定は、リクエストURL内に含まれるゾーンIDにて行います。
取得される情報は、ゾーン情報、ネームサーバー情報の２つです。
リクエストURL
GET https://dns.api.nifcloud.com/2012-12-12N2013-12-16/hostedzone/{ZoneID}指定するパラメーター
パスパラメーター
| パラメーター | 型 | 説明 | 必須 |
|---|---|---|---|
| ZoneID | string |
ゾーンID |
○ |
応答フィールド
レスポンスボディ
| フィールド (項目) | 型 | 説明 |
|---|---|---|
| GetHostedZoneResponse | structure |
ルート |
| ␣HostedZone | structure |
ゾーン情報 |
| ␣␣Id | string |
ゾーンID 備考: 正規化したゾーン名 |
| ␣␣Name | string |
ゾーン名（ドメイン） 備考: 正規化したゾーン名 |
| ␣␣CallerReference | string |
ゾーン識別子 備考: 正規化したゾーン名 |
| ␣␣Config | structure |
ゾーンの付加情報 |
| ␣␣␣Comment | string |
コメント（ゾーン） 備考: リクエストで指定した値 |
| ␣␣ResourceRecordSetCount | integer |
レコード設定数 |
| ␣DelegationSet | structure |
ネームサーバー情報 |
| ␣␣NameServers | list |
NSドメインのリスト |
| ␣␣␣NameServer | string |
NSドメイン |
エラー
| コード | メッセージ | タイプ | HTTPステータスコード | 説明 |
|---|---|---|---|---|
| NoSuchHostedZone | No hosted zone found |
Sender | 404 | URLパラメーター「marker」で指定されたゾーンIDが存在しない |
リクエストサンプル
GET /2012-12-12N2013-12-16/hostedzone/example.com 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"?>
<GetHostedZoneResponse xmlns="https://route53.amazonaws.com/doc/2012-12-12/">
<HostedZone>
<Id>/hostedzone/example.com</Id>
<Name>example.com</Name>
<CallerReference>example.com</CallerReference>
<Config>
</Config>
<ResourceRecordSetCount>10</ResourceRecordSetCount>
</HostedZone>
<DelegationSet>
<NameServers>
<NameServer>ns0.dns.nifcloud.com</NameServer>
<NameServer>ns1.dns.nifcloud.com</NameServer>
</NameServers>
</DelegationSet>
</GetHostedZoneResponse>
