ゾーン情報の一覧取得 (GET /v1.0/hostedzone)
ゾーンの情報を一覧で取得します。
リクエスト内のURLパラメーターにより、取得する一覧の先頭のゾーンID、取得する一覧の最大件数を指定することができます。
※ゾーンIDはゾーン名と同じ値です。
Request Headers
なし
Request Parameter
marker
取得開始ゾーンID。
指定しない場合は、ゾーン情報の先頭から取得される。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
maxitems
取得レコード最大件数。最大100。
省略時は100となる。
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Request Elements
なし
HTTP ステータス
ステータス
リクエストのステータスを返却する。
以下のうちのどれか。
- 200：
- 正常終了
- 400：
- markerで指定したゾーンIDが存在しない／maxitemsが1～100でない
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
Response Elements（正常終了時）
ListHostedZonesResponse
レスポンスのエンベロープ。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| - | 1..1 | None | HostedZones
Marker IsTruncated NextMarker MaxItems |
HostedZones
ゾーン情報リストのエンベロープ。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| - | 1..1 | ListHostedZonesResponse | HostedZone |
HostedZone
ゾーン情報のエンベロープ。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| - | 1..n | HostedZones | 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 |
Marker
リクエストで指定した取得開始ゾーンID。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 0..1 | ListHostedZonesResponse | None |
IsTruncated
取得していないゾーン情報がまだ存在しているかどうか。
trueまたはfalse。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | ListHostedZonesResponse | None |
NextMarker
取得していないゾーン情報の取得開始ゾーンID。
IsTruncatedがtrueの場合に設定される。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 0..1 | ListHostedZonesResponse | None |
MaxItems
リクエストで指定した取得レコード最大件数。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | ListHostedZonesResponse | None |
Example of Request
GET /hostedzone 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"?>
< ListHostedZonesResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
<HostedZones>
<HostedZone>
<Id>example.com</Id>
<Name>example.com</Name>
<CallerReference>example.com</CallerReference>
<Config>
<Comment>comment</Comment>
</Config>
<ResourceRecordSetCount>0</ResourceRecordSetCount>
</HostedZone>
<HostedZone>
・・・
</HostedZone>
</HostedZones>
<IsTruncated>false</IsTruncated>
<MaxItems>100</MaxItems>
</ListHostedZonesResponse>