tencent cloud

Private DNS

Release Notes
Product Introduction
Overview
Strengths
Use Limits
Scenarios
Purchase Guide
Billing Overview
Value-Added Service Packages
Non-Standard TLDs
Getting Started
Activating Private DNS
Creating Private Domain
Deleting Private Domain
Modifying Associated VPC
Operation Guide
Setting DNS Record
Modifying DNS Record
Deleting DNS Record
Importing DNS Records
Exporting DNS Records
Associating the VPCs of Another Account
Bulk Operation
Reverse DNS and PTR Record
Subdomain Recursive DNS Description
DNS Statistics Description
Round-Robin DNS Description
Recursive Resolution Description
Cloud Access Management
Cloud Access Management Overview
Authorizable Resource Types
Sample Access Management Policy
Use Cases
Configuring the NSCD Service for Cache Acceleration to Improve DNS Availability
API Documentation
History
Introduction
API Category
Making API Requests
Private DNS APIs
Data Types
Error Codes
FAQs
Private DNS
Will Private DNS override public domain names?
PDNS Policy
Privacy Policy
Data Processing And Security Agreement
Related Agreement
Private DNS Service Level Agreement
Glossary

Error Codes

PDF
Focus Mode
Font Size
Last updated: 2025-10-30 21:53:19

Feature Description

If there is an Error field in the response, it means that the API call failed. For example:

 {
    "Response": {
        "Error": {
            "Code": "AuthFailure.SignatureFailure",
            "Message": "The provided credentials could not be validated. Please check your signature is correct."
        },
        "RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"
    }
}

Code in Error indicates the error code, and Message indicates the specific information of the error.

Error Code List

Common Error Codes

Error Code Description
ActionOffline This API has been deprecated.
AuthFailure.InvalidAuthorization Authorization in the request header is invalid.
AuthFailure.InvalidSecretId Invalid key (not a TencentCloud API key type).
AuthFailure.MFAFailure MFA failed.
AuthFailure.SecretIdNotFound Key does not exist. Check if the key has been deleted or disabled in the console, and if not, check if the key is correctly entered. Note that whitespaces should not exist before or after the key.
AuthFailure.SignatureExpire Signature expired. Timestamp and server time cannot differ by more than five minutes. Please ensure your current local time matches the standard time.
AuthFailure.SignatureFailure Invalid signature. Signature calculation error. Please ensure you’ve followed the signature calculation process described in the Signature API documentation.
AuthFailure.TokenFailure Token error.
AuthFailure.UnauthorizedOperation The request is not authorized. For more information, see the CAM documentation.
DryRunOperation DryRun Operation. It means that the request would have succeeded, but the DryRun parameter was used.
FailedOperation Operation failed.
InternalError Internal error.
InvalidAction The API does not exist.
InvalidParameter Incorrect parameter.
InvalidParameterValue Invalid parameter value.
InvalidRequest The multipart format of the request body is incorrect.
IpInBlacklist Your IP is in uin IP blacklist.
IpNotInWhitelist Your IP is not in uin IP whitelist.
LimitExceeded Quota limit exceeded.
MissingParameter A parameter is missing.
NoSuchProduct The product does not exist.
NoSuchVersion The API version does not exist.
RequestLimitExceeded The number of requests exceeds the frequency limit.
RequestLimitExceeded.GlobalRegionUinLimitExceeded Uin exceeds the frequency limit.
RequestLimitExceeded.IPLimitExceeded The number of ip requests exceeds the frequency limit.
RequestLimitExceeded.UinLimitExceeded The number of uin requests exceeds the frequency limit.
RequestSizeLimitExceeded The request size exceeds the upper limit.
ResourceInUse Resource is in use.
ResourceInsufficient Insufficient resource.
ResourceNotFound The resource does not exist.
ResourceUnavailable Resource is unavailable.
ResponseSizeLimitExceeded The response size exceeds the upper limit.
ServiceUnavailable Service is unavailable now.
UnauthorizedOperation Unauthorized operation.
UnknownParameter Unknown parameter.
UnsupportedOperation Unsupported operation.
UnsupportedProtocol HTTP(S) request protocol error; only GET and POST requests are supported.
UnsupportedRegion API does not support the requested region.

Service Error Codes

