tencent cloud

文档反馈

Error Codes

最后更新时间:2023-01-09 14:52:25

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
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.IncorrectSender Incorrect sender format. Follow the sample in this document.
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 Missing email content (TemplateData and Simple cannot be both empty).
FailedOperation.NoAttachPermission No permission to send an email with attachments.
FailedOperation.NotAuthenticatedSender Unable to send because the sender is not verified.
FailedOperation.NotSupportDate You 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.ReceiverHasUnsubscribed The recipient has unsubscribed.
FailedOperation.RejectedByRecipients The message was rejected by the recipient.
FailedOperation.SendEmailErr Email sending error. Please submit a ticket to us for troubleshooting.
FailedOperation.ServiceNotAvailable The request has not taken effect. Try again.
FailedOperation.TemplateContentToolarge The template size is too large. Reduce the size.
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 You can only send emails by using a template.
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.BeginTimeBeforeNow The start time cannot be earlier than the current time.
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.IllegalSenderName The sender alias is incorrect.
InvalidParameterValue.InvalidEmailIdentity Invalid domain value.
InvalidParameterValue.InvalidSmtpPassWord The password can contain 10-20 characters and must contain at least 2 unique digits, lowercase letters, and uppercase letters.
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.ReceiverDescIllegal Invalid recipient group description. The description cannot contain special characters and must contain 1 to 300 characters.
InvalidParameterValue.ReceiverEmailInvalid The recipient address is incorrect.
InvalidParameterValue.ReceiverNameIllegal Invalid recipient group name. Check the name and its size.
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.RepeatReceiverName Duplicate recipient group name.
InvalidParameterValue.SubjectLengthError The email subject must contain 1 to 100 characters.
InvalidParameterValue.TemplateContentIsNULL The template resource is empty.
InvalidParameterValue.TemplateContentIsWrong Incorrect template content. Make sure the Base64 content is correct.
InvalidParameterValue.TemplateDataError Template parameters must be in JSON format.
InvalidParameterValue.TemplateDataInconsistent The name of a template parameter variable is not the same as the original name.
InvalidParameterValue.TemplateNameIllegal Invalid template name. Make sure the characters and length of the template name are valid.
InvalidParameterValue.TemplateNameIsNULL The template name cannot be empty.
InvalidParameterValue.TemplateNotExist The template does not exist. Please create a template.
InvalidParameterValue.TemplateNotMatchData Template variables do not match recipient list parameters.
InvalidParameterValue.WrongDate Incorrect search date. Make sure the date and its format are valid.
LimitExceeded.ExceedReceiverLimit The number of recipient groups exceeded the limit.
LimitExceeded.ReceiverDetailCountLimit The number of recipient addresses in the recipient group exceeds the limit.
LimitExceeded.ReceiverDetailRequestLimit The number of recipient addresses requested exceeds the limit.
MissingParameter.CycleParamNecessary For a recurring sending task, you must select the start time and recurrence.
MissingParameter.EmailsNecessary The recipient email address is required.
MissingParameter.ReceiverIdNecessary The recipient group ID is required.
MissingParameter.SendParamNecessary Sender address, recipient group, and email template are required.
MissingParameter.TimedParamNecessary For a scheduled sending task, you must select the start time.
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.
OperationDenied.ReceiverIsOperating The recipient group is being uploaded. Try again later.
OperationDenied.ReceiverNotExist The recipient group does not exist.
OperationDenied.ReceiverStatusError The recipient group is empty or hasn’t been completely uploaded.
OperationDenied.RepeatPassWord The password cannot be the same as the last set password.
OperationDenied.SendAddressStatusError The sender address does not exist or hasn’t been approved.
OperationDenied.TemplateStatusError The email template does not exist or hasn’t been approved.