ドメイン名を登録できるかどうかを照会します。

ドメイン名の有効性を判断する方法の詳細については、「ドメイン名の有効性」をご参照ください。

説明 CheckDomain操作を呼び出す頻度は限られています。 制限は、1人のユーザーに対して1秒あたり10クエリ (QPS) 、この操作に対して合計100 QPSです。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorerは、さまざまなSDKの操作のサンプルコードを自動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 CheckDomain

実行したい操作。 値をCheckDomainに設定します。

DomainName String 必須 テスト **.xin

問い合わせをしたいドメイン名。
FeeCommand String 任意 create

操作コマンド。 設定可能な値は以下のとおりです。

  • create: ドメイン名を購入します。
  • renew: ドメイン名を更新します。
  • transfer: ドメイン名をAlibaba Cloudに転送します。
  • restore: ドメインを利用します。
FeeCurrency String 任意 米ドル

通貨の種類を表します。設定可能な値は以下のとおりです。

  • CNY: 中国人民元
  • USD: アメリカドル
FeePeriod Integer 任意 1

ドメイン名のサブスクリプション期間。単位: 年。 有効な値: 1 から10。

Lang String 任意 en

返されたエラーメッセージの言語。 設定可能な値は以下のとおりです。

  • zh: 中国語
  • en: English

デフォルト値: en。

レスポンスパラメーター

パラメーター データ型 例 説明
利用可能 String 1

ドメイン名を登録できるかどうかを示します。 設定可能な値は以下のとおりです。

  • 1: ドメイン名を登録することができます。
  • 3: ドメイン名は事前登録できます。
  • 4: ドメイン名の事前登録は削除することができます。
  • 0: ドメイン名は登録できません。
  • -1: ドメイン名が異常です。
  • -2: ドメイン名の登録が中断されました。
  • -3: ドメイン名がブラックリストに追加されました。
DomainName String テスト **.xin

照会されるドメイン名。
DynamicCheck Boolean true

ドメイン名の価格がドメイン名のレジストリによって決定されるかどうかを示す。設定可能な値は以下のとおりです。

  • true: ドメイン名の価格は、ドメイン名のレジストリによって決定されます。
  • false: ドメイン名の価格は、ドメイン名レジストリによって決定されません。
プレミアム String true

ドメイン名がプレミアムドメイン名かどうかを示します。 設定可能な値は以下のとおりです。

  • true: ドメイン名はプレミアムドメイン名です。
  • false: ドメイン名はプレミアムドメイン名ではありません。
価格 Long 1286

プレミアムドメイン名の登録価格。
理由 String 使用中

登録できないドメイン名に対してドメイン名レジストリが返した理由。

説明 理由は、ドメイン名レジストリによって異なります。
RequestId String BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1

リクエストの ID です。

例

リクエストの例

http(s)://domain.aliyuncs.com/? アクション=CheckDomain
&DomainName=テスト **.xin
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<CheckDomain>
      <RequestId>BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1</RequestId>
      <DomainName> テスト **.xin</DomainName>
      <Avail>1</Avail>
      <Premium>false</Premium>
      <理由></理由>
      <価格> 1286</価格>
</CheckDomain>

JSON 形式 

{
    "RequestId": "BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1" 、
    "DomainName": "test**.xin "、
    "Avail": 1、
    "プレミアム": false、
    "理由": "" 、
    "価格": 1286
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。