PowerPoint プレゼンテーション

Size: px

Start display at page:

Download "PowerPoint プレゼンテーション"

そよきちや
5 years ago
Views:

1 NTT Communications Cloudⁿ DNS API マニュアル Ver.1.0 本冊子掲載の内容の二次配布 ( 配布転載提供等 ) はご遠慮ください 1

2 版数編集日変更内容 Ver /03/12 初版作成 2

3 目次 1 はじめに P4~ 1) サービスの概要 2) 事前に準備いただくもの 2 API リクエスト方法 P6~ 1) API リクエストの形式 3 DNSサービスを利用する P9~ 1) DNS 情報の作成 2) DNS 情報の確認 4 DNS API リファレンス P14~ 1) DNS API 一覧 2) DNS API 共通情報 3) DNS API ( ゾーン操作 ) 4) DNS API ( リソースレコード操作 ) 3

1-1) サービスの概要本マニュアルでは Cloud n DNS のご利用方法に関してご説明いたします Cloud n DNS は他の Cloud n サービスと連携したダイナミック DNS サービスであり AWS における Route 53 サービスに相当します Cloudn Load Balancer Advance と組み合わせることで可用性の高い大規模な Web

DNSへ登録するホスト情報となります 1ゾーンにつきリソースレコード数の上限は10,000となります 1ゾーンに対し 1か月当たりのクエリ数上限は100 万です加重ラウンドロビン (Weighted Round-robin) には対応していませんレイテンシーベースルーティング (Latency Based Routing) には対応していません Zone Apexには対応していません

4 1-1) サービスの概要本マニュアルでは Cloud n DNS のご利用方法に関してご説明いたします Cloud n DNS は他の Cloud n サービスと連携したダイナミック DNS サービスであり AWS における Route 53 サービスに相当します Cloudn Load Balancer Advance と組み合わせることで可用性の高い大規模な Web サービスを提供することが可能です主な提供機能は以下の通りですダイナミックDNSサービスダイナミックDNSサービスとしてホストゾーンの作成編集削除その中に含まれるリソースレコードの作成編集削除が可能ですゾーンとはDNSがドメインを管理する単位で 1ドメインが1ゾーンとなります 1アカウントにつきホスティング可能なゾーン数の上限は100となりますリソースレコードとは DNSへ登録するホスト情報となります 1ゾーンにつきリソースレコード数の上限は10,000となります 1ゾーンに対し 1か月当たりのクエリ数上限は100 万です加重ラウンドロビン (Weighted Round-robin) には対応していませんレイテンシーベースルーティング (Latency Based Routing) には対応していません Zone Apexには対応していませんただし AWS Route53 API 互換のエイリアスターゲット指定機能により Cloudn Load Balancer Advanceで自動的に付与されたDNS 名をホスト名 +ドメイン名 ( 例 : にマップすることができますワイルドカードエントリをサポートしますサポートするリソースレコードタイプは下記のとおりです A AAAA CNAME MX NS PTR SOA SPF SRV TXT Amazon Route 53 互換 Amazon Route 53 API 互換の API を提供します準拠する Amazon Route 53 API バージョンはになります API 経由でゾーンやリソースレコードの作成更新削除が可能です 4

5 1-2) 事前に準備いただくもの Clound n DNS API をご利用頂くにあたっては以下のご準備をお願いします DNS サービスの利用開始 Clound n ポータルより DNS サービスの利用を開始して下さいサービスの利用開始方法については Clound n ポータル操作マニュアルの 3-1) サービスの利用を開始するを参照下さい Clound n サービス共通の API アクセスキーおよび秘密鍵 Clound n ポータルにて DNS API 利用に必要なサービス共通の API アクセスキーおよび秘密鍵をご確認下さい確認方法については Clound n ポータル操作マニュアルの 3-3) API アクセスキー秘密鍵を管理するを参照下さい 5

