Retrieve zone information#

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

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

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

※ゾーンIDはゾーン名と同じ値です。

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://dns.gls.cloud.global.fujitsu.com
東日本リージョン3の場合 https://dns.gls.cloud.global.fujitsu.com

HTTPメソッドとURI#

GET

/v1.0/hostedzone/{ゾーンID}

HTTPステータスコード#

正常時:200

エラー時:400, 404

レスポンスボディ(正常系)の説明#

名前 Type Description
GetHostedZoneResponse - レスポンスのエンベロープ
HostedZone - ゾーン情報のエンベロープ
Id string ゾーンID
ゾーン名と同じ値です。
Name string ゾーン名
正規化された値です。
CallerReference string ゾーン識別子
ゾーン名と同じ値です。
Config - 付加情報のエンベロープ
Comment string コメント
ResourceRecordSetCount string ホストゾーン内に登録されているレコード数
DelegationSet - ネームサーバ情報のエンベロープ
NameServers - ネームサーバリストのエンベロープ
NameServer string ゾーンに割り当てられたネームサーバ

リクエスト例#

GET /hostedzone/example.com HTTP/1.1
Date: Fri, 06 Jun 2014 11:00:37 GMT
Content-Length: 
Host: dns.gls.cloud.global.fujitsu.com
Accept: application/xml
X-Auth-Token: MIIFvgY…   

レスポンス例#

HTTP/1.1 200 OK
Date: Fri, 06 Jun 2014 11:00:38 GMT
Content-Length: 
Content-Type: application/xml
x-fj-request-id: d96bd874-9bf2-11e1-8ee7-c98a0037a2b6
 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
< GetHostedZoneResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <HostedZone>
    <Id>example.com</Id>
    <Name>example.com</Name>
    <CallerReference>example.com</CallerReference>
    <Config>
      <Comment>comment</Comment>
    </Config>
    <ResourceRecordSetCount>0</ResourceRecordSetCount>
  </HostedZone>
  <DelegationSet>
    <NameServers>
      <NameServer>ns0.dns.nifcloud.com</NameServer>
      <NameServer>ns1.dns.nifcloud.com</NameServer>
    </NameServers>
  </DelegationSet>
</GetHostedZoneResponse>