DNS：CreateHostedZone
処理概要
ゾーンの作成を行います。
リクエストボディにてゾーンの作成に必要な情報を入力し、それにもとづいてゾーンが作成されます。
作成したゾーンのドメインをユーザーが所持している場合、認証なしでゾーンが作成されます。
作成したゾーンのドメインをユーザーが所持していない場合、ゾーン作成前に認証が行われるため、Unauthorizedエラーが発生します。
Unauthorized発生の場合、エラーメッセージにある認証情報をレジストラまたはDNSに設定し、再度本APIを実行してください。
認証に失敗した場合は、ゾーンは作成されずエラーが返されます。
リクエストURL
https://dns.api.nifcloud.com/2012-12-12N2013-12-16/hostedzone
リクエスト方法
POST
呼び出しタイプ
同期
リクエスト
パラメーター
なし
ボディ
| 要素名 | 説明 | 必須 | 値 | 最大値 | デフォルト値 | 備考 |
|---|---|---|---|---|---|---|
| CreateHostedZoneRequest | ルート | ○ | − | − | − | |
| Name | ゾーン名（ドメイン） | ○ | 文字列 | − | − | |
| CallerReference | ゾーン識別子 | 文字列 | − | − | 無視 | |
| HostedZoneConfig | 付加情報 | − | − | − | ||
| Comment | コメント（ゾーン） | 文字列 | 255 | − |
レスポンス
XML
| 要素名 | 説明 | 値 | 備考 |
|---|---|---|---|
| CreateHostedZoneResponse | ルート | − | |
| HostedZone | ゾーン情報 | − | |
| ChangeInfo | 更新リクエスト情報 | − | |
| DelegationSet | ネームサーバー情報 | − |
エラー
| コード | メッセージ | HTTPステータスコード | 説明 |
|---|---|---|---|
| InvalidDomainName | Invalid hosted zone name | 404 | ゾーン名(ドメイン)の指定が不正 |
| HostedZoneAlreadyExists | A hosted zone has already been created. | 409 | 存在するゾーン名(ドメイン)を設定した |
| Unauthorized | name_server:%value%.dns-verify.ippas.nifty.com,txt:nifty-dns-verify=%value% | 401 | 認証が必要 |
| AccessDenied | Locked zone | 403 | 対象ゾーンを更新中のためアクセス不可 |
備考
リクエストのCallerReference情報を無視します。
