提交批量注册域名的任务。
接口说明
2022 年 3 月 1 日起,仅能通过已实名认证的域名信息模板注册域名,不再支持传入持有者信息注册域名。
注册域名需同时填写您想注册的域名、域名持有者信息及 DNS。您需要通过已实名认证的域名信息模板编号来关联域名的持有者信息,DNS 可以默认使用阿里云 DNS 或者填写自定义 DNS。
- SaveBatchTaskForCreatingOrderActivate 接口下请求参数的格式为 OrderActivateParam.N.*,其中 N 代表传入的第几个域名。
任务执行结果请通过 QueryTaskDetailList 接口查询。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
domain:CreateOrderActivate | create | *全部资源 * |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
UserClientIp | string | 否 | 用户 IP。 | 127.0.0.1 |
Lang | string | 否 | 接口返回错误信息语言。取值:
默认为 en。 | en |
CouponNo | string | 否 | 代金券编号。 | 123456 |
UseCoupon | boolean | 否 | 是否使用代金券。 | false |
PromotionNo | string | 否 | 优惠券编号。 | 123124 |
UsePromotion | boolean | 否 | 是否使用优惠券。 | false |
OrderActivateParam | array<object> | 是 | 任务详情列表。 | |
object | 是 | |||
TelExt | string | 否 | 分机号码。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 1234 |
AliyunDns | boolean | 否 | 是否使用阿里云 DNS,取值为 true|false,默认为 true。 说明
| true |
PermitPremiumActivation | boolean | 否 | 是否允许注册白金词,默认为 false。 | true |
ZhProvince | string | 否 | 省份(中文)。 说明
该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 北京 |
Telephone | string | 否 | 电话号码。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 1820000**** |
RegistrantOrganization | string | 否 | 域名持有者名称(英文)。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| zhang san |
City | string | 否 | 城市(英文)。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| bei jing shi |
DomainName | string | 是 | 想要注册的域名。 说明
注册域名时必须指定域名持有者信息,不指定域名持有者信息会导致域名注册失败。您可以通过 OrderActivateParam.N.RegistrantProfileId 参数指定信息模板定义域名持有者信息。
| example.com |
ZhCity | string | 否 | 城市(中文)。 说明
该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 北京市 |
Dns1 | string | 否 | 自定义 DNS1。 说明
| ns2.aliyun.com |
TelArea | string | 否 | 电话国家代码,例如,中国的电话国家代码为 86。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 86 |
Address | string | 否 | 通讯地址(英文)。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| chao yan qu *** dasha *** hao |
EnableDomainProxy | boolean | 否 | 是否开启域名隐私保护服务,默认为 true。 | true |
PostalCode | string | 否 | 邮政编码。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 102629 |
RegistrantProfileId | long | 否 | 域名信息模板编号(信息模板包含域名持有者名称、域名联系人、电话、邮箱等信息),仅能使用已实名认证的域名信息模板编号进行域名注册。如果您已经创建了域名注册信息模板,可通过调用 QueryRegistrantProfiles 接口查询域名信息模板编号。 说明
传入本参数后,无需再传入OrderActivateParam.N.RegistrantType、OrderActivateParam.N.ZhRegistrantOrganization、OrderActivateParam.N.ZhRegistrantName、OrderActivateParam.N.ZhProvince、OrderActivateParam.N.ZhCity、OrderActivateParam.N.ZhAddress、OrderActivateParam.N.RegistrantOrganization、OrderActivateParam.N.RegistrantName、OrderActivateParam.N.Province、OrderActivateParam.N.City、OrderActivateParam.N.Address、OrderActivateParam.N.PostalCode、OrderActivateParam.N.Country、OrderActivateParam.N.TelArea、OrderActivateParam.N.Telephone、OrderActivateParam.N.TelExt和OrderActivateParam.N.Email参数。
| 000000 |
ZhRegistrantOrganization | string | 否 | 域名持有者名称(中文)。 说明
该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 张三 |
TrademarkDomainActivation | boolean | 否 | 是否允许注册商标词。 | false |
Dns2 | string | 否 | 自定义 DNS2。 说明
| ns1.aliyun.com |
ZhRegistrantName | string | 否 | 域名联系人(中文)。 说明
该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 张三 |
string | 否 | 电子邮箱。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| username@example.com | |
RegistrantType | string | 否 | 域名持有者类型。取值:
说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 1 |
Country | string | 否 | 国家代码。例如,CN 代表中国,US 代表美国。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| CN |
RegistrantName | string | 否 | 域名联系人(英文)。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| zhang san |
SubscriptionDuration | integer | 否 | 购买周期,单位为年。默认为一年。 | 1 |
ZhAddress | string | 否 | 通讯地址(中文)。 说明
该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| 朝阳区***大厦***号 |
Province | string | 否 | 省份(英文)。 说明
当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
| bei jing |
ResourceGroupId | string | 否 | 资源组 ID。 说明
若没有传入资源组 ID 或传入的资源组 ID 不存在,则绑定默认资源组 ID。
| rg-XX |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "F51977F9-2B40-462B-BCCD-CF5BB1E9DB56",
"TaskNo": "d3babb0a-c939-4c25-8c65-c47b65f5492a"
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-05-23 | API 内部配置变更,不影响调用 | 查看变更详情 |