本文へジャンプします。

ニフティクラウド APIリファレンス

クラウド トップ>API>DNS>CreateHostedZone

DNS:CreateHostedZone

処理概要

ゾーンの作成を行います。

リクエストボディにてゾーンの作成に必要な情報を入力し、それにもとづいてゾーンが作成されます。

作成したゾーンのドメインをユーザーが所持している場合、認証なしでゾーンが作成されます。

作成したゾーンのドメインをユーザーが所持していない場合、ゾーン作成前に認証が行われるため、Unauthorizedエラーが発生します。
Unauthorized発生の場合、エラーメッセージにある認証情報をレジストラまたはDNSに設定し、再度本APIを実行してください。

認証に失敗した場合は、ゾーンは作成されずエラーが返されます。

リクエストURL

https://dns.api.cloud.nifty.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情報を無視します。

推奨画面サイズ 1024×768 以上