Se você encontrar um erro ao chamar uma operação de API, copie a mensagem de erro para a página OpenAPI Troubleshoot e encontre uma solução.
Obter uma mensagem de erro
Na página de depuração do OpenAPI Explorer
Em uma chamada de SDK
Via CLI
No Terraform
Com o Alibaba Cloud Developer Toolkit
Diagnosticar erros de API
Para consultar mensagens de erro em diferentes contas Alibaba Cloud ou para diferentes usuários RAM na mesma conta, é necessário obter primeiro a permissão adequada. Para mais informações, consulte Permissões para diagnóstico de erros de API entre contas.
Após obter a mensagem de erro, copie a resposta de erro JSON completa ou apenas o valor do parâmetro RequestId, Code ou Message para a página OpenAPI TroubleshootOpenAPI Troubleshoot e encontre uma solução.
Por exemplo, o seguinte resultado é retornado ao chamar a operação RunInstances do Elastic Compute Service (ECS):
{
"RequestId": "6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581",
"HostId": "ecs.ap-southeast-3.aliyuncs.com",
"Code": "InvalidImageId.NotFound",
"Message": "The specified ImageId does not exist.",
"Recommend": "https://api.alibabacloud.com/troubleshoot?intl_lang=EN_US&q=InvalidImageId.NotFound&product=Ecs&requestId=6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581"
}A lista a seguir descreve os parâmetros:
RequestId: o ID da requisição. Copie este ID para a página OpenAPI Troubleshoot e obtenha uma solução.
HostId: o ID do host do servidor.
Code: o código de erro.
Message: a mensagem de erro detalhada. Utilize esta mensagem para solucionar problemas nos parâmetros da requisição. Neste exemplo, ela indica que o ImageId fornecido é inválido. Para resolver o erro, use um ID de imagem válido.
Recommend: um link direto para a página de diagnóstico de erros referente a este problema específico.
Em alguns cenários, como ao usar um SDK, talvez você não receba a resposta de erro JSON completa. Ainda assim, é possível diagnosticar o problema copiando apenas o valor do parâmetro RequestId, Code ou Message para a página OpenAPI TroubleshootOpenAPI Troubleshoot. Recomendamos o uso do RequestId para obter resultados mais precisos.
A figura a seguir mostra como usar o ID da requisição para obter uma solução de diagnóstico.
Visualizar a solução de diagnóstico
A página OpenAPI Troubleshoot contém as abas Diagnostic Solution e Log Information. A aba Diagnostic Solution exibe a solução correspondente a um erro. Neste exemplo, a seguinte solução é fornecida para a mensagem de erro The specified ImageId does not exist.:
The specified image does not exist under this user account. Check whether the image ID is correct.Com base nessa solução, verifique se o parâmetro ImageId na sua requisição está correto.
Revisar logs e detalhes da requisição
Caso não tenha salve o corpo original da requisição, recupere os parâmetros da requisição, a resposta e outras informações na página OpenAPI Troubleshoot.
Usando o request ID "6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581" como exemplo, abra a aba Log Information. Esta aba fornece uma análise visual do rastreamento da chamada de API, a resposta de erro completa e o conteúdo original da requisição. Essas informações ajudam você a identificar e resolver o problema.
