List 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
HTTPステータスコード#
正常時:200
エラー時:400
リクエストパラメータの説明#
名前 | In | Type | デフォルト値 /必須指定 |
Description |
---|---|---|---|---|
marker | body | string | 任意 | 取得開始ゾーンID 指定しない場合は、ゾーン情報の先頭から取得されます。 |
maxitems | body | string | 100 任意 |
取得レコード最大件数(最大100) 省略時は100です。 |
レスポンスボディ(正常系)の説明#
名前 | Type | Description |
---|---|---|
ListHostedZonesResponse | - | レスポンスのエンベロープ |
HostedZones | - | ゾーン情報リストのエンベロープ |
HostedZone | - | ゾーン情報のエンベロープ |
Id | string | ゾーンID ゾーン名と同じ値です。 |
Name | string | ゾーン名 正規化された値です。 |
CallerReference | string | ゾーン識別子 ゾーン名と同じ値です。 |
Config | - | 付加情報のエンベロープ |
Comment | string | コメント |
ResourceRecordSetCount | string | ホストゾーン内に登録されているレコード数 |
Marker | string | リクエストで指定した取得開始ゾーンID |
IsTruncated | string | 取得していないゾーン情報がまだ存在しているかどうかを表します。 trueまたはfalseが表示されます。 |
NextMarker | string | 取得していないゾーン情報の取得開始ゾーンID IsTruncatedがtrueの場合に設定されます。 |
MaxItems | string | リクエストで指定した取得レコード最大件数 |
リクエスト例#
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…
レスポンス例#
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>