Submits a task for registering multiple domain names at a time.

Description

To register a domain name, you must specify the domain name, domain name registrant, and Domain Name System (DNS) server. You can specify the domain name registrant by specifying the ID of a registrant profile or manually entering the information about the registrant. By default, Alibaba Cloud DNS servers are used. You can also use custom DNS servers.

Note
  • The total number of domain names that can be registered in a week cannot exceed 100,000.
  • For SaveBatchTaskForCreatingOrderActivate, the format of the request parameters is OrderActivateParam.N.*, where N indicates the sequence number of the domain name that you want to register.

You can call the QueryTaskDetailList operation to query the task execution result.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes SaveBatchTaskForCreatingOrderActivate

The operation that you want to perform. Set the value to SaveBatchTaskForCreatingOrderActivate.

OrderActivateParam.N.DomainName String No test.com

The domain name that you want to register.

You must specify the domain name registrant when you register a domain name. The domain name fails to be registered if no domain name registrant is specified. You can use the OrderActivateParam.N.RegistrantProfileId parameter to specify a registrant profile or use parameters such as OrderActivateParam.N.RegistrantType and OrderActivateParam.N.ZhRegistrantOrganization to define a domain name registrant.

OrderActivateParam.N.SubscriptionDuration Integer No 1

The validity period of the domain name. Unit: year. Default value: 1.

OrderActivateParam.N.RegistrantProfileId Long No 000000

The ID of the registrant profile. The profile includes information such as the name of the domain name registrant, the contact for the domain name, phone number, and email address. We recommend that you use a registrant profile to specify the domain name registrant when you register a domain name. If you have created a registrant profile, you can call the QueryRegistrantProfiles operation to query the ID of the registrant profile.

Note If this parameter is specified, you do not need to specify the following parameters: 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, and OrderActivateParam.N.Email.
OrderActivateParam.N.RegistrantType String No 1

The type of the domain name registrant. Valid values:

  • 1: individual
  • 2: enterprise or organization
Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.ZhRegistrantOrganization String No Zhang San

The Chinese name of the domain name registrant.

Note This parameter is only applicable to the Domains service on the Alibaba Cloud China website (aliyun.com). This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.ZhRegistrantName String No Zhang San

The Chinese name of the contact for the domain name.

Note This parameter is only applicable to the Domains service on the Alibaba Cloud China website (aliyun.com). This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.ZhProvince String No Beijing

The Chinese name of the province where the domain name registrant is located.

Note This parameter is only applicable to the Domains service on the Alibaba Cloud China website (aliyun.com). This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.ZhCity String No Beijing

The Chinese name of the city where the domain name registrant is located.

Note This parameter is only applicable to the Domains service on the Alibaba Cloud China website (aliyun.com). This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.ZhAddress String No No. *, Building *, Chaoyang District

The Chinese name of the address of the domain name registrant.

Note This parameter is only applicable to the Domains service on the Alibaba Cloud China website (aliyun.com). This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.RegistrantOrganization String No zhang san

The name of the domain name registrant.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.RegistrantName String No zhang san

The name of the contact for the domain name.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.Province String No bei jing

The province where the domain name registrant is located.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.City String No bei jing shi

The city where the domain name registrant is located.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.Address String No chao yan qu *** dasha *** hao

The address of the domain name registrant.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.PostalCode String No 102629

The zip code of the region where the domain name registrant is located.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.Country String No CN

The code of the country/region where the domain name registrant is located, such as CN or US.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.TelArea String No 86

The calling code of the country/region where the domain name registrant is located. For example, the calling code for China is 86.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.Telephone String No 1820000****

The phone number of the domain name registrant.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.TelExt String No 1234

The extension number of the registrant's phone number.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.Email String No test@aliyun.com

The email address of the domain name registrant.