6 1 2-1) API リクエストの形式本サービスでは DNS サービスのゾーンの作成削除ならびにリソースレコードの作成削除を行うための API を提供しています API を使用することでお客様のプログラムから直接リソースを操作することが可能ですまた本 API は AmazonWebService Route53 互換 API( Version) ですなおサービスを利用するための接続先 URL である API Server(endpoint) URL は以下の通りです API server (endpoint) URL : 2 API リクエストレスポンスは HTTPS にて行います HTTP はサポートされていません API リクエストの生成方法を解説します DNS サービスのリクエストは REST 形式となります例えば本サービスによって管理するゾーンの一覧を取得する ListHostedZone API リクエストは以下のようになります GET/ /hostedzone HTTP/1.1 date: Fri, 08 Mar :47:41 GMT X-Amzn-Authorization: AWS3-HTTPS AWSAccessKeyId=key,Algorithm=HmacSHA1,Signature=s1gnAture host: dns-api.jp-e1.cloudn-service.com 以下上記のリクエストを例に Cloudⁿ DNS APIへのリクエストの生成方法を解説します Cloudⁿ DNS APIのリクエスト形式は一般的なHTTPのリクエストと同様に Request Mehtod Path(?query string) Protocol Version () () ( ) (Body) となります API リクエストの認証が必要となるため HTTP リクエストに認証値を含める必要があります Cloud n DNS API リクエストの認証にはリクエストに X-Amzn-Authorization 拡張 HTTP ヘッダーを用います 6

7 2-1) API リクエストの形式 X-Amzn-Authorization 拡張 HTTP ヘッダーに格納する値 ( 認証値 ) の書式は以下の通りです AWS3-HTTPS AWSAccessKeyId=< アクセスキー >,Algorithm=< 署名のアルゴリズム >,Signature=< 署名の値 > Cloudⁿ DNS API のリクエストの認証はアクセスキーとそれと対になる秘密鍵によって生成された Keyed-Hash による認証値 (Keyed-HMAC) によって行われます上記の < アクセスキー > には事前に取得したアクセスキーの値を署名アルゴリズムには Keyed- HMAC のアルゴリズムを示す HmacSHA256 あるいは HmacSHA1 の値を < 署名の値 > には Algorithm で指定した電子署名アルゴリズムを用いてい作成した電子署名を Base64 でエンコードした値を含めます次に Signature に格納する < 署名の値 > の作成方法の作成方法について説明します電子署名の作成は 1. 電子署名対象の文字列の決定 2. 電子署名アルゴリズムの決定 3. 電子署名の作成と Base64 エンコードのステップで行いますまず電子署名の対象に含める文字列を作成します Cloudⁿ DNS API の電子署名の対象に含める値は UTF-8 でエンコードされた Date ヘッダーの値になりますなお x-amz-date 拡張 HTTP ヘッダーをリクエストに含めた場合はその値を用いますこのことはリクエストに Date もしくは xamz-date は必ず含める必要があることを意味します Date ヘッダーならびに x-amz-date 拡張 HTTP ヘッダーの書式は下記の表のいずれかになります書式例 strftime(3) でのフォーマット説明 Sun, 06 Nov :49:37 GMT "%a, %d %b %Y %R:%S GMT" RFC1123 Sunday, 06-Nov-94 08:49:37 GMT "%A, %d-%b-%y %R:%S GMT" RFC1036 Sun Nov 6 08:49: "%a %b %e %R:%S %Y" ANSI C asctime() Date ヘッダーの値 ( もしくは x-amz-date 拡張 HTTP ヘッダーの値 ) が確定したら電子署名のアルゴリズムを決定します Cloudⁿ DNS API でサポートしているアルゴリズムは次の通りですアルゴリズム HMAC SHA256 HMAC SHA1 X-Amzn-Authorization に含める際の表現 HmacSHA256 HmacSHA1 7

8 署名対象文字列 (Date もしくは x-amz-date ヘッダーの値 ) に対して事前に取得した秘密鍵と決定したアルゴリズムを用いて電子署名を作成し作成した電子署名を Base64 でエンコードしますつまり 2-1) API リクエストの形式署名の値 = Base64( Algorithm((Date ヘッダーの値 ), 秘密鍵 ) ) となりますアクセスキーアルゴリズムおよび作成した署名の値を X-Amzn-Authorization ヘッダーの所定の位置 ( 下記の例を参照 ) に配置し X-Amzn-Authorization をリクエストのヘッダーに含めることでリクエストとします GET/ /hostedzone HTTP/1.1 date: Fri, 08 Mar :47:41 GMT X-Amzn-Authorization: AWS3-HTTPS AWSAccessKeyId=key,Algorithm=HmacSHA1,Signature=s1gnAture host: dns-api.jp-e1.cloudn-service.com なお API のメソッドによってはリクエストに Body に XML を付与するものもありますがリクエストの認証に用いる X-Amzn-Authorization ヘッダーの生成方法に違いはありません 8

