Error Codes

Last updated: 2021-02-02 11:44:45

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
UnsupportedOperation Unsupported operation.
ResourceInUse Resource is in use.
InternalError Internal error.
RequestLimitExceeded The number of requests exceeds the frequency limit.
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.
LimitExceeded Quota limit exceeded.
NoSuchVersion The API version does not exist.
ResourceNotFound The resource does not exist.
AuthFailure.SignatureFailure Invalid signature. Signature calculation error. Please ensure you’ve followed the signature calculation process described in the Signature API documentation.
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.
UnsupportedRegion API does not support the requested region.
UnauthorizedOperation Unauthorized operation.
InvalidParameter Incorrect parameter.
ResourceUnavailable Resource is unavailable.
AuthFailure.MFAFailure MFA failed.
AuthFailure.UnauthorizedOperation The request is not authorized. For more information, see the CAM documentation.
AuthFailure.InvalidSecretId Invalid key (not a TencentCloud API key type).
AuthFailure.TokenFailure Token error.
DryRunOperation DryRun Operation. It means that the request would have succeeded, but the DryRun parameter was used.
FailedOperation Operation failed.
UnknownParameter Unknown parameter.
UnsupportedProtocol HTTP(S) request protocol error; only GET and POST requests are supported.
InvalidParameterValue Invalid parameter value.
InvalidAction The API does not exist.
MissingParameter A parameter is missing.
ResourceInsufficient Insufficient resource.

Service Error Codes

Error Code Description
FailedOperation.AttachContentToolarge The attachments are too large. Make sure they do not exceed the size limit for a single attachment and the overall limit for all attachments.
FailedOperation.EmailAddrInBlacklist The email address is in the blocklist.
FailedOperation.EmailContentToolarge The email is too large. Remove some content.
FailedOperation.ExceedSendLimit The number of emails exceeds the daily sending limit.
FailedOperation.ExceedTemplateLimit The number of templates exceeds the upper limit.
FailedOperation.FrequencyLimit You have sent too many emails to the same address in a short period.
FailedOperation.HighRejectionRate The email has been blocked temporarily due to high rejection rate.
FailedOperation.IncorrectEmail Incorrect email address.
FailedOperation.InsufficientBalance Insufficient balance or account in arrears.
FailedOperation.InsufficientQuota Insufficient emails in plans.
FailedOperation.InvalidAttachName Unsupported attachment name. Make sure it does not contain special characters. For details, see the attachment description.
FailedOperation.InvalidLimit Reached the query limit (100).
FailedOperation.InvalidTemplateID Invalid template ID or unavailable template.
FailedOperation.MissingEmailContent
FailedOperation.NoAttachPermission No permission to send an email with attachments.
FailedOperation.NotAuthenticatedSender Unable to send because the sender is not verified.
FailedOperation.NotSupportDate Cannot query email records for this date. Only data within 90 days can be queried.
FailedOperation.ProtocolCheckErr Incorrect protocol. Make sure the protocol is correct.
FailedOperation.ServiceNotAvailable The request has not taken effect. Try again.
FailedOperation.TemplateContentToolarge The template is too large. Remove some content.
FailedOperation.TemporaryBlocked The email has been blocked temporarily due to violations of rules.
FailedOperation.TooManyAttachments Too many attachments. A single email supports up to 10 attachments.
FailedOperation.TooManyRecipients Too many recipients. Set a maximum of 50 recipients at a time.
FailedOperation.UnsupportMailType Unsupported email type.
FailedOperation.WithOutPermission The feature of sending custom emails is not enabled. Use a template to send emails.
FailedOperation.WrongContentJson The format of the TemplateData field is incorrect. Make sure it is in JSON format.
InvalidParameterValue.AttachContentIsWrong Incorrect attachment content. Make sure the base64 content is correct.
InvalidParameterValue.CreatedByOther This sender domain has been created by another Tencent Cloud account.
InvalidParameterValue.EmailAddressIsNULL The recipient or sender address is empty. Please check.
InvalidParameterValue.EmailContentIsWrong Incorrect email content. Make sure TEXT/HTML base64 is correct.
InvalidParameterValue.IllegalEmailAddress Invalid email address. Make sure the address format is correct.
InvalidParameterValue.InvalidEmailIdentity Invalid domain value.
InvalidParameterValue.NoSuchSender You don’t have the sender address. Check if it exists.
InvalidParameterValue.NotExistDomain This sender domain does not exist. Create it first.
InvalidParameterValue.RepeatCreation This sender domain already exists. Do not create it again.
InvalidParameterValue.RepeatEmailAddress This email address already exists. Do not create it again.
InvalidParameterValue.TemplateContentIsNULL The template resource is empty.
InvalidParameterValue.TemplateContentIsWrong Incorrect template content. Make sure the base64 content is correct.
InvalidParameterValue.TemplateNameIllegal Invalid template name. Make sure the characters and length of the template name are valid.
InvalidParameterValue.TemplateNameIsNULL Template name cannot be empty.
InvalidParameterValue.TemplateNotExist This template does not exist. Create one first.
InvalidParameterValue.WrongDate Incorrect search date. Make sure the date and its format are valid.
OperationDenied Operation denied.
OperationDenied.DomainNotVerified Domain verification failed. Check whether the domain has passed verification.
OperationDenied.ExceedDomainLimit The number of sender domains exceeds the upper limit.
OperationDenied.ExceedSenderLimit The number of sender addresses exceeds the upper limit.

Was this page helpful?

Was this page helpful?

  • Not at all
  • Not very helpful
  • Somewhat helpful
  • Very helpful
  • Extremely helpful
Send Feedback
Help