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>