9 Cloudⁿ DNS API を利用した Cloudⁿ DNS サービスの利用の流れを示します Cloudⁿ DNS API を利用した基本的な作業の流れは 1. Cloudⁿ DNS API を利用した情報の作成登録 2. Cloudⁿ DNS API を利用した登録状況の確認ここでは example.com というゾーンを作成登録し SOA レコードの確認までの流れを紹介しますゾーンを作成する際に利用する API メソッドは CreateHostedZone で Body に XML を付与し前述の方法で作成した X-Amzn-Authorization ヘッダーを挿入して HTTP の POST メソッドを用いてリクエストを発行します ( 詳細は DNS API リファレンス参照 ) リクエストの全体像は以下のようになります 3-1) DNS 情報を登録する部 Body 部 (XML) POST / /hostedzone HTTP/1.1 date: Mon, 11 Mar :33:58 GMT x-amzn-authorization: AWS3-HTTPS AWSAccessKeyId=Samp1eKey,Algorithm=HmacSHA256,Signature=Sy0me1des4u host: dns-api.jp-e1.cloudn-service.com content-length: 283 <CreateHostedZoneRequest> <Name>example.com</Name> <CallerReference>0caaf24ab1a0c33440c06afe99df986365b0781f</CallerReference> <HostedZoneConfig> <Comment>'example.com' is created at 'Mon, 11 Mar :33:58 GMT'</Comment> </HostedZoneConfig> </CreateHostedZoneRequest> 9

10 リクエストが正常に受け付けられると以下の様なレスポンスが返されます date: Mon, 11 Mar :33:07 GMT etag: "e48aa57343bdb5a3a15fbe1f4f2aaab6" cache-control: max-age=0, private, must-revalidate x-request-id: f3c8044cf10a138db37a7c6b x-runtime: x-rack-cache: invalidate, pass x-frame-options: SAMEORIGIN status: 201 content-length: 998 connection: close content-type: text/xml; charset=utf-8 3-1) DNS 情報を登録する <?xml version="1.0" encoding="utf-8"?> <CreateHostedZone xmlns=" <HostedZone> <Id>/hostedzone/99E </Id> <Name>example.com</Name> <CallerReference>0caaf24ab1a0c33440c06afe99df986365b0781f</CallerReference> <Config> <Comment>example.com is created at Mon, 11 Mar :33:04 GMT</Comment> </Config> <ResourceRecordSetCount>2</ResourceRecordSetCount> </HostedZone> <ChangeInfo> <Id>/change/cafedeadbeaf</Id> <Status>PENDING</Status> <SubmittedAt> T10:33:07.545Z</SubmittedAt> </ChangeInfo> <DelegationSet> <NameServers> <NameServer>ns-05.dns.jp-e1.cloudn-service.com</NameServer> <NameServer>ns-06.dns.jp-e1.cloudn-service.com</NameServer> <NameServer>ns-07.dns.jp-e1.cloudn-service.com</NameServer> </NameServers> </DelegationSet> </CreateHostedZone> に示した Id は以後作成登録したゾーンに対して何らかの操作をする際に指定する ID となります 2 の ChangeInfo Tag に含まれる Id はリクエストが受け付けられた後に 1 に示した DNS サーバに反映されたかどうかを確認する際のチケットになります DNS へのは反映を確認するには GetChange API を呼び出すことによって確認しますまた上記のレスポンス中 3 の NameServer Tag の値がリクエストしたゾーンを管理する権威サーバ (Authoritative DNS) となります 10

