SaveBatchTaskForCreatingOrderActivate - 提交批量注册域名任务

更新时间:
复制 MD 格式

提交批量注册域名的任务。

接口说明

2022 年 3 月 1 日起,仅能通过已实名认证的域名信息模板注册域名,不再支持传入持有者信息注册域名。

注册域名需同时填写您想注册的域名、域名持有者信息及 DNS。您需要通过已实名认证的域名信息模板编号来关联域名的持有者信息,DNS 可以默认使用阿里云 DNS 或者填写自定义 DNS。

说明
  • 每周注册的域名总数不能超过 10 万。

  • 注册付费只能通过账户现金余额,不支持额度。

  • 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

否

接口返回错误信息语言。取值:

  • zh:中文。

  • en:英文。

默认为 en。

en

CouponNo

string

否

代金券编号。

123456

UseCoupon

boolean

否

是否使用代金券。

false

PromotionNo

string

否

优惠券编号。

123124

UsePromotion

boolean

否

是否使用优惠券。

false

OrderActivateParam

array<object>

是

任务详情列表。

object

否

Address

string

否

通讯地址(英文)。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

chao yan qu *** dasha *** hao

AliyunDns

boolean

否

是否使用阿里云 DNS,取值为 true|false,默认为 true。

说明
  • 取值为 true 时,您无需再传入OrderActivateParam.N.Dns1和OrderActivateParam.N.Dns2参数,否则传入的OrderActivateParam.N.Dns1和OrderActivateParam.N.Dns2参数不会生效。

  • 取值为 false 时,您还需要传入OrderActivateParam.N.Dns1和OrderActivateParam.N.Dns2参数。

true

City

string

否

城市(英文)。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

bei jing shi

Country

string

否

国家代码。例如,CN 代表中国,US 代表美国。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

CN

Dns1

string

否

自定义 DNS1。

说明
  • 当OrderActivateParam.N.AliyunDns取值为 false 时,本参数才可用且必须传入。

  • 请务必确保自定义 DNS 的正确性,否则可能导致注册失败。

ns2.aliyun.com

Dns2

string

否

自定义 DNS2。

说明
  • 当OrderActivateParam.N.AliyunDns取值为 false 时,本参数才可用且必须传入。

  • 请务必确保自定义 DNS 的正确性,否则可能导致注册失败。

ns1.aliyun.com

DomainName

string

是

想要注册的域名。

说明

注册域名时必须指定域名持有者信息,不指定域名持有者信息会导致域名注册失败。您可以通过 OrderActivateParam.N.RegistrantProfileId 参数指定信息模板定义域名持有者信息。

example.com

Email

string

否

电子邮箱。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

username@example.com

EnableDomainProxy

boolean

否

是否开启域名隐私保护服务,默认为 true。

true

ExpectedPunycode

string

否

Punycode 编码格式的域名,可以为空

xn--fiqs8s.com

PermitPremiumActivation

boolean

否

是否允许注册白金词,默认为 false。

true

PostalCode

string

否

邮政编码。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

102629

Province

string

否

省份(英文)。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

bei jing

RegistrantName

string

否

域名联系人(英文)。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

zhang san

RegistrantOrganization

string

否

域名持有者名称(英文)。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

zhang san

RegistrantProfileId

integer

否

域名信息模板编号(信息模板包含域名持有者名称、域名联系人、电话、邮箱等信息),仅能使用已实名认证的域名信息模板编号进行域名注册。如果您已经创建了域名注册信息模板,可通过调用 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

RegistrantType

string

否

域名持有者类型。取值:

  • 1:个人。

  • 2:企业、组织等。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

1

ResourceGroupId

string

否

资源组 ID。

说明

若没有传入资源组 ID 或传入的资源组 ID 不存在,则绑定默认资源组 ID。

rg-XX

SubscriptionDuration

integer

否

购买周期,单位为年。默认为一年。

1

TelArea

string

否

电话国家代码,例如,中国的电话国家代码为 86。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

86

TelExt

string

否

分机号码。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

1234

Telephone

string

否

电话号码。

说明

当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

1820000****

TrademarkDomainActivation

boolean

否

是否允许注册商标词。

false

ZhAddress

string

否

通讯地址(中文)。

说明

该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

朝阳区***大厦***号

ZhCity

string

否

城市(中文)。

说明

该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

北京市

ZhProvince

string

否

省份(中文)。

说明

该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

北京

ZhRegistrantName

string

否

域名联系人(中文)。

说明

该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

张三

ZhRegistrantOrganization

string

否

域名持有者名称(中文)。

说明

该参数仅适用于中国站。当未传入OrderActivateParam.N.RegistrantProfileId参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。

张三

返回参数

名称

类型

描述

示例值

object

RequestId

string

唯一请求识别码。

F51977F9-2B40-462B-BCCD-CF5BB1E9DB56

TaskNo

string

任务编号。

d3babb0a-c939-4c25-8c65-c47b65f5492a

示例

正常返回示例

JSON格式

{
  "RequestId": "F51977F9-2B40-462B-BCCD-CF5BB1E9DB56",
  "TaskNo": "d3babb0a-c939-4c25-8c65-c47b65f5492a"
}

异常返回示例

JSON格式

{    
  "TaskNo": "d3babb0a-c939-4c25-8c65-c47b65f5492a",
  "RequestId": "F51977F9-2B40-462B-BCCD-CF5BB1E9DB56"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。