Alibaba Cloud SDK:Python SDK ile ilgili SSS

AccessKey hatalarını nasıl gideririm?

Sorun: Kod çalıştırıldıktan sonra aşağıdaki hata mesajı döndürülür. Hata mesajı, AccessKey çiftinin doğru yapılandırılmadığını gösterir.

• Alibaba Cloud SDK V2.0: AttributeError: 'NoneType' object has no attribute 'get_access_key_id'.

• Alibaba Cloud SDK V1.0: Error:MissingParameter The input parameter "AccessKeyId" that is mandatory for processing this request is not supplied.

Çözümler:

1. ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenlerinin yapılandırılıp yapılandırılmadığını kontrol etmek için aşağıdaki komutları çalıştırın.

   Linux/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 düzgün şekilde yapılandırılmış demektir. AccessKey çifti döndürülmezse veya geçersiz bir AccessKey çifti döndürülürse ortam değişkenlerini gerektiği gibi 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 çiftiyle ilgili hataları kontrol edin.

   Örnek hatalı istek:

    config = open_api_models.Config(
               access_key_id=os.environ['yourAccessKeyID'],
               access_key_secret=os.environ['yourAccessKeySecret']
           )

   Örnek başarılı istek:

    config = open_api_models.Config(
              access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
              access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
           )

   Not

   os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'] ve os.environ("ALIBABA_CLOUD_ACCESS_KEY_SECRET"), AccessKey ID ve AccessKey secret değerlerinin ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ortam değişkenlerinden alındığını belirtir.

   Önemli

   Güvenlik risklerini önlemek için AccessKey çiftini kaynak koduna doğrudan yazmayın.

SDK yüklenemediğinde ne yapmalıyım?

• Python 3.x gibi geçerli bir Python sürümünün yüklü olduğundan emin olun.

• SDK'yı pip komutuyla yüklerken --upgrade seçeneğini ekleyin. Bu, en son sürümün yüklenmesini sağlar.

pip install --upgrade <SDK_NAME>  

