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.