11 3-1) DNS 情報を登録する GetChange は HTTP のリクエストメソッドに GET を指定し Request Path に / /change/<id> となります上記の例では Request Path は / /change/cafedeadbeaf となります CreateHostedZone のレスポンス中の Id Tag の値をそのまま利用すると change が重複することになるのでご注意下さい GetChange のリクエストは以下のようになります GET / /change/cafedeadbeaf HTTP/1.1 date: Tue, 12 Mar :57:53 GMT x-amzn-authorization: AWS3-HTTPS AWSAccessKeyId=,Algorithm=HmacSHA256,Signature=S1gNatyaaaadayou= host: dns-api.jp-e1.cloudn-service.com GetChange API のレスポンスは以下のようになります date: Tue, 12 Mar :57:55 GMT etag: "027a3c2600d368c95d3bb38c1c615629" cache-control: max-age=0, private, must-revalidate x-request-id: 209a1abaaa7e737d3f4b696e0460c9d5 x-runtime: x-rack-cache: miss x-frame-options: SAMEORIGIN status: 200 content-length: 285 connection: close content-type: text/xml; charset=utf-8 <?xml version="1.0" encoding="utf-8"?> <GetChange xmlns=" <ChangeInfo> <Id>cafedeadbeaf</Id> <Status>INSYNC</Status> 4 <SubmittedAt> T10:33:07.000Z</SubmittedAt> </ChangeInfo> </GetChange> 4 に示した Status Tag の値が INSYNC であれば 3 に示した権威サーバに登録が反映されたことを示しますまた PENDING であれは権威サーバに情報が完全には反映されていないことを示しているため反映完了までお待ちください 11

12 date: Mon, 11 Mar :34:34 GMT etag: "aa4c7518de f25c138cf7512e3" cache-control: max-age=0, private, must-revalidate x-request-id: 810a84b3e53b2a2d6949c96db0e5a789 x-runtime: x-rack-cache: miss x-frame-options: SAMEORIGIN status: 200 content-length: 1209 connection: close content-type: text/xml; charset=utf-8 3-2) DNS 情報を確認する次に examle.com のリソースレコードの登録状況を API を用いて確認しますリソースレコードの確認には ListResourceRecordSets を利用します ListResourceRecordSets は Request Path / /hostedzone/<zone_id>/rrset に対して GET メソッドを発行することで実行しますこの例では Request Path は / /hostedzone/99E /rrset となります ListResourceRecordSets のレスポンスは以下の通りです (1 が登録されているリソースレコードリストになります ) <?xml version="1.0" encoding="utf-8"?> <ListResourceRecordSets xmlns=" <ResourceRecordSets> <ResourceRecordSet> <Name>example.com.</Name> <Type>SOA</Type> <TTL>60</TTL> <ResourceRecords> <ResourceRecord> <Value>ns-05.dns.jp-e1.cloudn-service.com. root.cloudn2.net </Value> </ResourceRecord> </ResourceRecords> </ResourceRecordSet> <ResourceRecordSet> <Name>example.com.</Name> <Type>NS</Type> <TTL>60</TTL> <ResourceRecords> <ResourceRecord> 1 <Value>ns-05.dns.jp-e1.cloudn-service.com.</Value> </ResourceRecord> <ResourceRecord> <Value>ns-06.dns.jp-e1.cloudn-service.com.</Value> </ResourceRecord> <ResourceRecord> <Value>ns-07.dns.jp-e1.cloudn-service.com.</Value> </ResourceRecord> </ResourceRecords> </ResourceRecordSet> </ResourceRecordSets> <IsTruncated>false</IsTruncated> <MaxItems>100</MaxItems> </ListResourceRecordSets> 12

