Calls the OperateBatchDomain operation to submit a task for adding or deleting domain names or DNS records in batches.

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 OperateBatchDomain

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

DomainRecordInfo.N.Domain String Yes example.com

The domain name corresponding to DNS record N.

Note N is specified by users. N starts from 1. The maximum value of N is 1000. Extra data entries are ignored.
Type String Yes RR_ADD

The type of the batch operation. Valid values:

  • DOMAIN_ADD: adds domain names in batches.
  • DOMAIN_DEL: deletes domain names in batches.
  • RR_ADD: adds DNS records in batches.
  • RR_DEL: deletes DNS records in batches. (If RR or VALUE exists, DNS records corresponding to the specified RR or VALUE are deleted. If both of them exist, DNS records corresponding to the specified RR and VALUE are deleted. If no RR or VALUE is specified, the DNS records corresponding to the DomainName parameter are deleted.)
DomainRecordInfo.N.Line String No default

The resolution line of DNS record N. Default value: default.

For more information, see Resolution line enumeration.

DomainRecordInfo.N.Priority Integer No 5

The priority of MX-type DNS record N.

This parameter must be specified if the type of the DNS record is MX. Default value: 10.

DomainRecordInfo.N.Rr String No zhaohui

The host record corresponding to DNS record N.

Note If you set the Type parameter to RR_ADD, you must also specify this parameter.
DomainRecordInfo.N.Ttl Integer No 600

The TTL of DNS record N. Unit: seconds. Default value: 600.

DomainRecordInfo.N.Type String No MX

The type of DNS record N. For the DNS record types supported by Alibaba Cloud DNS, see Resolution record type formats.

Note If you set the Type parameter to RR_ADD, you must also specify this parameter.
DomainRecordInfo.N.Value String No fd87da3c4528844d45af39200155a905

The value of DNS record N.

Note If you set the Type parameter to RR_ADD, you must also specify this parameter.
Lang String No en

The language type.

Response parameters

Parameter Type Example Description
RequestId String 75446CC1-FC9A-4595-8D96-089D73D7A63D

The ID of the request.
TaskId Long 345345

The ID of the task.

Examples

Sample requests


http(s)://[Endpoint]/?Action=OperateBatchDomain
&DomainRecordInfo.1.Type=MX
&<Common request parameters>

Sample success responses

XML format 

<OperateBatchDomainResponse>
      <RequestId>75446CC1-FC9A-4595-8D96-089D73D7A63D</RequestId>
      <TaskId>345345</TaskId>
</OperateBatchDomainResponse>

JSON format 

{
	"RequestId":"75446CC1-FC9A-4595-8D96-089D73D7A63D",
	"TaskId":"345345"
}

Error codes

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