ゾーン情報の取得 (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>