ゾーン情報の取得 (GET /v1.0/hostedzone/{ゾーンID})

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

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

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

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

Request Headers

なし

Request Parameter

なし

Request Elements

なし

HTTP ステータス

ステータス

リクエストのステータスを返却する。

以下のうちのどれか。
200:
正常終了
400:
ゾーンID不正
404:
ゾーンIDで指定したゾーンが存在しない
Data Type Cardinality
Int 1..1

Response Elements(正常終了時)

GetHostedZoneResponse

レスポンスのエンベロープ。

Data Type Cardinality Parent Element Child Element(s)
- 1..1 None HostedZone

DelegationSet

HostedZone

ゾーン情報のエンベロープ。

Data Type Cardinality Parent Element Child Element(s)
- 1..1 GetHostedZoneResponse Id

Name

CallerReference

Config

ResourceRecordSetCount

Id

ゾーンID。ゾーン名と同じ値。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 HostedZone None

Name

ゾーン名。正規化された値。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 HostedZone None

CallerReference

ゾーン識別子。ゾーン名と同じ値。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 HostedZone None

Config

付加情報のエンベロープ。

Data Type Cardinality Parent Element Child Element(s)
- 1..1 HostedZone Comment

Comment

コメント。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 0..1 Config None

ResourceRecordSetCount

ホストゾーン内に登録されているレコード数。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 HostedZone None

DelegationSet

ネームサーバ情報のエンベロープ。

Data Type Cardinality Parent Element Child Element(s)
- 1..1 GetHostedZoneResponse NameServers

NameServers

ネームサーバリストのエンベロープ。

Data Type Cardinality Parent Element Child Element(s)
- 1..1 DelegationSet NameServer

NameServer

ゾーンに割り当てられたネームサーバ。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..n NameServers None

Example of Request


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…   
     

Example of Response


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>