提交域名注冊任務。
接口說明
2022 年 3 月 1 日起,僅能通過已實名認證的域名信息模板注冊域名,不再支持傳入持有者信息注冊域名。
注冊域名需同時填寫您想注冊的域名、域名持有者信息及 DNS。您需要通過已實名認證的域名信息模板編號來關聯域名的持有者信息,DNS 可以默認使用阿里云 DNS 或者填寫自定義 DNS。
任務執行結果請通過 QueryTaskDetailList 接口查詢。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
domain:CreateOrderActivate | create | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ZhRegistrantName | string | 否 | 域名聯系人(中文)。 說明
該參數僅適用于中國站。當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 測試 |
Lang | string | 否 | 接口返回錯誤信息語言。取值:
默認為 en。 | en |
DomainName | string | 是 | 想要注冊的域名。 說明
注冊域名時必須指定域名持有者信息,不指定域名持有者信息會導致域名注冊失敗。您可以通過 RegistrantProfileId 參數指定信息模板定義域名持有者信息。
| example.com |
SubscriptionDuration | integer | 否 | 購買周期,單位為年。默認為1 年,最長可購買10 年。 | 1 |
RegistrantProfileId | long | 否 | 域名信息模板編號(信息模板包含域名持有者名稱、域名聯系人、電話、郵箱等信息),僅能使用已實名認證的域名信息模板編號進行域名注冊。如果您已經創建了域名注冊信息模板,可通過調用 QueryRegistrantProfiles 接口查詢域名信息模板編號。 說明
傳入本參數后,無需再傳入 RegistrantType、ZhRegistrantOrganization、ZhRegistrantName、ZhProvince、ZhCity、ZhAddress、RegistrantOrganization、RegistrantName、Province、City、Address、PostalCode、Country、TelArea、Telephone、TelExt 和 Email 參數。
| 123 |
EnableDomainProxy | boolean | 否 | 是否開啟域名隱私保護服務。取值:
默認值為 true。 | false |
PermitPremiumActivation | boolean | 否 | 是否允許注冊白金詞,取值:
默認值為 false。 | false |
AliyunDns | boolean | 否 | 是否使用阿里云 DNS,取值為 true|false,默認為 true。 說明
| true |
Dns1 | string | 否 | 自定義 DNS1。 說明
| ns1.aliyun.com |
UserClientIp | string | 否 | 用戶 IP,可設置為127.0.0.1。 | 127.0.0.1 |
ZhCity | string | 否 | 城市(中文)。 說明
該參數僅適用于中國站。當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 北京市 |
ZhRegistrantOrganization | string | 否 | 域名持有者名稱(中文)。 說明
該參數僅適用于中國站。當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 測試 |
Country | string | 否 | 國家代碼,例如 CN。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| CN |
Dns2 | string | 否 | 自定義 DNS2。 說明
| ns2.aliyun.com |
ZhProvince | string | 否 | 省份(中文)。 說明
該參數僅適用于中國站。當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 北京 |
ZhAddress | string | 否 | 詳細地址(中文)。 說明
該參數僅適用于中國站。當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 朝陽區 |
City | string | 否 | 城市(英文)。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| bei jing shi |
RegistrantOrganization | string | 否 | 域名持有者名稱(英文)。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| ce shi |
RegistrantName | string | 否 | 域名聯系人(英文)。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| ce shi |
Province | string | 否 | 省份(英文)。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| bei jing |
Address | string | 否 | 詳細地址(英文)。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| chao yang qu |
string | 否 | 電子郵箱。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| username@example.com | |
PostalCode | string | 否 | 郵政編碼。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 1234567 |
TelArea | string | 否 | 電話國家代碼,例如中國為 86。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 86 |
Telephone | string | 否 | 電話號碼。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 12345678 |
TelExt | string | 否 | 分機號碼。 說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 1234 |
RegistrantType | string | 否 | 域名持有者類型。取值:
說明
當未傳入 RegistrantProfileId 參數時,本參數才可用且必須傳入,如果不傳入會導致域名注冊失敗。
| 1 |
TrademarkDomainActivation | boolean | 否 | 是否允許注冊商標詞,取值:
| false |
CouponNo | string | 否 | 代金券編號,默認為字符串。 | 123456 |
UseCoupon | boolean | 否 | 是否使用代金券。取值:
默認值為 false。 | false |
PromotionNo | string | 否 | 優惠券編號。 | 123123 |
UsePromotion | boolean | 否 | 是否使用優惠券,取值:
默認值為 false。 | false |
ResourceGroupId | string | 否 | 無。 | rg-XX |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "40F46D3D-F4F3-4CCB-AC30-2DD20E32E528",
"TaskNo": "3cb1adc3-20e8-44ae-9e76-e812fa6fc9d8"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。