Cuando encuentre un error al llamar a una OpenAPI, copie el mensaje de error en la página OpenAPI Troubleshooting para obtener automáticamente una solución.
Obtención del mensaje de error
Página de depuración en línea de la API
Llamada con SDK
Llamada con CLI
Llamada con terraform
Alibaba Cloud Developer Toolkit
Diagnóstico de problemas de OpenAPI
Para consultar mensajes de error entre cuentas de Alibaba Cloud o entre distintos usuarios de Resource Access Management (RAM) dentro de la misma cuenta, complete primero la autorización y vuelva a intentarlo.
Una vez que obtenga el mensaje de error, copie el contenido JSON completo o únicamente los campos RequestId, Code o Message en la página OpenAPI TroubleshootingOpenAPI Troubleshooting para obtener automáticamente una solución.
Por ejemplo, si al llamar a la API RunInstances de Elastic Compute Service se produce un error, el mensaje tendrá este formato:
{
"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 continuación se describe el significado de cada parámetro:
RequestId: identificador único de la solicitud. Copie este valor en la página OpenAPI Troubleshooting para obtener automáticamente una solución.
HostId: endpoint del servicio al que se dirigió la solicitud de API.
Code: código de error.
Message: información detallada del error. Úsela para revisar los parámetros de su solicitud. En este ejemplo, el error ocurre porque se envió un identificador de imagen no válido como ImageId. Corrija el problema con un identificador de imagen válido.
Recommend: enlace directo a la página de diagnóstico de errores. Cópielo para ir directamente a la solución del problema.
En escenarios reales, por ejemplo cuando utiliza un SDK, es posible que no reciba la respuesta de error JSON completa. En ese caso, copie solo el RequestId, Code o Message en la página OpenAPI TroubleshootingOpenAPI Troubleshooting para obtener una solución. Usar el RequestId proporciona el resultado más preciso.
La solución obtenida mediante un RequestId se muestra a continuación:
Consulta de la solución de diagnóstico
Como se observa en la imagen anterior, la página muestra dos pestañas en la parte inferior: Diagnosis Solution y Log Information. La pestaña Diagnosis Solution presenta la solución encontrada. Por ejemplo, si el mensaje de error es The specified ImageId does not exist., la solución proporcionada es a continuación:
The specified image does not exist under this account. Check whether the image ID is correct.Siga las instrucciones de la solución para comprobar que el valor del parámetro ImageId sea correcto.
Revisión de los parámetros de la solicitud
En escenarios reales, es posible que no haya guardado el cuerpo original de la solicitud cuando ocurrió el error. Aun así, puede usar OpenAPI Troubleshooting para recuperar los parámetros de la solicitud, la respuesta y otros detalles.
Tome como ejemplo el error con RequestId: 6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581. Haga clic en la pestaña Log Information. Como se muestra a continuación, podrá consultar el análisis visual de la cadena de llamadas, el mensaje de error completo y el contenido original de la solicitud. Use estos registros para identificar y resolver el problema con mayor precisión.
