调用SaveSingleTaskForCreatingOrderActivate提交单个域名注册任务-域名-阿里云-域名(Domain)-阿里云帮助中心

提交域名注册任务。

接口说明

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	否	接口返回错误信息语言。取值： zh：中文。 en：英文。默认为 en。	en
DomainName	string	是	想要注册的域名。说明注册域名时必须指定域名持有者信息，不指定域名持有者信息会导致域名注册失败。您可以通过 RegistrantProfileId 参数指定信息模板定义域名持有者信息。	example.com
SubscriptionDuration	integer	否	购买周期，单位为年。默认为1 年，最长可购买10 年。	1
RegistrantProfileId	integer	否	域名信息模板编号（信息模板包含域名持有者名称、域名联系人、电话、邮箱等信息），仅能使用已实名认证的域名信息模板编号进行域名注册。如果您已经创建了域名注册信息模板，可通过调用 QueryRegistrantProfiles 接口查询域名信息模板编号。说明传入本参数后，无需再传入 RegistrantType、ZhRegistrantOrganization、ZhRegistrantName、ZhProvince、ZhCity、ZhAddress、RegistrantOrganization、RegistrantName、Province、City、Address、PostalCode、Country、TelArea、Telephone、TelExt 和 Email 参数。	123
EnableDomainProxy	boolean	否	是否开启域名隐私保护服务。取值： true：开启。 false：不开启。默认值为 true。	false
PermitPremiumActivation	boolean	否	是否允许注册白金词，取值： false：不允许。 true：允许。默认值为 false。	false
AliyunDns	boolean	否	是否使用阿里云 DNS，取值为 true\|false，默认为 true。说明取值为 true 时，您无需再传入 Dns1 和 Dns2 参数，否则传入的 Dns1 和 Dns2 参数不会生效。取值为 false 时，您还需要传入 Dns1 和 Dns2 参数。	true
Dns1	string	否	自定义 DNS1。说明当 AliyunDns 取值为 false 时，本参数才可用且必须传入。请务必确保自定义 DNS 的正确性，否则可能导致注册失败。	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。说明当 AliyunDns 取值为 false 时，本参数才可用且必须传入。请务必确保自定义 DNS 的正确性，否则可能导致注册失败。	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
Email	string	否	电子邮箱。说明当未传入 RegistrantProfileId 参数时，本参数才可用且必须传入，如果不传入会导致域名注册失败。	username@example.com
PostalCode	string	否	邮政编码。说明当未传入 RegistrantProfileId 参数时，本参数才可用且必须传入，如果不传入会导致域名注册失败。	1234567
TelArea	string	否	电话国家代码，例如中国为 86。说明当未传入 RegistrantProfileId 参数时，本参数才可用且必须传入，如果不传入会导致域名注册失败。	86
Telephone	string	否	电话号码。说明当未传入 RegistrantProfileId 参数时，本参数才可用且必须传入，如果不传入会导致域名注册失败。	12345678
TelExt	string	否	分机号码。说明当未传入 RegistrantProfileId 参数时，本参数才可用且必须传入，如果不传入会导致域名注册失败。	1234
RegistrantType	string	否	域名持有者类型。取值： 1：个人。 2：企业、组织等。说明当未传入 RegistrantProfileId 参数时，本参数才可用且必须传入，如果不传入会导致域名注册失败。	1
TrademarkDomainActivation	boolean	否	是否允许注册商标词，取值： false：不允许。 true：允许。	false
CouponNo	string	否	代金券编号，默认为字符串。	123456
UseCoupon	boolean	否	是否使用代金券。取值： true：使用 false：不使用默认值为 false。	false
PromotionNo	string	否	优惠券编号。	123123
UsePromotion	boolean	否	是否使用优惠券，取值： false：不允许。 true：允许。默认值为 false。	false
ResourceGroupId	string	否	无。	rg-XX
ExpectedPunycode	string	否	Punycode 编码格式的域名，可以为空	xn--fiqs8s.com

返回参数

名称	类型	描述	示例值
	object	返回对象
RequestId	string	唯一请求识别码。	40F46D3D-F4F3-4CCB-AC30-2DD20E32E528
TaskNo	string	任务编号。	3cb1adc3-20e8-44ae-9e76-e812fa6fc9d8

示例

正常返回示例

JSON格式

{
  "RequestId": "40F46D3D-F4F3-4CCB-AC30-2DD20E32E528",
  "TaskNo": "3cb1adc3-20e8-44ae-9e76-e812fa6fc9d8"
}

异常返回示例

JSON格式

{    
  "TaskNo": "3cb1adc3-20e8-44ae-9e76-e812fa6fc9d8",
  "RequestId": "40F46D3D-F4F3-4CCB-AC30-2DD20E32E528"
}

错误码

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

变更历史

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