######################################################################
# All Rights Reserved, Copyright  FUJITSU LIMITED 2015-2021
#
# API実行サンプル名:
# 05-008_DNSゾーン作成
#
# 内容:
# 管理しているドメインにゾーンを作成する手順です。
#
#                                                版数：v1.2
#                                                更新日：2021/03/22
######################################################################


手順：
───────────────────────────────────
  項番１．認証用レコード取得
  項番２．【レジストラ】認証用レコード登録
  項番３．ゾーン作成
  項番４．ゾーン情報確認
  項番５．【レジストラ】NameServer情報更新
  項番６．レコード作成
  項番７．レコード確認
  参考１．レコード削除
    参考１－１．レコード削除
    参考１－２．レコード削除確認
  参考２．ゾーン削除
    参考２－１．ゾーン削除
    参考２－２．ゾーン削除確認
───────────────────────────────────


事前準備：
  あらかじめ以下を準備する必要があります。
───────────────────────────────────
  ・ドメイン
───────────────────────────────────


注意事項：
  ・「東日本リージョン1(jp-east-1)」にプロジェクトを作成し、その
     プロジェクトにDNSサービスを利用する（ゾーン情報、レコードの作成・
     削除等）ユーザーを登録した上で作業を実施してください。
  ・登録可能なドメインについてはIaaS機能説明書「ゾーン登録可能な
    ドメイン」を参照してください。
  ・項目名に【レジストラ】の記載のある項目は、レジストラの作業と
    なります。利用しているレジストラの操作方法に従い作業を行って
    ください。



項番１．認証用レコード取得
  ゾーン作成を実施し、ドメインの所有権を確認するための認証用レコードを
  取得します。

  注意事項：
    ・最初に本APIを実行すると「Unauthorized」エラーが発生します。
      レスポンスの「Message」に認証用レコードが表示されます。


  環境定義コマンド例：
======================================================================
# ZONE_NAME=<ドメイン名（FQDN形式で指定）>
ZONE_NAME=example.com


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone -X POST -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<?xml version="1.0" encoding="UTF-8"?><CreateHostedZoneRequest xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/"><Name>'$ZONE_NAME'</Name></CreateHostedZoneRequest>'| xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ErrorResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <Error>
    <Type>Sender</Type>
    <Code>Unauthorized</Code>
    <Message>name_server:8d16f10a03abfdb50e457da070622yj4.ns-verify.dns.nifcloud.com,txt:nifty-dns-verify=8d16f10a03abfdb50e457da070622yj4</Message>
  </Error>
  <RequestId>37a3ff17-fb75-455e-b326-8f94d1c53uhy</RequestId>
</ErrorResponse>
======================================================================



項番２．【レジストラ】認証用レコード登録
  ドメインの所有権を確認するため、利用しているレジストラに項番１で
  取得した認証用レコードを登録します。

  注意事項：
    ・新規に取得したドメインの場合は「name_server」を登録してください。
    ・既存ドメインまたはサブドメインの場合は「txt」を登録してください。
    ・登録方法については利用しているレジストラの操作方法に従って
      ください。


  項番１で取得した認証用レコード例：
======================================================================
・name_server:8d16f10a03abfdb50e457da070622yj4.ns-verify.dns.nifcloud.com
・txt:nifty-dns-verify=8d16f10a03abfdb50e457da070622yj4


  ・新規に取得したドメインの場合
    認証用NSレコードの登録例：
======================================================================
 $ORIGIN example.com.
  @ IN NS 8d16f10a03abfdb50e457da070622yj4.ns-verify.dns.nifcloud.com


  ・既存ドメインまたはサブドメインの場合
    認証用TXTレコードの登録例：
======================================================================
 $ORIGIN example.com.
  @ IN TXT "nifty-dns-verify=8d16f10a03abfdb50e457da070622yj4"



項番３．ゾーン作成
  DNSゾーン作成を行います。

  注意事項：
    ・レジストラに登録した認証用レコードが反映されるまでに時間が必要な
      場合があります。反映されていない場合は項番１と同じレスポンスが
      返ります。その場合は、時間を空けてから再度下記のゾーン作成APIを
      実行してください。


  環境定義コマンド例：
