UpdateDomainRecord

Last Updated: Dec 08, 2017

Description

Resolution records are modified based on input parameters.

Request parameters

Name Type Required? Description
Action String Yes UpdateDomainRecord.
RecordId String Yes Resolution record ID.
RR String Yes Host record. For example, to resolve @.example.com, use @.
Type String Yes Resolution record type. For more information, see Resolution record type formats.
Value String Yes Record value.
TTL Long No Time to live. Default value: 600 seconds (10 minutes). For more information, see TTL definition description.
Priority Long No MX record priority. Value range: [1,10]. This parameter is required when the record type is MX.
Line String No Resolution line. Default value: default. For more information, see Resolution line enumeration.

Return parameters

For more information about public return parameters, see Public Return Parameters.

Name Type Description
RequestId String The unique request identifier
RecordId String Resolution record ID

Error codes

For errors common to all interfaces, see Error code table.

Error Code Description HTTP Status Code Meaning
DomainRecordNotBelongToUser The domain record does not belong to this user. 400 The resolution record does not exist under this account.
DomainRecordDuplicate The domain record is duplicated. 400 The resolution record does not exist.
DomainRecordConflict The domain record is conflict with other records. 400 Resolution records conflict.
DomainForbidden The action cannot be completed because the domain is forbidden. 400 The resolution operation is forbidden on this domain name.
DomainRecordLocked The domain record is locked. 400 The resolution record is locked.
UnKnownError An unknown error occurs. 400 Unknown error.
QuotaExceeded.Record You cannot add this domain record because the {“Type RR Line”} record is out of MAX count (90). 400 The maximum of 90 resolution records per type is exceeded.
QuotaExceeded.ARecord You cannot add this domain record because the {“Type RR Line”} record is out of MAX count. 400 The maximum number of A(AAAA) record type is exceeded.
RecordForbidden.BlackHole The action cannot be completed because some reords are in black holes. 400 Some resolution records are in black holes.
URLForwardError.PanRecord The wildcard-record is not supported in URL forward record. 400 URL forwarding does not support wildcard resolution records.
URLForwardError.NotDefaultLine The URL forward record only supports default line. 400 URL forwarding is not default line.
URLForwardError. ChineseChar The Chinese character is not supported in URL forward record. 400 The target domain name for URL forwarding is a Chinese domain name.
URLForwardError.NotVerifyDomain The domain name must be verified in Hichina in URL forward record. 400 The URL forwarding domain name is not filed.
QuotaExceeded.URLRecord The URL record is out of MAX count. 400 The URL forwarding quantity exceeds the limit.
QuotaExceeded.SubDomain The subdomain level is out of MAX count. 400 The subdomain name level exceeds the limit.
QuotaExceeded.TTL TTL parameter is out of range. 400 The TTL time exceeds the limit.
UnsupportedLine This line is not be supported in the current DNS version. 400 The current version does not support this resolution line.
RecordForbidden.DNSChange The action cannot be completed because DNS is changing. 400 This operation is forbidden due to DNS migration.

Example

Request example

  1. http://dns.aliyuncs.com/?Action=UpdateDomainRecord
  2. &RecordId=9999985
  3. &RR=www
  4. &Type=A
  5. &Value=202.106.0.20
  6. &TTL=600
  7. &Line=default
  8. &<Public Request Parameters>

Return example

  • XML Format
  1. <UpdateDomainRecordResponse>
  2. <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
  3. <RecordId>9999985</RecordId>
  4. </UpdateDomainRecordResponse>
  • JSON Example
  1. {
  2. "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  3. "RecordId": "9999985"
  4. }
Thank you! We've received your feedback.