13 最後に dig(1) を用いて SOA レコードが権威サーバに登録されていることを確認しますゾーンやレコードが登録された権威サーバは ListHostedZone や CreateHostedZone のレスポンスで確認できます本書の例では ns-05.dns.jp-e1.cloudn-service.com ns-06.dns.jp-e1.cloudn-service.com ns-07.dns.jp-e1.cloudn-service.com 3-2) DNS 情報を確認するとなります以下に ns-05.dns.jp-e1.cloudn-service.com に dig(1) で example.com の SOA レコードを確認する方法を示します % -t soa example.com +norec ; <<>> DiG P1 -t soa example.com +norec ; (1 server found) ;; global options: +cmd ;; Got answer: ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: ;; flags: qr aa; QUERY: 1, ANSWER: 1, AUTHORITY: 3, ADDITIONAL: 0 ;; QUESTION SECTION: ;example.com. IN SOA ;; ANSWER SECTION: example.com. 60 IN SOA ns-05.dns.jp-e1.cloudn-service.com. root.cloudn2.net ;; AUTHORITY SECTION: example.com. 60 IN NS ns-06.dns.jp-e1.cloudn-service.com. example.com. 60 IN NS ns-07.dns.jp-e1.cloudn-service.com. example.com. 60 IN NS ns-05.dns.jp-e1.cloudn-service.com. ;; Query time: 5 msec ;; SERVER: #53( ) ;; WHEN: Tue Mar 12 11:52: ;; MSG SIZE rcvd:

14 API 名前説明 POST CreateHostedZone 4-1) DNS API 一覧本サービスにて提供している API は下記となります新しいホストゾーンを作成します送信されたリクエストには CreateHostedZoneRequest 要素を記述した XML ドキュメントが含まれる必要があります GET GetHostedZone DELETE DeleteHostedZone GET ListHostedZones 指定したホストゾーンの詳細情報を取得しますホストゾーンを削除しますホストゾーン一覧情報を取得しますこの API ではデフォルトですべてのホストゾーンが表示されます Marker パラメータを利用することにより一覧表示されるゾーンの開始位置を指定することができます MaxItems パラメータを利用することにより一覧表示するゾーン数を指定することができます例 :maxitems=1&marker= 表示したいホストゾーン名上記のようなパラメータを指定することで任意のホストゾーン情報を表示することができます POST ChangeResourceRecordSets 作成したホストゾーンへレコードの追加 / 削除を行いますリクエストには ChangeResourceRecordSetsRequest 要素が記述された XML ドキュメントが含まれる必要があります GET ListResourceRecordSets リソースレコードのリストを取得します GET GetChange POST CreateHostedZone POST ChangeResourceRecordSets のステータスを取得しますステータスは以下のうちのどれかになります PENDING は変更要求が全ての Cloud n DNS にレプリケーションされていないことを表します変更リクエストの初期状態です INSYNC は変更要求が全ての Cloud n DNS にレプリケーションされていることを表します 14

15 4-2) DNS API 共通情報本サービスにて提供している API Server (End Point) は下記となります以下のテーブルに Cloud n DNS の REST API Request において用いる形式を示します Common Request ヘッダー名 X-Amzn-Authorization Content-Length Content-Type Date Host 説明認証に使用する ( ヘッダー内にアクセスキー秘密鍵で作成した署名署名作成時に用いた暗号アルゴリズムが含まれる ) ヘッダーを除いたリクエストの長さ (Byte) このヘッダーは XML をアップロードする PUT request で必要となるリソースのコンテンツタイプを指定する POST や PUT の場合は必須となるリクエスト送信時の日時を指定するこの日付を使用して X-Amzn-Authorization ヘッダーを作成する x-amx-date が記述されていない場合必須となる 100-continue を指定した場合 Acknowledgement がかえるまで Body を送信しないによって reject メッセージを受取った場合 Body は送信しない Valid Values: 100-continue x-amz-date この日付を使用して X-Amzn-Authorization ヘッダーを作成する Date が記述されていない場合必須となる Common ヘッダー名 x-amz-request-id 説明リクエスト ID として返却される 15

