All Products
Search

This Product

    Domain Names:SaveBatchTaskForCreatingOrderActivate

    Document Center

    Domain Names:SaveBatchTaskForCreatingOrderActivate

    Last Updated:Jun 20, 2024

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

    Since March 1, 2022, you can register domain names only by using a registrant profile that has passed real-name verification. You can no longer register domain names by specifying registrant information.

    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. By default, Alibaba Cloud DNS servers are used. You can also use custom DNS servers.

    Note

    • The maximum number of domain names that you can register in a week is 100,000.

    • For request parameters of the SaveBatchTaskForCreatingOrderActivate operation in the format of OrderActivateParam.N.*, 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

    Yes

    example.com

    The domain name that you want to register.

    Note

    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 specify the domain name registrant by specifying the ID of a registrant profile in the OrderActivateParam.N.RegistrantProfileId parameter.

    OrderActivateParam.N.SubscriptionDuration

    Integer

    No

    1

    The subscription duration of the domain name. Unit: years. 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. You can specify the domain name registrant only by specifying the ID of the registrant profile. 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 takes effect only 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

    ZhanSan

    The Chinese name of the domain name registrant.

    Note

    This parameter applies only to the Domains service at the Alibaba Cloud China site (aliyun.com). This parameter takes effect only 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

    ZhanSan

    The Chinese name of the domain name contact.

    Note

    This parameter applies only to the Domains service at the Alibaba Cloud China site (aliyun.com). This parameter takes effect only 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 province where the domain name registrant is located, in Chinese.

    Note

    This parameter applies only to the Domains service at the Alibaba Cloud China site (aliyun.com). This parameter takes effect only 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 city where the domain name registrant is located, in Chinese.

    Note

    This parameter applies only to the Domains service at the Alibaba Cloud China site (aliyun.com). This parameter takes effect only 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

    ChaoYang

    The address of the domain name registrant, in Chinese.

    Note

    This parameter applies only to the Domains service at the Alibaba Cloud China site (aliyun.com). This parameter takes effect only 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

    ZhangSan

    The English name of the domain name registrant.

    Note

    This parameter takes effect only 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

    ZhangSan

    The English name of the domain name contact.

    Note

    This parameter takes effect only 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

    BeiJing

    The province where the domain name registrant is located, in English.

    Note

    This parameter takes effect only 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

    BeiJing

    The city where the domain name registrant is located, in English.

    Note

    This parameter takes effect only 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

    ChaoYang

    The address of the domain name registrant, in English.

    Note

    This parameter takes effect only 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 postal code of the area where the domain name registrant is located.

    Note

    This parameter takes effect only 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 or region where the domain name registrant is located, such as CN or US.

    Note

    This parameter takes effect only 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 international telephone code of the country or region where the domain name contact is located. For example, the international telephone code of China is 86.

    Note

    This parameter takes effect only 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 takes effect only 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 phone number of the domain name registrant.

    Note

    This parameter takes effect only 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

    username@example.com

    The email address of the domain name registrant.

    Note

    This parameter takes effect only 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 this parameter is set to true, you do not need to specify the OrderActivateParam.N.Dns1 or OrderActivateParam.N.Dns2 parameter. In this case, if the OrderActivateParam.N.Dns1 or OrderActivateParam.N.Dns2 parameter is specified, it does not take effect.

    • If this parameter is set to false, you must 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 takes effect only 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 valid. Otherwise, the registration may fail.

    OrderActivateParam.N.Dns2

    String

    No

    ns1.aliyun.com

    The custom DNS server 2.

    Note

    • This parameter takes effect only 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 valid. Otherwise, the registration may fail.

    Lang

    String

    No

    en

    The language in which the system returns the error message. 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 the domain name.

    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 that you want to use.

    UsePromotion

    Boolean

    No

    false

    Specifies whether to use a coupon.

    PromotionNo

    String

    No

    123124

    The ID of the coupon that you want to use.

    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.

    Examples

    Sample requests

    http(s)://domain.aliyuncs.com/?Action=SaveBatchTaskForCreatingOrderActivate
&DomainName=example.com
&SubscriptionDuration=1
&RegistrantProfileId=000000
&EnableDomainProxy=true
&PermitPremiumActivation=true
&AliyunDns=true
&Dns1=ns2.aliyun.com
&Dns2=ns1.aliyun.com
&ZhCity=BeiJing
&ZhRegistrantOrganization=ZhangSan
&Country=CN
&ZhRegistrantName=ZhangSan
&ZhProvince=BeiJing
&ZhAddress=ChaoYang
&City=BeiJing
&RegistrantOrganization=ZhangSan
&RegistrantName=ZhangSan
&Province=BeiJing
&Address=ChaoYang
&Email=username@example.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.