List record information#

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

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

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

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

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

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

※ゾーン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/{ゾーンID}/rrset

HTTPステータスコード#

正常時:200

エラー時:400, 404

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定
Description
name body string 任意 レコード名(ドメイン)
FQDN形式です。
type body string 任意 レコード種別
NS、A、AAAA、CNAME、MX、TXT、PTR、SRV
identifer body string 任意 レコード識別情報
登録時にシステムが作成したランダム文字列です。
maxitems body string 任意 取得レコード最大件数
最大は100です。
省略時は100です。

レスポンスボディ(正常系)の説明#

名前 Type Description
ListResourceRecordSetsResponseListResourceRecordSets Response - レスポンスのエンベロープ
ResourceRecordSets - レコード情報リストのエンベロープ
ResourceRecordSet - レコード情報のエンベロープ
Name string レコード名
Type string レコード種別
NS、A、AAAA、CNAME、MX、TXT、PTR、SRV
SetIdentifier string レコード識別情報
Weight string 重み付け値
Failover string フェイルオーバー種別
PRIMARYまたはSECONDARY
XniftyHealthCheckConfig - ヘルスチェック情報のエンベロープ
IPAddress string ヘルスチェック先IPアドレス
Port string ヘルスチェック先ポート
Protocol string ヘルスチェック種別
HTTP、HTTPS、TCP
ResourcePath string ヘルスチェック先パス
FullyQualifiedDomainName string ヘルスチェック先ドメイン名
TTL string TTL値
ResourceRecords - レコードの応答情報リストのエンベロープ
ResourceRecord - レコードの応答情報のエンベロープ
Value string レコード応答値
XniftyComment string コメント
IsTruncated string 取得していないレコード情報がまだ存在しているかどうかを表します。trueまたはfalse
MaxItems string リクエストで指定した取得レコード最大件数
NextRecordName string 取得していないレコード情報の取得開始レコード名
IsTruncatedがtrueの場合に設定されます。
NextRecordType string 取得していないレコード情報の取得開始レコード名
IsTruncatedがtrueの場合に設定されます。
NextRecordIdentifier string 取得していないレコード情報の取得開始レコード名
IsTruncatedがtrueの場合に設定されます。

リクエスト例#

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…     
     

レスポンス例#

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>