提交域名注册任务。
接口说明
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"
}
错误码
访问错误中心查看更多错误码。