======================================================================
# ZONE_NAME=<ドメイン名（FQDN形式で指定）>
ZONE_NAME=example.com


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone -X POST -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<?xml version="1.0" encoding="UTF-8"?><CreateHostedZoneRequest xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/"><Name>'$ZONE_NAME'</Name></CreateHostedZoneRequest>' | xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<CreateHostedZoneResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <HostedZone>
    <Id>example.com</Id>
    <Name>example.com</Name>
    <CallerReference>example.com</CallerReference>
    <Config/>
    <ResourceRecordSetCount>0</ResourceRecordSetCount>
  </HostedZone>
  <ChangeInfo>
    <Id>c6ad585ee36f40778540d27fbda1u59k</Id>
    <Status>INSYNC</Status>
    <SubmittedAt>2017-09-15T07:00:40.762Z</SubmittedAt>
  </ChangeInfo>
  <DelegationSet>
    <NameServers>
      <NameServer>ns0.dns.nifcloud.com</NameServer>
      <NameServer>ns1.dns.nifcloud.com</NameServer>
    </NameServers>
  </DelegationSet>
</CreateHostedZoneResponse>
======================================================================



項番４．ゾーン情報確認
  作成したゾーンの情報を確認します。


  環境定義コマンド例：
======================================================================
# ZONE_NAME=<ドメイン名（FQDN形式で指定）>
ZONE_NAME=example.com


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone/$ZONE_NAME -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" | xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<GetHostedZoneResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <HostedZone>
    <Id>example.com</Id>
    <Name>example.com</Name>
    <CallerReference>example.com</CallerReference>
    <Config/>
    <ResourceRecordSetCount>0</ResourceRecordSetCount>
  </HostedZone>
  <DelegationSet>
    <NameServers>
      <NameServer>ns0.dns.nifcloud.com</NameServer>
      <NameServer>ns1.dns.nifcloud.com</NameServer>
    </NameServers>
  </DelegationSet>
</GetHostedZoneResponse>
======================================================================



項番５．【レジストラ】NameServer情報更新
  項番２でレジストラに登録した認証用レコードの情報を削除し、項番４で
  確認したNameServerの情報をレジストラに登録します。

  注意事項：
    ・新規に取得したドメインの場合は「name_server」を削除してください。
    ・既存ドメインまたはサブドメインの場合は「txt」を削除してください。
    ・削除方法については利用しているレジストラの操作方法に従って
      ください。


  項番４で取得したNameServer例：
======================================================================
・NameServer:ns0.dns.nifcloud.com
・NameServer:ns1.dns.nifcloud.com


  NSレコードの登録例：
======================================================================
$ ORIGIN example.com.
 @ IN NS ns0.dns.nifcloud.com.
   IN NS ns1.dns.nifcloud.com.




項番６．レコード作成
  作成したゾーンにレコードを作成します。


  環境定義コマンド例：
======================================================================
# ZONE_NAME=<ドメイン名（FQDN形式で指定）>
ZONE_NAME=example.com

# RECORD_NAME=<レコード名>
RECORD_NAME=test-server-a-record01

# RECORD_TYPE=<レコード種別（NS、A、AAAA、CNAME、MX、TXT、PTR、LBR
#             を指定）>
RECORD_TYPE=A

# RESOURCE_RECORD=<レコードの応答値>
RESOURCE_RECORD=192.168.10.20


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone/$ZONE_NAME/rrset -X POST -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<?xml version="1.0" encoding="UTF-8"?><ChangeResourceRecordSetsRequest xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/"><ChangeBatch><Changes><Change><Action>CREATE</Action><ResourceRecordSet><Name>'$RECORD_NAME'</Name><Type>'$RECORD_TYPE'</Type><TTL>60</TTL><ResourceRecords><ResourceRecord><Value>'$RESOURCE_RECORD'</Value></ResourceRecord></ResourceRecords></ResourceRecordSet></Change></Changes></ChangeBatch></ChangeResourceRecordSetsRequest>' | xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ChangeResourceRecordSetsResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ChangeInfo>
    <Id>6acc877f07109fe3a73f5d53feb864yh</Id>
    <Status>INSYNC</Status>
    <SubmittedAt>2017-09-15T09:48:16.303Z</SubmittedAt>
  </ChangeInfo>
</ChangeResourceRecordSetsResponse>
======================================================================



項番７．レコード確認
  レコードが作成できたことを確認します。


  環境定義コマンド例：