16 4-3) DNS API ( ゾーン操作 ) POST CreateHostedZone 概要新しいホストゾーンを作成しますホストゾーンを作成するためには POST リクエストを /hostedzone に送信します送信されたリクエストには CreateHostedZoneRequest 要素を記述した XML ドキュメントが含まれる必要がありますレスポンスはホストゾーンについてのメタデータが含まれた CreateHostedZone 要素が返ってきます < 重要 > トップレベルドメイン (TLD) に対してホストゾーンを作成することはできません Cloud n DNS はデフォルトの SOA レコードと 3 つの NS レコードをゾーンに対して自動的に作成しますホストゾーンの NS レコードはお客様のドメインを代理するネームサーバですゾーンを作成した際の初期ステータスは PENDING です NS レコードおよび SOA レコードが全ての Cloud n DNS で利用可能になった際にステータスは INSYNC に変更されます Request Request Method Path,Parameters, etc POST Request path に / /hostedzone を指定 Common Request を参照 Body 形式 X M L 構成 XML Node 名説明子 Node 必須 CreateHostedZoneReque st リクエストコンテナ Name, CallerReference, HostedZoneConfig Name ドメインの名前 Yes Yes CallerReference ゾーン作成毎に一意になる任意の文字列 Yes HostedZoneConfig - Comment No Comment 任意のコメント No 16

17 4-3) DNS API リファレンス ( ゾーン操作 ) Common を参照 (Body) 形式 XML 構成 XML Node 名説明子 Node CreateHostedZoneRe sponse - HostedZone, ChangeInfo, DelegationSet HostedZone - Id, Name, CallerReference, Config Id Name CallerReference 作成されたホストゾーンの ID ゾーン作成時に指定した Name ゾーン作成時に指定した CallerReference Config Comment Comment ResourceRecordSetC ount ゾーン作成時に指定した Comment ホストゾーン内に登録されているレコード数 ChangeInfo - Id, Status, SubmittedAt Id Status SubmittedAt 変更履歴 ID 現在の状態 PENDING はすべての DNS が使用可能ではないことを示す INSYNC はすべての DNS が使用可能であることを示す作成された日付 DelegationSet - NameServers NameServers - NameServer NameServer ゾーンファイルが登録されたネームサーバ 17

18 4-3) DNS API リファレンス ( ゾーン操作 ) GET GetHostedZone 概要ホストゾーンについての情報を取得します GET リクエストを /hostedzone/ Cloud n hosted zone ID に対して送信して下さい Request Request Method Path,Parameters, etc GET HostedZoneI D ホストゾーン作成時に登録されたホストゾーン ID (Request Path は / /hostedzone/<HostedZoneID>) Body Common Request を参照無し Common を参照 (Body) 形式 XML 構成 XML Node 名説明子 Node GetHostedZoneRespo nse - HostedZone, DelegationSet HostedZone - Id, Name, CallerReference, Config Id Name CallerReference 作成されたホストゾーンの ID ゾーン作成時に指定した Name ゾーン作成時に指定した CallerReference Config Comment Comment ResourceRecordSetC ount ゾーン作成時に指定した Comment ホストゾーン内に登録されているレコード数 DelegationSet - NameServers NameServers - NameServer NameServer ゾーンファイルが登録されたネームサーバ 18

19 4-3) DNS API リファレンス ( ゾーン操作 ) DELETE DeleteHostedZone 概要ホストゾーンを削除しますホストゾーンを削除するには /hostedzone/Cloud n HostedZoneID に対して DELETE リクエストを送信して下さい < 重要 > デフォルトの SOA レコードおよび NS レコード以外のリソースレコードがあった場合ホストゾーンを削除する前にそれらのレコードを削除する必要がありますレコードを含んだホストゾーンを削除しようとした場合 Cloud n DNS は HostedZoneNotEmpty エラーにより削除リクエストを拒否します Request Request Method Path,Parameters, etc DELETE HostedZone ID ホストゾーン作成時に登録されたホストゾーン ID (Request Path は / /hostedzone/<HostedZoneID>) Body Common Request を参照無し Common を参照 (Body) 形式 XML 構成 XML Node 名説明子 Node DeleteHostedZone - ChangeInfo ChangeInfo - Id, Status, SubmittedAt Id Status SubmittedAt 変更履歴 ID 現在の状態 PENDING はすべての DNS が使用可能ではないことを示す INSYNC はすべての DNS が使用可能であることを示す作成された日付 19

