All Products
Search
Document Center

ApsaraMQ for MQTT:Error codes

Last Updated:Nov 06, 2023

If a call to an API operation of ApsaraMQ for MQTT is successful, ResponseCode=200 is returned to the client. If the call failed, a corresponding error code and its description are returned. You can find solutions based on the error codes that are described in the following table.

Token-related error codes

HTTP status code

Error code

Error message

Description

404

ApiNotSupport

The specified API is not supported.

The API operation is not supported.

400

ApplyTokenOverFlow

You have applied for tokens too many times. Please try again later.

Tokens are frequently requested and throttling is triggered by the system. Try again later.

400

CheckAccountInfoFailed

An error occurred while checking the account information by the STS token.

The account information of the Security Token Service (STS) token failed to be parsed.

400

InstancePermissionCheckFailed

An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.

Permission verification of the ApsaraMQ for MQTT instance failed. Check the ownership and authorization policy of the instance.

500

InternalError

An error occurred while processing your request. Try again later.

The backend service of the ApsaraMQ for MQTT instance is abnormal. Try again later.

400

ParameterCheckFailed

An error occurred while validating the parameters. The parameters may be missing or invalid.

Parameter verification failed. The parameter values may be missing or invalid.

400

PermissionCheckFailed

An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.

Resource permission verification failed. Check the permissions and authorization policies of the instance, topic, and group.

500

SystemOverFlow

An error occurred while processing your request. Please try again.

Throttling is triggered. Try again.

400

InvalidParameter.%s

An error occurred while validating the parameter. The parameter may be missing or invalid.

Parameter verification failed. The parameter values may be missing or invalid.

Group-related error codes

HTTP status code

Error code

Error message

Description

500

CreateGroupIdError

Failed to create GroupId. Try again later.

The group failed to be created. Try again later.

400

GroupIdAlreadyExsited

The specified GroupId already exists.

The group ID already exists.

400

GroupIdAlreadyUsedByOtherUsers

The current GroupId is used by another user. Please change to a different GroupId.

The group is used by another user. Try another group ID.

500

InternalError

An error occurred while processing your request. Try again later.

The backend service of the ApsaraMQ for MQTT instance is abnormal. Try again later.

400

ParameterFieldCheckFailed

Failed to validate the parameters. The parameters may be missing or invalid.

Parameter verification failed. The parameter values may be missing or invalid.

400

InstancePermissionCheckFailed

An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.

Permission verification of the ApsaraMQ for MQTT instance failed. Check the ownership and authorization policy of the instance.

400

InstanceNotFound

Failed to find the instance. The instanceId may be invalid.

The instance is not found. Check whether the instance is created or whether the instance ID is correctly specified.

400

PermissionCheckFailed

An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.

Resource permission verification failed. Check the permissions and authorization policies of the instance, topic, and group.

Topic-related error codes

HTTP status code

Error code

Error message

Description

400

ParameterFieldCheckFailed

Failed to validate the parameters. The parameters may be missing or invalid.

Parameter verification failed. The parameter values may be missing or invalid.

400

MqttTopicNumExceeded

The maximum number of topics is exceeded.

The number of topics on the instance exceeds the system limit.

400

MqttTopicExist

The specified topic already exists. Please check the parameter.

The specified topic already exists. Modify the parameter settings and recreate the topic.

400

InstanceNotFound

Failed to find the instance. The instanceId may be invalid.

The instance is not found. Check whether the instance is created or whether the instance ID is correctly specified.

400

ResourcePermissionCheckFailed

An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.

Resource permission verification failed. Check the permissions and authorization policies of the instance, topic, and group.

400

CreateMqttTopicFailed

An error occurred while creating the MQTT topic. Please check the parameter and try again.

The topic failed to be created on the ApsaraMQ for MQTT instance. Check the parameter settings and recreate the topic.

400

InstancePermissionCheckFailed

An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.

Permission verification of the ApsaraMQ for MQTT instance failed. Check the ownership and authorization policy of the instance.

400

PermissionCheckFailed

An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.

Resource permission verification failed. Check the permissions and authorization policies of the instance, topic, and group.

Rule-related error codes

HTTP status code

Error code

Error message

Description

400

ParameterFieldCheckFailed

Failed to validate the parameters. The parameters may be missing or invalid.

Parameter verification failed. The parameter values may be missing or invalid.

400

InstancePermissionCheckFailed

An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.

Permission verification of the ApsaraMQ for MQTT instance failed. Check the ownership and authorization policy of the instance.

400

PermissionCheckFailed

An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.

Resource permission verification failed. Check the permissions and authorization policies of the instance, topic, and group.

400

ResourcePermissionCheckFailed

An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.

Resource permission verification failed. Check the permissions and authorization policies of the instance, topic, and group.

400

CreateMqttRuleFailed

An error occurred while creating the MQTT rule. Please check the parameter and try again.

The rule failed to be created for the ApsaraMQ for MQTT instance. Check the parameter settings and recreate the rule.

400

MqttRuleExist

The specified MQTT rule already exists. Please check the parameter.

The specified rule already exists. Modify the parameter settings and recreate the rule.

400

MqttRuleNumExceeded

The maximum number of rules is exceeded.

The number of rules for the current instance exceeds the system limit.

400

InstanceNotFound

Failed to find the instance. The instanceId may be invalid.

The instance is not found. Check whether the instance is created or whether the instance ID is correctly specified.

For more error codes, see Service error codes.