======================================================================
# ZONE_NAME=<ドメイン名（FQDN形式で指定）>
ZONE_NAME=example.com


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone/$ZONE_NAME/rrset -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" | xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ListResourceRecordSetsResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ResourceRecordSets>
    <ResourceRecordSet>
      <Name>test-server-a-record01.example.com</Name>
      <Type>A</Type>
      <SetIdentifier>42kySefs</SetIdentifier>
      <TTL>60</TTL>
      <ResourceRecords>
        <ResourceRecord>
          <Value>192.168.10.20</Value>
        </ResourceRecord>
      </ResourceRecords>
    </ResourceRecordSet>
  </ResourceRecordSets>
  <IsTruncated>false</IsTruncated>
  <MaxItems>100</MaxItems>
</ListResourceRecordSetsResponse>
======================================================================



参考１．レコード削除
  作成したレコードを削除し、削除の確認を行います。


参考１－１．レコード削除
  作成したレコードを削除します。


  環境定義コマンド例：
======================================================================
# TMP_ZONE_NAME=<ドメイン名（FQDN形式で指定）>
TMP_ZONE_NAME=example.com

# TMP_RECORD_NAME=<レコード名>
TMP_RECORD_NAME=test-server-a-record01

# RECORD_TYPE=<レコード種別（NS、A、AAAA、CNAME、MX、TXT、PTR、LBR
#             を指定）>
RECORD_TYPE=A

# RESOURCE_RECORD=<レコードの応答値>
RESOURCE_RECORD=192.168.10.20


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone/$TMP_ZONE_NAME/rrset -X POST -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<?xml version="1.0" encoding="UTF-8"?><ChangeResourceRecordSetsRequest xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/"><ChangeBatch><Changes><Change><Action>DELETE</Action><ResourceRecordSet><Name>'$TMP_RECORD_NAME'</Name><Type>'$RECORD_TYPE'</Type><ResourceRecords><ResourceRecord><Value>'$RESOURCE_RECORD'</Value></ResourceRecord></ResourceRecords></ResourceRecordSet></Change></Changes></ChangeBatch></ChangeResourceRecordSetsRequest>' | xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ChangeResourceRecordSetsResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ChangeInfo>
    <Id>f391a1d0f97b5a7f85383b47bd8a784h</Id>
    <Status>INSYNC</Status>
    <SubmittedAt>2017-09-20T07:00:00.743Z</SubmittedAt>
  </ChangeInfo>
</ChangeResourceRecordSetsResponse>
======================================================================


参考１－２．レコード削除確認
  レコードが削除されたことを確認します。


  環境定義コマンド例：
======================================================================
# ZONE_NAME=<ドメイン名（FQDN形式で指定）>
ZONE_NAME=example.com


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone/$ZONE_NAME/rrset -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" | xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ListResourceRecordSetsResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ResourceRecordSets/>
  <IsTruncated>false</IsTruncated>
  <MaxItems>100</MaxItems>
</ListResourceRecordSetsResponse>
======================================================================



参考２．ゾーン削除
  作成したゾーンを削除し、削除の確認を行います。


参考２－１．ゾーン削除
  作成したゾーンを削除します。


  環境定義コマンド例：
======================================================================
# TMP_ZONE_NAME=<ドメイン名（FQDN形式で指定）>
TMP_ZONE_NAME=example.com


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone/$TMP_ZONE_NAME -X DELETE -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" -H "Accept: application/xml" | xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<DeleteHostedZoneResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ChangeInfo>
    <Id>a5e1ae6693e8429f6d2afc98bbe7e678</Id>
    <Status>INSYNC</Status>
    <SubmittedAt>2017-09-20T07:14:00.526Z</SubmittedAt>
  </ChangeInfo>
</DeleteHostedZoneResponse>
======================================================================



参考２－２．ゾーン削除確認
  ゾーンが削除されたことを確認します。


  環境定義コマンド例：
======================================================================
# ZONE_NAME=<ドメイン名（FQDN形式で指定）>
ZONE_NAME=example.com


  API実行コマンド例：
======================================================================
curl -Ss $DNS/v1.0/hostedzone/$ZONE_NAME -X GET -H "X-Auth-Token: $OS_AUTH_TOKEN" -H "Content-Type: application/xml" | xmllint --format --encode utf-8 -


  レスポンス例：
======================================================================
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ErrorResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <Error>
    <Type>Sender</Type>
    <Code>NoSuchHostedZone</Code>
    <Message>No hosted zone found</Message>
  </Error>
  <RequestId>cfb6c834-58da-4ccd-ad62-5ecd91ce37cb</RequestId>
</ErrorResponse>
======================================================================



以上

変更履歴：
───────────────────────────────────
v1.2版：
  ・「項番６．ゾーン情報確認」を全削除（意味のない作業のため）
  ・削除に伴い以降の項番を変更