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情報を無視します。