Respuestas a las preguntas más comunes sobre el SDK de Alibaba Cloud para .NET. Se incluye información sobre la configuración de AccessKey, los errores de tiempo de espera y los problemas con las credenciales.
Requisitos previos
Debe tener instalado .NET Framework 4.5+ o .NET Core 2.0+.
Descripción general
Errores en la configuración de AccessKey
A continuación se muestran los errores que indican un par de AccessKey incorrecto:
Alibaba Cloud SDK V2.0: Unhandled exception. Tea.TeaException: Please set up the credentials correctly. If you are setting them through environment variables, please ensure that ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set correctly.
Alibaba Cloud SDK V1.0: Unhandled exception. System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values. (Parameter 'Access key ID cannot be null.')
Soluciones:
-
Compruebe que las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET estén configuradas:
Linux o macOS
echo $ALIBABA_CLOUD_ACCESS_KEY_ID echo $ALIBABA_CLOUD_ACCESS_KEY_SECRETWindows
echo %ALIBABA_CLOUD_ACCESS_KEY_ID% echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%Si se devuelve un par de AccessKey válido, las variables de entorno son correctas. De lo contrario, vuelva a configurarlas. Para obtener más información, consulte Configure environment variables on Linux, macOS, and Windows.
-
Revise el código en busca de errores relacionados con AccessKey.
Ejemplo no válido:
AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config { AccessKeyId = Environment.GetEnvironmentVariable("yourAccessKeyID"), AccessKeySecret = Environment.GetEnvironmentVariable("yourAccessKeySecret"), };Ejemplo válido:
AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config { AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"), AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"), };NotaEstas llamadas leen el ID y el secreto de AccessKey desde las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET.
ImportantePara evitar filtraciones de AccessKey, no escriba el par de AccessKey en texto plano directamente en su código.
Errores de TimeoutException
Los tiempos de espera agotados en las llamadas a la API pueden deberse a varias causas. A continuación se describen las más comunes y sus soluciones.
Problemas de conectividad de red
La solicitud a la API no llega al servidor debido a una conexión de red con errores o inestable.
Soluciones:
Utilice ping o curl para probar la conectividad con el endpoint del servicio. Por ejemplo, si se agota el tiempo de espera en una llamada a la API de SMS, ejecute ping dysmsapi.aliyuncs.com o curl -v https://dysmsapi.aliyuncs.com.
Si el comando agota el tiempo de espera o no devuelve respuesta, revise las políticas de bloqueo en su firewall o router local.
-
Si se obtiene una respuesta, establezca un periodo de tiempo de espera adecuado. Para obtener más información, consulte Configure a timeout period. Código de ejemplo:
// Configure the timeout period for connection requests by using runtime parameters. The timeout period takes effect only for requests that use RuntimeOptions. RuntimeOptions runtimeOptions = new RuntimeOptions(); runtimeOptions.ConnectTimeout = connectionTimeoutMillis;
Tiempo de procesamiento prolongado de la solicitud a la API
El tiempo de procesamiento de la solicitud a la API supera el periodo de tiempo de espera de lectura.
Solución: aumente el periodo de tiempo de espera de lectura. Para obtener más información, consulte Configure a timeout period. Código de ejemplo:
// Configure the timeout period for read requests by using runtime parameters. The timeout period takes effect only for requests that use RuntimeOptions.
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.ReadTimeout = readTimeoutMillis;
ArgumentNullException: Value cannot be null
El paquete Aliyun.Credentials está desactualizado. Actualícelo a la versión más reciente:
dotnet add package Aliyun.Credentials
Excepciones comunes de C#
|
Mensaje de error |
Causa |
Solución |
|
SocketException |
Error a nivel de socket, como un cierre o un tiempo de espera agotado en la conexión. |
Ejecute cURL para comprobar la conectividad de red. Confirme que el host y el puerto de destino sean correctos. |
|
HttpRequestException |
Error a nivel HTTP, como un servidor inalcanzable o un tiempo de espera agotado en la solicitud. |
Compruebe la conexión de red y confirme que el servidor esté en ejecución. Utilice un bloque try-catch para gestionar esta excepción. |
|
ProtocolViolationException |
Error a nivel de protocolo, como una solicitud o respuesta HTTP no válida. |
Compruebe que la solicitud y la respuesta cumplan con los requisitos del protocolo. |
|
TimeoutException |
Se agotó el tiempo de espera de una operación. |
Aumente el periodo de tiempo de espera u optimice el rendimiento para que la operación finalice dentro del límite establecido. |
|
Error de resolución de DNS |
El nombre de dominio no se puede resolver o no es válido. |
Compruebe el nombre de dominio y confirme que el servidor DNS sea accesible. |
Soporte técnico
Para otros problemas con el SDK de Alibaba Cloud:
Grupo de DingTalk para soporte técnico: 60965016010.