• Yükleme işlemi sırasında izin sorunlarıyla karşılaşırsanız (örneğin, SDK'yı Python kitaplıklarının sistem dizinine yüklediğinizde) SDK'yı sistem dizini yerine kullanıcı dizinine yüklemek için --user seçeneğini kullanabilirsiniz.

pip install --user <SDK_NAME>  

• Bilgisayarınızda birden fazla Python sürümü yüklüyse SDK'yı kullandığınız Python sürümüne yüklediğinizden emin olun. Örneğin, kodda python yerine python3 kullanın ve pip3 komutlarını çalıştırın.

Bir modül içe aktarılamadığında ve ModuleNotFoundError hatası bildirildiğinde ne yapmalıyım?

SDK'nın düzgün yüklendiğinden emin olun. Ardından, Python ortamında bir modülü içe aktarmayı deneyin.

• Python yorumlayıcısını başlatın.

python

• Bir modülü içe aktarın.

import <SDK_NAME> 

Hata oluşmazsa SDK düzgün yüklenmiş demektir. ModuleNotFoundError veya ImportError hatası oluşursa SDK düzgün yüklenmemiş demektir.

pip install <SDK_NAME>

"AttributeError: 'CredentialModel' object has no attribute 'provider_name'" hata mesajı döndürülürse ne yapmalıyım?

Aşağıdaki hata mesajı döndürülürse ne yapmalıyım: code: 400, The input parameter"AccesskeyId" that is mandatory for processing this request is not supplied?

• Hata mesajı, ağ geçidine gönderilen bir isteğin AccessKey ID içermediği için döndürülür.

• OpenAPI Explorer'dan indirilen tam örnek kodu kullanırken AccessKey ID'nizin düzgün yapılandırılıp yapılandırılmadığını kontrol edin. Ana yöntemi çağırırken AccessKey ID'nizi ve AccessKey secret değerinizi yapılandırın.

OpenAPI Explorer'daki SDK Sample sekmesinde, main yöntemindeki accessKeyId ve accessKeySecret değerlerini bulun ve yer tutucu değerleri kendi AccessKey bilginizle değiştirin.

Aşağıdaki hata mesajı döndürülürse ne yapmalıyım: Tea.exceptions.TeaException: Error: SignatureDoesNotMatch.MissingHeader code: 400, The specified signed header "accept;connection;content-type;host;user-agent;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version" is not found?

Hata mesajı, kendinden imzalı modda bir hizmeti çağırırken kısa ömürlü bağlantıları uygulamak amacıyla Connection üstbilgisi close olarak ayarlandığında döndürülür. Ancak V3 imzalama yöntemi bu ayarla uyumlu değildir ve bu durum hataya neden olur.

Bu hatayı şu ayarı kullanarak düzeltebilirsiniz: config.signature_algorithm = 'v2'.

Aşağıdaki hata mesajı döndürülürse ne yapmalıyım: Tea.exceptions.TeaException: Connection aborted?

Hata mesajı, istek aralığının beklenenden uzun olması nedeniyle döndürülür. Sunucu kalıcı bağlantıyı yalnızca 30 saniye boyunca açık tutar, istemci ise bağlantıyı kalıcı olarak sürdürür. Bu durumda sunucu 30 saniye sonra bağlantıyı kapatır. İstemci 30 saniye sonra bir istek başlatırsa istek başarısız olur.

• Kısa ömürlü bağlantıları uygulamak için Connection üstbilgisini close olarak ayarlayın.

• Çağrının 30 saniye içinde başlatılmasını sağlamak için bir yeniden deneme mekanizması yapılandırın.

API çağrısı zaman aşımına uğradığında ve "requests.exceptions.Timeout" veya "requests.exceptions.ConnectionError" hata mesajı döndürüldüğünde ne yapmalıyım?

API çağrısı zaman aşımı çeşitli faktörlerden kaynaklanabilir. Aşağıdaki bölümde yaygın nedenler ve ilgili çözümler açıklanmaktadır.

Ağ bağlantısı sorunları

Neden: İstemci ve sunucu arasındaki ağ bağlantısı kesildiği veya ağ kararsız olduğu için istek sunucuya ulaşamaz.

Çözümler:

Yerel ana bilgisayar ile cloud hizmetinin uç noktası arasındaki bağlantıyı test etmek için ping veya curl komutunu çalıştırın. Örneğin, yerel ana bilgisayarınız ile Short Message Service (SMS) API'sinin uç noktası arasındaki bağlantıyı test etmek için 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 almazsa yerel güvenlik duvarınızda veya yönlendiricilerinizde engelleme ilkelerini kontrol edin.

• Yanıt döndürülürse yanlış zaman aşımı yapılandırmalarından kaynaklanan istek hatalarını önlemek için uygun bir zaman aşımı süresi belirtmenizi öneririz. Daha fazla bilgi için bkz. Zaman aşımı süresi yapılandırma. Örnek kod:

• # The timeout period takes effect only for requests that use RuntimeOptions.
  runtimeOptions = RuntimeOptions(
      connect_timeout=5000  # Configure the timeout period for connection requests. Unit: milliseconds.
  )

Neden 2: İsteğin işlenmesinin uzun sürmesi

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

Çözüm: API yanıtı için zaman aşımı süresini uzatın. Daha fazla bilgi için bkz. Zaman aşımı süresi yapılandırma. Örneğin, okuma zaman aşımı süresini uzatmak için read timeout parametresini yapılandırabilirsiniz. Örnek kod:

# The timeout period takes effect only for requests that use RuntimeOptions.
runtimeOptions = RuntimeOptions(
    read_timeout=10000,  # Configure the timeout period for read requests. Unit: milliseconds.
)

Linux'ta "-bash: python3: command not found" hata mesajı döndürülürse ne yapmalıyım?

Python'u yüklediyseniz bu hata mesajı sembolik bağlantıların düzgün yapılandırılmamasından dolayı döndürülebilir.

• Sistemde sembolik bağlantıların olup olmadığını kontrol etmek için which python3 pip3 komutunu çalıştırın. Sembolik bağlantılar varsa bunları silin.

rm -rf /usr/bin/python3 /usr/bin/pip3

• Sembolik bağlantıları tekrar oluşturun. Python'un kurulum dizinini bulun, bin dizinine gidin ve ardından pip3.12 ile python3.12 dosyalarını bulun. Sembolik bağlantıları oluşturmak için aşağıdaki komutları çalıştırın:

sudo ln -s /usr/local/python3/bin/python3.12 /usr/bin/python3
sudo ln -s /usr/local/python3/bin/pip3.12 /usr/bin/pip3

API işlemi çağrılırken "Invalid parameters" veya "MissingRequiredParameter" hatası bildirilirse ne yapmalıyım?

Bu örnekte Short Message Service (SMS) hizmetinin SendSms işlemi kullanılmaktadır.

• OpenAPI Explorer'daki API Debugging sayfasına gidin, ardından cloud ürününü ve API'yi seçin.

• Oluşturulan istek nesnesinde PhoneNumbers ve SignName gibi tüm gerekli parametrelerin belirtilip belirtilmediğini kontrol edin. Bu örnekte SendSmsRequest nesnesi kullanılır.

• API referansına göre tüm gerekli parametrelerin belirtildiğini doğrulayın.

• Gerekli parametre değerlerinin geçerli olduğundan emin olun. Örneğin, cep telefonu numaralarının geçerli biçimlerde belirtilip belirtilmediğini kontrol edin.

• SDK bir API isteği göndermeden önce parametreleri otomatik olarak doğrular. Bir veya daha fazla gerekli parametre belirtilmezse MissingRequiredParameter gibi bir hata bildirilir. Örneğin, PhoneNumbers parametresi belirtilmezse "MissingPhoneNumbers: code: 400" hatası bildirilir. Bu durumda parametreyi hata mesajına göre belirtin.

API'yi telefon numarası parametresi olmadan çağırmak konsolda MissingPhoneNumbers: code: 400 hatasını döndürür.

send_sms_request = dysmsapi_20170525_models.SendSmsRequest(
            # The mobile numbers to which you want to send a text message.
            phone_numbers='<YOUR_VALUE>',
            # The name of the SMS signature.
            sign_name='<YOUR_VALUE>',
            # The code of the SMS template.
            template_code='<YOUR_VALUE>',
            # The variables of the SMS template. Specify the value in the JSON format. Example: {"code":"1234","name":"1234","time":"1234"}.
            template_param='{"code":"1234","name":"1234","time":"1234"}'
        )

API işlemi çağrılamadığında ve "Tea.exceptions.UnretryableException" hatası bildirildiğinde ne yapmalıyım?

Seçtiğiniz bölgenin çağırdığınız hizmeti desteklediğinden emin olun. SMS'i örnek olarak alırsak hizmetin uç noktalarını OpenAPI Explorer üzerindeki ürün sayfasında bulabilirsiniz. Bölgeniz için doğru uç noktayı kullanın.

Ürün ana sayfasındaki Service Area List sekmesine tıklayın. Her bölge için doğru uç noktayı bulmak üzere Region ID ve Service Address sütunlarını kullanın. Örneğin, Çin anakarasındaki bölgeler için SMS uç noktası dysmsapi.aliyuncs.com şeklindedir.

Aşağıdaki hata mesajı döndürülürse ne yapmalıyım: File "/usr/local/python3/lib/python3.6/site-packages/alibabacloud_slb20140515/client.py", line 4, in <module> from Tea.core import TeaCore ModuleNotFoundError: No module named 'Tea'?

Hata mesajı, pip sürümünün eski olması nedeniyle döndürülür. Bu durumda yüklenen bağımlılıklar eksiktir veya belirli bağımlılıklar silinmiştir. Bu hatayı düzeltmek için pip'i güncelleyebilir ve pip install <Kurulum paketi> komutunu çalıştırabilirsiniz. Örneğin, Tea modülünü yüklemek için pip install alibabacloud-tea komutunu çalıştırın.

Soru 13: Aşağıdaki hata mesajı döndürülürse ne yapmalıyım: Command "python setup.py egg_info" failed with error code 1 in xxx?

Hata mesajı, Python veya pip sürümünün eski olması ya da gerekli kitaplıkların veya paketlerin yüklü olmaması nedeniyle döndürülür. Sonuç olarak SDK beklendiği gibi çalışamaz.

Çözümler:

1. SSL/TLS sürümlerini kontrol edin: Yerel cihazdaki Python ortamının sunucunun iletişim için kullandığı SSL/TLS sürümünü desteklediğinden emin olun. Bazı durumlarda sunucu yalnızca TLS 1.2'yi destekler.

   import ssl
   import urllib3
   # Create an SSL context that uses TLS 1.2.
   ssl_context = ssl.create_urllib3_context(ssl.OP_NO_SSLv2, ssl.OP_NO_SSLv3, ssl.OP_NO_TLSv1, ssl.OP_NO_TLSv1_1)
   # Initialize the urllib3 pool manager.
   http = urllib3.PoolManager(context=ssl_context)
   # Send the request.
   response = http.request('GET', 'https://ocr-api.cn-hangzhou.aliyuncs.com/?Country=Vietnam')
             

2. Python ortamı sorunlarını kontrol edin:

   1. ssl modülünün ve urllib3 kitaplığının sürümünün Python sürümüyle uyumlu olduğundan emin olun.

   2. Python'u ve bağımlılıklarını yeniden yüklemek için sanal bir ortam kullanın.

   python -m venv myenv
   source myenv/bin/activate
   pip install requests urllib3 pyOpenSSL

3. Ağ yapılandırma hatalarını kontrol edin.

   1. Yerel cihazdaki güvenlik duvarının HTTPS bağlantı noktasına (443 numaralı bağlantı noktası) trafiğe izin verdiğinden emin olun.

   2. Proxy sunucusu kullanıyorsanız doğru yapılandırıldığından emin olun.

   import requests
   # Use a proxy
   proxies = {
       'http': 'http://your-proxy-server:port',
       'https': 'https://your-proxy-server:port'
   }
   response = requests.get(
       'https://ocr-api.cn-hangzhou.aliyuncs.com/?Country=Vietnam',
       proxies=proxies
   )

4. Sorunu çözmek için requests ve urllib3 kitaplıklarını güncelleyin.

   pip install --upgrade requests urllib3

5. Güncellemeden sonra sorun devam ederse sorun ortam sertifikasından kaynaklanıyor olabilir. Sertifikayı yoksaymak ve zaman aşımı süresini ayarlamak için aşağıdaki parametreleri yapılandırın:

   # Ignore certificate verification.
   runtimeOptions = RuntimeOptions(
    ignore_ssl=True # Ignores SSL certificate verification. Verification is enabled by default.
   )
   # Adjust the timeout.
   runtimeOptions = RuntimeOptions(
       read_timeout=xxx,  # Read timeout in milliseconds (ms)
       connect_timeout=xxx  # Connection timeout in milliseconds (ms)
   )

6. SSL sertifika doğrulaması devre dışı bırakıldıktan sonra sorun devam ederse SSL sertifika doğrulamasını devre dışı bırakmak için PYTHONHTTPSVERIFY ortam değişkenini 0 olarak ayarlayın.

   export PYTHONHTTPSVERIFY=0  # Disable HTTPS verification.

7. Yerel makinedeki SSL sertifikasını kontrol edin: Yerel makinedeki SSL sertifikasının güncel ve eksiksiz olduğundan emin olun. Sertifikaları güncellemek ve yüklemek için certbot gibi bir araç kullanabilirsiniz.

   sudo certbot certonly --standalone --rsa-key-size 4096 --agree-tos --email yo**@email.com