Note This parameter only takes effect when the OrderActivateParam.N.RegistrantProfileId parameter is not specified. In this case, you must specify this parameter. The domain name fails to be registered if this parameter is not specified.
OrderActivateParam.N.AliyunDns Boolean No true

Specifies whether to use Alibaba Cloud DNS servers. Valid values: true and false. Default value: true.

Note
  • If the value is set to true, you do not need to specify the OrderActivateParam.N.Dns1 and OrderActivateParam.N.Dns2 parameters. If the OrderActivateParam.N.Dns1 and OrderActivateParam.N.Dns2 parameters are specified, they do not take effect.
  • If the value is set to false, you need to specify the OrderActivateParam.N.Dns1 and OrderActivateParam.N.Dns2 parameters.
OrderActivateParam.N.Dns1 String No ns2.aliyun.com

The custom DNS server 1.

Note
  • This parameter only takes effect when the OrderActivateParam.N.AliyunDns parameter is set to false. In this case, you must specify this parameter.
  • Make sure that the custom DNS server is correct. Otherwise, the registration may fail.
OrderActivateParam.N.Dns2 String No ns1.aliyun.com

The custom DNS server 2.

Note
  • This parameter only takes effect when the OrderActivateParam.N.AliyunDns parameter is set to false. In this case, you must specify this parameter.
  • Make sure that the custom DNS server is correct. Otherwise, the registration may fail.
Lang String No en

The language of the error message to return. Valid values:

  • zh: Chinese
  • en: English

Default value: en.

UserClientIp String No 127.0.0.1

The IP address of the client that you use to register domain names.

OrderActivateParam.N.EnableDomainProxy Boolean No true

Specifies whether to enable the domain name proxy service for the domain name. Default value: true.

OrderActivateParam.N.PermitPremiumActivation Boolean No true

Specifies whether to allow registration of domain names that contain premium words. Default value: false.

OrderActivateParam.N.TrademarkDomainActivation Boolean No false

Specifies whether to allow registration of domain names that contain trademark words.

UseCoupon Boolean No false

Specifies whether to use a voucher.

CouponNo String No 123456

The ID of the voucher to be used.

UsePromotion Boolean No false

Specifies whether to use a coupon.

PromotionNo String No 123124

The ID of the coupon to be used.

Response parameters

Parameter Type Example Description
RequestId String F51977F9-2B40-462B-BCCD-CF5BB1E9DB56

The ID of the request.

TaskNo String d3babb0a-c939-4c25-8c65-c47b65f5492a

The ID of the task that was submitted.

Examples

Sample requests

http(s)://domain.aliyuncs.com/?Action=SaveBatchTaskForCreatingOrderActivate
&DomainName=test.com
&SubscriptionDuration=1
&RegistrantProfileId=000000
&EnableDomainProxy=true
&PermitPremiumActivation=true
&AliyunDns=true
&Dns1=ns2.aliyun.com
&Dns2=ns1.aliyun.com
&ZhCity=Beijing
&ZhRegistrantOrganization=Zhang San
&Country=CN
&ZhRegistrantName=Zhang San
&ZhProvince=Beijing
&ZhAddress=No. *, Building *, Chaoyang District
&City=bei jing shi
&RegistrantOrganization=zhang san
&RegistrantName=zhang san
&Province=bei jing
&Address=chao yan qu *** dasha *** hao
&Email=test@aliyun.com
&PostalCode=102629
&TelArea=86
&Telephone=1820000****
&TelExt=1234
&RegistrantType=1
&TrademarkDomainActivation=false
&<Common request parameters>

Sample success responses

XML format

<SaveBatchTaskForCreatingOrderActivateResponse>
      <TaskNo>d3babb0a-c939-4c25-8c65-c47b65f5492a</TaskNo>
      <RequestId>F51977F9-2B40-462B-BCCD-CF5BB1E9DB56</RequestId>
</SaveBatchTaskForCreatingOrderActivateResponse>

JSON format

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

Error codes

For a list of error codes, visit the API Error Center.