20 4-3) DNS API リファレンス ( ゾーン操作 ) GET ListHostedZone 概要ホストゾーンの一覧情報を取得するために /hostedzone リソースに対して GET リクエストを送信して下さいこの API ではデフォルトですべてのホストゾーンが表示されます Marker パラメータを利用することにより一覧表示されるゾーンの開始位置を指定することができます MaxItems パラメータを利用することにより一覧表示するゾーン数を指定することができます例 :maxitems=1&marker= 表示したいホストゾーン名上記のようなパラメータを指定することで任意のホストゾーン情報を表示することができます Request Request Method Path,Parameters, etc GET Request path に / /hostedzone を指定名前説明必須 marker maxitems 取得したいホストゾーンの指定を行う marker に一致したホストゾーンより maxitems で指定した数のホストゾーン一覧を返却する返却されるホストゾーン数を指定するデフォルト :100 No No Body Common Request を参照無し Common を参照 (Body) 形式 XML 構成 XML Node 名説明子 Node ListHostedZone - Marker, HostedZones, MaxItems, IsTruncated, NextMarker HostedZones - HostedZone HostedZone - Id, Name, CallerReference, Config, ResourceRecordSetCount Id Name CallerReference 作成されたホストゾーンの ID ゾーン作成時に指定した Name ゾーン作成時に指定した CallerReference Config Comment Comment ResourceRecordSetCount Marker IsTruncated NextMarker MaxItems ゾーン作成時に指定した Comment ホストゾーン内に登録されているレコード数リクエスト時に marker を指定した場合に返却されるまだ表示されていないホストゾーンがある場合 true が返却される IsTruncated が true の場合次のホストゾーン名を返却するリクエスト時に maxitem で入力した数が返却される 20

21 4-4) DNS API ( リソースレコード操作 ) POST ChangeResourceRecordSets 概要作成したホストゾーンへレコードの追加 / 削除を行います / /hostedzone/<Cloudn HostedZone ID>/rrset リソースへ POST リクエストすることで利用できますリクエストには ChangeResourceRecordSetsRequest 要素が記述された XML ドキュメントが含まれる必要があります < 重要 > 一度の変更処理において同じリソースレコードに関する複数の処理を要求することはできませんもし要求した場合 Cloud n DNS は InvalidChangeBatch エラーを返します ChangeResouceRecordSets リクエストにより全ての Cloud n DNS サーバ上でレコードが変更されます初期ステータスは PENDING です全てのホストに伝播された際にステータスが INSYNC に変更されます以下の ChangeResourceRecordSets リクエストに対する制限にご注意下さい一つのリクエストにつき 100 以上の Change 要素を含めることはできません一つのリクエストにつき 1000 以上の ResourceRecord 要素を含めることはできません一つのリクエスト中の Value 要素における文字列の合計 ( スペースを含む ) は 32,000 文字以下である必要があります Request Request Method Path,Paramet ers, etc POST HostedZoneId ホストゾーン作成時に登録されたホストゾーン ID (Request Path は / /hostedzone/<HostedZoneID>/rrset) Common Request を参照 Body 形式 XML XML 構成 Node 名説明子 Node 必須 ChangeResourceRecordSetsRequest - ChangeBatch Yes ChangeBatch - Comment, Changes Yes Comment 任意のコメント No Changes - Change Yes Change - Action, ResourceRecordSet Yes Action CREATE DELETE のどちらかを指定 Yes ResourceRecordSet - Name, Type, Alias Target, TTL, ResourceRecords Yes Name リソースレコードに登録するドメインネームを FQDN で記述する Yes Type 登録するリソースレコードのタイプを指定 Valid values: A AAAA CNAME MX NS PTR SOA SPF SRV TXT Yes Alias Target Alias Resource Record Sets を利用する場合必須 HostedZoneId, DNSName Yes HostedZoneId LBA の Hosted zone ID Alias Resource Record Sets を利用する場合必須 Yes DNSName LBA と連携する外部の DNS ネーム Alias Resource Record Sets を利用する場合必須 Yes 21

22 4-4) DNS API ( リソースレコード操作 ) Request Body 形式 XML XML 構成 Node 名説明子 Node 必須 TTL リソースレコードの TTL Alias Resource Record Sets を利用しない場合必須 Yes ResourceRecords Alias Resource Record Sets を利用しない場合必須 ResourceRecord Yes ResourceRecord Alias Resource Record Sets を利用しない場合必須 Value Yes Value 指定した Type に対応した値 Alias Resource Record Sets を利用しない場合必須 Yes 22