Error Code Description
AuthFailure Error with CAM signature/authentication.
FailedOperation.BindZoneVpcFailed Failed to associate the private domain with the VPC.
FailedOperation.CreateRecordFailed Failed to create the record.
FailedOperation.CreateVpcEndPointError An exception occurs when you create an endpoint.
FailedOperation.CreateVpcEndPointFailed Failed to create an endpoint.
FailedOperation.CreateZoneFailed Failed to create the private domain.
FailedOperation.DataError Data exception.
FailedOperation.DeleteLastBindVpcRecordFailed The private domain is currently associated with a VPC. Please disassociate the VPC first before clearing its records.
FailedOperation.DeleteRecordFailed Record deletion failed.
FailedOperation.DeleteVpcEndPointFailed Failed to delete the endpoint.
FailedOperation.EndPointServiceCreateFailed Failed to create an endpoint service.
FailedOperation.EndPointServiceDeleteFailed Failed to delete the endpoint service.
FailedOperation.EndPointServiceWhiteListFailed Failed to obtain the endpoint service allowlist.
FailedOperation.GetTmpCredFailed Failed to obtain the temporary credential.
FailedOperation.ModifyRecordFailed Failed to modify the record.
FailedOperation.ModifyZoneFailed Failed to modify the private domain.
FailedOperation.UpdateRecordFailed Record update failed.
InternalError.UndefiendError Undefined error.
InvalidParameter.AccountExist A bound account already exists.
InvalidParameter.EndPointBindForwardRule The endpoint has been bound to a forwarding rule.
InvalidParameter.EndPointNotExists The endpoint does not exist.
InvalidParameter.EndPointServiceNotExist The endpoint service does not exist.
InvalidParameter.ForwardRuleNotExist The forwarding rule does not exist.
InvalidParameter.ForwardRuleZoneRepeatBind The private domain has already been bound with the forwarding rule.
InvalidParameter.IllegalCidr Invalid CIDR.
InvalidParameter.IllegalDomain Incorrect domain name.
InvalidParameter.IllegalDomainTld Incorrect top-level domain name.
InvalidParameter.IllegalPTRRecord Invalid PTR record.
InvalidParameter.IllegalRecord Invalid record.
InvalidParameter.IllegalRecordValue Invalid record value.
InvalidParameter.IllegalVpcInfo Invalid VPC.
InvalidParameter.InvalidMX The MX value must be a multiple of 5 between 5 and 50.
InvalidParameter.MXNotSupported This record type does not support MX priority settings.
InvalidParameter.RecordAAAACountExceed The number of round-robin DNS AAAA records exceeds 50.
InvalidParameter.RecordACountExceed The number of round-robin DNS A records exceeds 50.
InvalidParameter.RecordCNAMECountExceed The number of round-robin DNS CNAME records exceeds 50.
InvalidParameter.RecordConflict Records conflict.
InvalidParameter.RecordCountExceed The number of records exceeds the limit.
InvalidParameter.RecordExist The record already exists.
InvalidParameter.RecordLevelExceed The number of record levels exceeds the limit.
InvalidParameter.RecordMXCountExceed The number of round-robin DNS MX records exceeds 50.
InvalidParameter.RecordNotExist The record does not exist.
InvalidParameter.RecordRolllimitCountExceed The number of round-robin DNS records exceeds the limit.
InvalidParameter.RecordTXTCountExceed The number of round-robin DNS TXT records exceeds 10.
InvalidParameter.RecordUnsupportWeight The current record type does not support weight.
InvalidParameter.VpcBinded The VPC has been bound to another domain.
InvalidParameter.VpcBindedMainDomain The VPC has been associated with the same primary domain.
InvalidParameter.VpcPtrZoneBindExceed The number of PTR records associated with the VPC has reached the limit.
InvalidParameter.ZoneNotExists The domain does not exist.
InvalidParameterValue.IllegalTTLValue The TTL value must be in the range of 1–86400.
InvalidParameterValue.ReservedDomain This is a reserved domain name and cannot be created.
InvalidParameterValue.UinNotInWhiteList No access permission because the UIN is not added to the allowlist.
LimitExceeded.TldOutOfLimit Exceeded the custom TLD quota.
LimitExceeded.TldOutOfRange The number of private domains using the custom TLD exceeds the total quota.
OperationDenied The operation was denied.
ResourceInsufficient.Balance Insufficient balance.
ResourceNotFound.ServiceNotSubscribed The Private DNS service is not activated.
ResourceUnavailable.ServiceWhiteListNotAdded The platform account is not added to the allowlist of the current endpoint service.
ResourceUnavailable.TldPackageExpired The TLD value-added package expired.
ResourcesSoldOut The resources have been sold out.
UnauthorizedOperation.RoleUnAuthorized Role not authorized.
UnauthorizedOperation.UnauthorizedAccount Unverified user.
UnsupportedOperation.AccountNotBound Account not bound.
UnsupportedOperation.FrequencyLimit The API call frequency exceeds the limit.
UnsupportedOperation.NotSupportDnsForward Subdomain recursive DNS is not supported.

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback