You can call this operation to modify a Domain Name System (DNS) record.

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 UpdateZoneRecord

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

RecordId Long Yes 5809

The ID of the DNS record.

Rr String Yes www

The prefix of the domain or subdomain name.

For example, you must specify the at sign (@) for this parameter if you want to resolve @.example.com.

Type String Yes A

The type of the DNS record.

Value String Yes 1.1.1.1

The value of the DNS record.

Lang String No en

The language of the specific content returned in the response.

Priority Integer No 60

The priority of the MX record. Valid values: 1 to 99.

This parameter is required if the type of the DNS record is MX.

Ttl Integer No 60

The amount of time that the DNS resolver caches the value of the DNS record.

UserClientIp String No 2.2.2.2

The IP address of the client.

Response parameters

Parameter Type Example Description
RecordId Long 5809

The ID of the DNS record.

RequestId String 250E2C38-D0AD-4518-851D-1C1055805F82

The ID of the request.

Examples

Sample requests

  1. http://pvtz.aliyuncs.com/?Action=UpdateZoneRecord&Rr=www&Type=A&Ttl=60&Value=1.1.1.1&RecordId=5809&<Common request parameters>

Sample success responses

XML format

  1. <UpdateZoneRecordResponse> <RecordId>5809</RecordId> <RequestId>43909504-7C3E-4660-AF75-59EE0C480681</RequestId></UpdateZoneRecordResponse>

JSON format

  1. {“RecordId”:5809,“RequestId”:”250E2C38-D0AD-4518-851D-1C1055805F82”}

Error codes

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