Tüm Ürünler
Search
Belge Merkezi

Alibaba Cloud SDK:.NET SDK FAQ

Son Güncelleme:Oct 07, 2026

AccessKey yapılandırması, zaman aşımı hataları ve kimlik bilgisi sorunları dahil olmak üzere Alibaba Cloud .NET SDK ile ilgili sık sorulan soruların yanıtları.

Ön Koşullar

.NET Framework 4.5+ veya .NET Core 2.0+ yüklü olmalıdır.

Genel Bakış

AccessKey yapılandırma hataları

Aşağıdaki hata, hatalı bir AccessKey çifti kullanıldığını gösterir:

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

Çözümler:

  1. ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenlerinin ayarlandığını doğrulayın:

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

    Geçerli bir AccessKey çifti döndürülüyorsa ortam değişkenleri doğrudur. Aksi takdirde bu değişkenleri yeniden yapılandırın. Daha fazla bilgi için bkz. Linux, macOS ve Windows'ta ortam değişkenlerini yapılandırma.

  2. Kodda AccessKey ile ilgili hataları kontrol edin.

    Hatalı örnek:

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

    Doğru örnek:

     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"),
                };
    Not

    Bu çağrılar, AccessKey ID ve Secret değerlerini ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenlerinden okur.

    Önemli

    AccessKey sızıntılarını önlemek için AccessKey çiftini kodunuzda düz metin olarak doğrudan yazmayın.

TimeoutException hataları

API çağrısı zaman aşımlarının birden çok nedeni olabilir. Yaygın nedenler ve çözümler aşağıda verilmiştir.

Ağ bağlantısı sorunları

Başarısız veya kararsız bir ağ bağlantısı nedeniyle API isteği sunucuya ulaşamaz.

Çözümler:

Hizmet uç noktasına bağlantıyı test etmek için ping veya curl kullanın. Örneğin, bir SMS API çağrısı zaman aşımına uğrarsa ping dysmsapi.aliyuncs.com veya curl -v https://dysmsapi.aliyuncs.com komutunu çalıştırın.

  • Komut zaman aşımına uğrar veya yanıt dönmezse yerel güvenlik duvarınızı veya yönlendiricinizdeki engelleme kurallarını kontrol edin.

  • Yanıt alınıyorsa uygun bir zaman aşımı süresi ayarlayın. Daha fazla bilgi için bkz. Zaman aşımı süresi yapılandırma. Örnek kod:

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

API isteğinin uzun işleme süresi

API isteği işleme süresi okuma zaman aşımı süresini aşıyor.

Çözüm: Okuma zaman aşımı süresini uzatın. Daha fazla bilgi için bkz. Zaman aşımı süresi yapılandırma. Örnek kod:

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

Aliyun.Credentials paketi güncel değil. En son sürüme yükseltin:

dotnet add package Aliyun.Credentials

Yaygın C# özel durumları


Hata mesajı


Neden


Çözüm


SocketException


Bağlantı zaman aşımı veya kapatma gibi soket düzeyinde bir arıza.








Ağ bağlantısını doğrulamak için cURL çalıştırın. Hedef ana bilgisayarın ve bağlantı noktasının doğru olduğundan emin olun.


HttpRequestException


Ulaşılamayan sunucu veya istek zaman aşımı gibi HTTP düzeyinde bir arıza.








Ağ bağlantısını kontrol edin ve sunucunun çalıştığından emin olun. Bu özel durumu işlemek için bir try-catch bloğu kullanın.


ProtocolViolationException


Geçersiz HTTP isteği veya yanıtı gibi protokol düzeyinde bir arıza.








İsteğin ve yanıtın protokol gereksinimlerine uygun olduğunu doğrulayın.


TimeoutException


Bir işlem zaman aşımına uğradı.








Zaman aşımı süresini artırın veya işlemin sınır içinde tamamlanmasını sağlamak için performansı optimize edin.


DNS çözümleme hatası


Etki alanı adı çözümlenemiyor veya geçersiz.








Etki alanı adını doğrulayın ve DNS sunucusuna erişilebildiğinden emin olun.

Teknik destek

Diğer Alibaba Cloud SDK sorunları için: