Códigos de erro - ApsaraMQ for MQTT: Central de Documentação do Alibaba Cloud

Quando uma chamada de API do ApsaraMQ for MQTT é bem-sucedida, a resposta retorna o código de status HTTP 200. Em caso de falha, a resposta inclui um código de status de erro HTTP, um código de erro e uma mensagem descritiva.

O exemplo a seguir mostra o formato da resposta de erro:

{
  "RequestId": "07AB2E7F-1EF8-4D08-A423-D58E3A26****",
  "HostId": "onsmqtt.cn-hangzhou.aliyuncs.com",
  "Code": "InstancePermissionCheckFailed",
  "Message": "An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings."
}

Use as tabelas abaixo para identificar a causa de uma solicitação com falha e como resolvê-la. Os códigos de erro estão agrupados por tipo de recurso.

Alguns códigos de erro, como InternalError e InstancePermissionCheckFailed , aparecem em vários tipos de recursos. A causa e a solução são as mesmas, independentemente do contexto.

Erros de token

Código de status HTTP	Código de erro	Mensagem de erro	Causa	Solução
404	ApiNotSupport	The specified API is not supported.	A operação de API não é compatível.	Verifique o nome da operação de API e consulte a referência de API para ver as operações compatíveis.
400	ApplyTokenOverFlow	You have applied for tokens too many times. Please try again later.	As solicitações de token estão sendo limitadas.	Reduza a frequência de solicitações de token e tente novamente após uma breve espera.
400	CheckAccountInfoFailed	An error occurred while checking the account information by the STS token.	Não foi possível analisar as informações da conta no token do Security Token Service (STS).	Verifique se o token STS é válido e tente a solicitação novamente.
400	InstancePermissionCheckFailed	An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.	A conta atual não tem permissão para acessar esta instância do ApsaraMQ for MQTT.	Verifique a propriedade da instância e confirme se as permissões necessárias foram concedidas na sua política de autorização.
500	InternalError	An error occurred while processing your request. Try again later.	Ocorreu um erro interno do serviço.	Tente a solicitação novamente. Se o erro persistir, entre em contato com o suporte da Alibaba Cloud.
400	ParameterCheckFailed	An error occurred while validating the parameters. The parameters may be missing or invalid.	Um ou mais parâmetros obrigatórios estão ausentes ou contêm valores inválidos.	Consulte a referência de API para verificar os parâmetros obrigatórios e os intervalos de valores válidos e corrija sua solicitação.
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.	A conta atual não possui as permissões necessárias para a instância, tópico ou grupo.	Revise a propriedade e as políticas de autorização de cada recurso envolvido na solicitação.
500	SystemOverFlow	An error occurred while processing your request. Please try again.	O sistema está limitando as solicitações.	Reduza a taxa de solicitações e tente novamente após uma breve espera.
400	InvalidParameter.%s	An error occurred while validating the parameter. The parameter may be missing or invalid.	O parâmetro indicado por `%s` está ausente ou é inválido.	Verifique o parâmetro específico mencionado no código de erro e forneça um valor válido.

Erros de grupo

Código de status HTTP	Código de erro	Mensagem de erro	Causa	Solução
500	CreateGroupIdError	Failed to create GroupId. Try again later.	Não foi possível criar o grupo.	Tente a solicitação novamente. Se o erro persistir, entre em contato com o suporte da Alibaba Cloud.
400	GroupIdAlreadyExsited	The specified GroupId already exists.	Já existe um grupo com este ID.	Use um ID de grupo diferente ou utilize o grupo existente, caso ele atenda às suas necessidades.
400	GroupIdAlreadyUsedByOtherUsers	The current GroupId is used by another user. Please change to a different GroupId.	Este ID de grupo está sendo usado por outro usuário.	Escolha um ID de grupo diferente.
500	InternalError	An error occurred while processing your request. Try again later.	Ocorreu um erro interno do serviço.	Tente a solicitação novamente. Se o erro persistir, entre em contato com o suporte da Alibaba Cloud.
400	ParameterFieldCheckFailed	Failed to validate the parameters. The parameters may be missing or invalid.	Um ou mais parâmetros obrigatórios estão ausentes ou contêm valores inválidos.	Consulte a referência de API para verificar nomes e valores de parâmetros válidos e corrija sua solicitação.
400	InstancePermissionCheckFailed	An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.	A conta atual não tem permissão para acessar esta instância do ApsaraMQ for MQTT.	Verifique a propriedade da instância e confirme se as permissões necessárias foram concedidas na sua política de autorização.
400	InstanceNotFound	Failed to find the instance. The instanceId may be invalid.	Nenhuma instância corresponde ao `instanceId` especificado.	Confirme se a instância existe e se o valor de `instanceId` na sua solicitação está correto.
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.	A conta atual não possui as permissões necessárias para a instância, tópico ou grupo.	Revise a propriedade e as políticas de autorização de cada recurso envolvido na solicitação.

