本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> DNS> GetHostedZone
本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/dns/api/GetHostedZone.htmへ移行しました。 今後は新ページをご参照ください。

GetHostedZone

処理概要

ゾーン情報を取得します。

取得するゾーン情報の指定は、リクエストURL内に含まれるゾーンIDにて行います。

取得される情報は、ゾーン情報、ネームサーバー情報の2つです。

リクエスト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>

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

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