23 4-4) DNS API リファレンス ( リソースレコード操作 ) Common を参照 (Body) 形式 XML 構成 XML Node 名説明子 Node ChangeResourceRecord Sets - ChangeInfo ChangeInfo - Id, Status, SubmittedAt Id Status 変更履歴 ID 現在の状態 PENDING はすべての DNS が使用可能ではないことを示す INSYNC はすべての DNS が使用可能であることを示す SubmittedAt 作成された日付 23

24 4-4) DNS API リファレンス ( リソースレコード操作 ) GET ListResourceRecordSets 概要リソースレコードのリストを取得します / /hostedzone/<Cloudn HostedZoneID>/rrset に対して GET リクエストを送信しますこのアクションは name 要素と type 要素によって指定された位置から順に指定した数のリソースレコードのリストを取得しますソート順は最初にドメイン名 (com.ntt.www のように逆順です ) 次にレコードタイプの順となります name 要素と type 要素を使ってリソースレコードのリストの表示開始位置を調節することができます < 注釈 > このアクションは PENDING ステータスのレコードを含め最新のレコード情報を返します Request Request Method Path,Parameters, etc GET HostedZone D レコードセットを取得するホストゾーンを指定する Request Path は / /hostedzone/<HostedZoneID>/rrset 名前説明必須 name ここで指定したレコードセットと一致したレコードセットから一覧を表示する No type レコードタイプを指定する No maxitems 表示するレコードセット数を指定するデフォルト :100 No Body Common Request を参照無し 24

25 4-4) DNS API リファレンス ( リソースレコード操作 ) Common を参照 (Body) 形式 XML 構成 XML Node 名説明子 Node ListResourceRecordSets - ResourceRecordSets, IsTruncated, MaxItems, NextRecordName, NextRecordType ResourceRecordSets - ResourceRecordSet ResourceRecordSet - Name, Type, TTL, ResourceRecords Name Type TTL リソースレコード名レコードタイプ TTL ResourceRecords - ResourceRecord ResourceRecord - Value Value リソースレコードに設定されている値 IsTruncated MaxItems NextRecordName リクエスト時に maxitem で入力した数が返却される IsTruncated が true の場合次のホストゾーン名を返却する NextRecordType 25

26 4-4) DNS API リファレンス ( リソースレコード操作 ) GET GetChange 概要 POST CreateHostedZone POST ChangeResourceRecordSets のステータスを取得します / /change/<change_id> に対して GET リクエストを送信しますステータスは以下のうちのどれかになります PENDING は変更要求が全ての Cloud n DNS にレプリケーションされていないことを表します変更リクエストの初期状態です INSYNC は変更要求が全ての Cloud n DNS にレプリケーションされていることを表します Request Request Method Path,Parameters, etc GET Change ID Request Path は / /change/<change_id> となる Body Common Request を参照無し (Body) Common を参照形式 XML XML 構成 Node 名説明子 Node GetChange - ChangeInfo ChangeInfo - Id, Status, SubmittedAt Id Status 変更履歴 ID 現在の状態 PENDING はすべての DNS が使用可能ではないことを示す INSYNC はすべての DNS が使用可能であることを示す SubmittedAt 作成された日付 26

2/10 ページ医者 : すいませんが少々お待ち下さい主婦 : はぁ... 医者 : カタカタカタカタ (AWS SDK Java をセットアップ中下記をご参照下さい ) サンプルコード使用例 (インストール& DNS 編 ) 主婦 : カルテを書き

2/10 ページ医者 : すいませんが少々お待ち下さい主婦 : はぁ... 医者 : カタカタカタカタ (AWS SDK Java をセットアップ中下記をご参照下さい ) サンプルコード使用例 (インストール& DNS 編 ) 主婦 : カルテを書き 1/10 ページ 2013/07/02 AWS SDK Java で使おう(CNAME 編 )... 診察室にて医者 : 次の方どうぞ主婦 : よろしくお願いします医者 : どうされましたかな? 主婦 : あのー高血圧のせいだと思うのですが頭がクラクラするんです右に行けばいいのか左に行けばいいのか結論が出ないのです医者