Erros de tópico

Código de status HTTP	Código de erro	Mensagem de erro	Causa	Solução
400	ParameterFieldCheckFailed	Failed to validate the parameters. The parameters may be missing or invalid.	Um ou mais parâmetros obrigatórios estão ausentes ou contêm valores inválidos.	Consulte a referência de API para verificar nomes e valores de parâmetros válidos e corrija sua solicitação.
400	MqttTopicNumExceeded	The maximum number of topics is exceeded.	A instância atingiu o limite de tópicos.	Exclua tópicos não utilizados para liberar cota.
400	MqttTopicExist	The specified topic already exists. Please check the parameter.	Já existe um tópico com este nome na instância.	Use um nome de tópico diferente ou utilize o tópico existente, caso ele atenda às suas necessidades.
400	InstanceNotFound	Failed to find the instance. The instanceId may be invalid.	Nenhuma instância corresponde ao `instanceId` especificado.	Confirme se a instância existe e se o valor de `instanceId` na sua solicitação está correto.
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.	A conta atual não possui as permissões necessárias para o recurso especificado.	Revise a propriedade e as políticas de autorização da instância, do tópico e do grupo.
400	CreateMqttTopicFailed	An error occurred while creating the MQTT topic. Please check the parameter and try again.	Não foi possível criar o tópico na instância do ApsaraMQ for MQTT.	Verifique se todos os valores dos parâmetros são válidos e tente novamente.
400	InstancePermissionCheckFailed	An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.	A conta atual não tem permissão para acessar esta instância do ApsaraMQ for MQTT.	Verifique a propriedade da instância e confirme se as permissões necessárias foram concedidas na sua política de autorização.
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.	A conta atual não possui as permissões necessárias para a instância, tópico ou grupo.	Revise a propriedade e as políticas de autorização de cada recurso envolvido na solicitação.

Erros de regra

Código de status HTTP	Código de erro	Mensagem de erro	Causa	Solução
400	ParameterFieldCheckFailed	Failed to validate the parameters. The parameters may be missing or invalid.	Um ou mais parâmetros obrigatórios estão ausentes ou contêm valores inválidos.	Consulte a referência de API para verificar nomes e valores de parâmetros válidos e corrija sua solicitação.
400	InstancePermissionCheckFailed	An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.	A conta atual não tem permissão para acessar esta instância do ApsaraMQ for MQTT.	Verifique a propriedade da instância e confirme se as permissões necessárias foram concedidas na sua política de autorização.
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.	A conta atual não possui as permissões necessárias para a instância, tópico ou grupo.	Revise a propriedade e as políticas de autorização de cada recurso envolvido na solicitação.
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.	A conta atual não possui as permissões necessárias para o recurso especificado.	Revise a propriedade e as políticas de autorização da instância, do tópico e do grupo.
400	CreateMqttRuleFailed	An error occurred while creating the MQTT rule. Please check the parameter and try again.	Não foi possível criar a regra na instância do ApsaraMQ for MQTT.	Verifique se todos os valores dos parâmetros são válidos e tente novamente.
400	MqttRuleExist	The specified MQTT rule already exists. Please check the parameter.	A regra especificada já existe na instância.	Use uma configuração de regra diferente ou utilize a regra existente, caso ela atenda às suas necessidades.
400	MqttRuleNumExceeded	The maximum number of rules is exceeded.	A instância atingiu o limite de regras.	Exclua regras não utilizadas para liberar cota.
400	InstanceNotFound	Failed to find the instance. The instanceId may be invalid.	Nenhuma instância corresponde ao `instanceId` especificado.	Confirme se a instância existe e se o valor de `instanceId` na sua solicitação está correto.

Para obter uma lista completa de códigos de erro do ApsaraMQ for MQTT, consulte Códigos de erro do serviço.