Todos los productos
Search
Centro de documentos

Alibaba Cloud SDK:.NET SDK FAQ

Última actualización: Sep 05, 2026

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:

  1. 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_SECRET

    Windows

    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.

  2. 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"),
                };
    Nota

    Estas 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.

    Importante

    Para 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: