Alibaba Cloud SDK:.NET SDK FAQ

.NET Framework 4.5+ ou .NET Core 2.0+ instalado.

• Erros de configuração de AccessKey

• Erros de TimeoutException

• ArgumentNullException: Value cannot be null

Erros de configuração de AccessKey

O erro a seguir indica um par de AccessKey incorreto:

• 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.')

Soluções:

1. Verifique se as variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET estão definidas:

   Linux ou 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%

   Se o comando retornar um par de AccessKey válido, as variáveis de ambiente estarão corretas. Caso contrário, configure-as novamente. Para mais informações, consulte Configurar variáveis de ambiente no Linux, macOS e Windows.

2. Verifique se há erros relacionados ao AccessKey no código.

   Exemplo inválido:

    AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config
               {
                   AccessKeyId = Environment.GetEnvironmentVariable("yourAccessKeyID"),
                   AccessKeySecret = Environment.GetEnvironmentVariable("yourAccessKeySecret"),
               };

   Exemplo 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

   Essas chamadas leem o AccessKey ID e o Secret das variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET.

   Importante

   Para evitar vazamentos de AccessKey, não escreva o par de AccessKey em texto simples diretamente no código.

Erros de TimeoutException

Timeouts em chamadas de API podem ter várias causas. A seguir, apresentamos as causas comuns e suas soluções.

Problemas de conectividade de rede

A solicitação de API não alcança o servidor devido a uma conexão de rede com falha ou instável.

Soluções:

Use ping ou curl para testar a conectividade com o endpoint do serviço. Por exemplo, se uma chamada de API de SMS atingir o timeout, execute ping dysmsapi.aliyuncs.com ou curl -v https://dysmsapi.aliyuncs.com.

• Se o comando atingir o timeout ou não retornar resposta, verifique políticas de bloqueio no firewall local ou no roteador.

• Caso receba uma resposta, defina um período de timeout apropriado. Para mais informações, consulte Configurar um período de timeout. Código de exemplo:

  // 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;

Tempo de processamento longo da solicitação de API

O tempo de processamento da solicitação de API excede o período de timeout de leitura.

Solução: Estenda o período de timeout de leitura. Para mais informações, consulte Configurar um período de timeout. Código de exemplo:

// 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

O pacote Aliyun.Credentials está desatualizado. Atualize para a versão mais recente:

dotnet add package Aliyun.Credentials

Para outros problemas com o Alibaba Cloud SDK:

• Crie um ticket.

• Grupo do DingTalk para suporte técnico: 60965016010.