レコード情報の一覧取得　(GET /v1.0/hostedzone/{ゾーンID}/rrset)

レコードの情報を一覧で取得します。

リクエスト内のURLパラメーターにより、取得を開始するレコード情報の名前（ドメイン）、種別、識別情報と、最大取得件数を指定できます。

リクエストのidentiferだけでレコード特定できますが、特定したレコードと指定したname、type一致しない場合、特定失敗とみなします。

例えば、URLパラメーターで名前（name）と種別（type）を指定した場合には、指定した名前と種別が一致するレコードを先頭にしてレコード情報が一覧取得されます。

また、識別情報だけを指定した場合には、識別情報が一致するレコードを先頭にしてレコード情報が一覧取得されます。

ただし、識別情報が一致する場合でも、指定した名前や種別が一致しない場合には、レコードが特定できません。

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

Request Headers

なし

Request Parameter

name

レコード名(ドメイン)。FQDN形式。

Data Type	Cardinality
String	0..1

type

レコード種別。

NS、A、AAAA、CNAME、MX、TXT、PTR、LBR、SRV。

Data Type	Cardinality
String	0..1

identifer

レコード識別情報。

登録時にシステムが作成したランダム文字列。

Data Type	Cardinality
String	0..1

maxitems

取得レコード最大件数。最大100。

省略時は100となる。

Data Type	Cardinality
String	0..1

Request Elements

なし

HTTP ステータス

ステータス

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

以下のうちのどれか。

200:: 正常終了
400:: maxitemsが1～100でない
404:: ゾーンIDで指定したゾーンが存在しない

Data Type	Cardinality
Int	1..1

Response Elements（正常終了時）

ListResourceRecordSetsResponse

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

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..1	None	ResourceRecordSets IsTruncated MaxItems NextRecordName NextRecordType NextRecordIdentifier

Data Type

Cardinality

Parent Element

Child Element(s)

1..1

None

ResourceRecordSets

IsTruncated

MaxItems

NextRecordName

NextRecordType

NextRecordIdentifier

ResourceRecordSets

レコード情報リストのエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..1	ListResourceRecordSetsResponse	ResourceRecordSet

ResourceRecordSet

レコード情報のエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..n	ResourceRecordSets	Name Type SetIdentifier Weight XniftyDefaultHost Failover XniftyHealthCheckConfig TTL ResourceRecords XniftyComment

Data Type

Cardinality

Parent Element

Child Element(s)

1..n

ResourceRecordSets

Name

Type

SetIdentifier

Weight

XniftyDefaultHost

Failover

XniftyHealthCheckConfig

TTL

ResourceRecords

XniftyComment

Name

レコード名。

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

Type

レコード種別。

NS、A、AAAA、CNAME、MX、TXT、PTR、LBR、SRV。

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

SetIdentifier

レコード識別情報。

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

Weight

重み付け値。

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

XniftyDefaultHost

デフォルトホスト情報。

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

Failover

フェイルオーバー種別。PRIMARYまたはSECONDARY。

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

XniftyHealthCheckConfig

ヘルスチェック情報のエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	0..1	ResourceRecordSet	IPAddress Port Protocol ResourcePath FullyQualifiedDomainName

Data Type

Cardinality

Parent Element

Child Element(s)

0..1

ResourceRecordSet

IPAddress

Port

Protocol

ResourcePath

FullyQualifiedDomainName

IPAddress

ヘルスチェック先IPアドレス。

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

Port

ヘルスチェック先ポート。

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

Protocol

ヘルスチェック種別。

HTTP、HTTPS、TCP。

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

ResourcePath

ヘルスチェック先パス。

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

FullyQualifiedDomainName

ヘルスチェック先ドメイン名。

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

TTL

TTL値。

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

ResourceRecords

レコードの応答情報リストのエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..1	ResourceRecordSet	ResourceRecord

ResourceRecord

レコードの応答情報のエンベロープ。

Data Type	Cardinality	Parent Element	Child Element(s)
-	1..n	ResourceRecords	Value

Value

レコード応答値。

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

XniftyComment

コメント。

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

IsTruncated

取得していないレコード情報がまだ存在しているかどうか。trueまたはfalse。

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

MaxItems

リクエストで指定した取得レコード最大件数。

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

NextRecordName

取得していないレコード情報の取得開始レコード名。

IsTruncatedがtrueの場合に設定される。

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

NextRecordType

取得していないレコード情報の取得開始レコード名。

IsTruncatedがtrueの場合に設定される。

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

NextRecordIdentifier

取得していないレコード情報の取得開始レコード名。

IsTruncatedがtrueの場合に設定される。

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

Example of Request


GET /hostedzone/example.com/rrset 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"?>
< ListResourceRecordSetsResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ResourceRecordSets>
    <ResourceRecordSet>
      <Name>example.com</Name>
      <Type>MX</Type>
      <SetIdentifier>uLrNgSC4yzg=</SetIdentifier>
      <TTL>60</TTL>
      <ResourceRecords>
        <ResourceRecord>
          <Value>10 mail.example.com</Value>
        </ResourceRecord>
      </ResourceRecords>
    </ResourceRecordSet>
    <ResourceRecordSet>
    ・・・
    </ResourceRecordSet>
  </ResourceRecordSets>
  <IsTruncated>false</IsTruncated>
  <MaxItems>100</MaxItems>
</ListResourceRecordSetsResponse>

レコード情報の一覧取得 (GET /v1.0/hostedzone/{ゾーンID}/rrset)

Request Headers

Request Parameter

Request Elements

HTTP ステータス

Response Elements（正常終了時）

Example of Request

Example of Response

レコード情報の一覧取得　(GET /v1.0/hostedzone/{ゾーンID}/rrset)