Alibaba Cloud SDK：FAQ tentang SDK untuk Python

Bagaimana cara menangani kesalahan AccessKey?

Masalah: Pesan kesalahan berikut muncul setelah menjalankan kode, yang menunjukkan bahwa pasangan AccessKey tidak dikonfigurasi dengan benar.

• Alibaba Cloud SDK V2.0: AttributeError: Objek 'NoneType' tidak memiliki atribut 'get_access_key_id'.

• Alibaba Cloud SDK V1.0: Error:MissingParameter Parameter input "AccessKeyId" yang wajib untuk memproses permintaan ini tidak diberikan.

Solusi:

1. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah dikonfigurasi.

   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%

   Jika pasangan AccessKey yang valid dikembalikan, variabel lingkungan telah dikonfigurasi dengan benar. Jika tidak, konfigurasikan variabel lingkungan sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.

2. Periksa kesalahan terkait pasangan AccessKey dalam kode.

   Contoh permintaan kesalahan:

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

   Contoh permintaan sukses:

    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']
           )

   Catatan

   os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'] dan os.environ("ALIBABA_CLOUD_ACCESS_KEY_SECRET") menentukan bahwa ID AccessKey dan rahasia AccessKey diperoleh dari variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET.

   Penting

   Untuk mencegah risiko keamanan, jangan tulis pasangan AccessKey dalam kode online.

Apa yang harus saya lakukan jika SDK gagal dipasang?

• Pastikan versi Python yang valid telah terpasang, seperti Python 3.x.

• Tambahkan opsi --upgrade saat memasang SDK dengan perintah pip. Ini memastikan versi terbaru dipasang.

pip install --upgrade <SDK_NAME>

• Jika Anda mengalami masalah izin selama proses pemasangan, seperti saat memasang SDK di direktori sistem pustaka Python, gunakan opsi --user untuk memasang SDK di direktori pengguna alih-alih direktori sistem.

pip install --user <SDK_NAME>

• Jika beberapa versi Python terpasang di PC Anda, pastikan Anda memasang SDK di versi Python yang digunakan. Misalnya, gunakan python3 alih-alih python dalam kode dan jalankan perintah pip3.

Apa yang harus saya lakukan jika modul gagal diimpor dan kesalahan ModuleNotFoundError dilaporkan?

Pastikan SDK telah terpasang dengan benar. Kemudian, coba impor modul dalam lingkungan Python.

• Mulai interpreter Python.

python

• Impor modul.

import <SDK_NAME>

Jika tidak ada kesalahan yang terjadi, SDK telah terpasang dengan benar. Jika kesalahan ModuleNotFoundError atau ImportError terjadi, SDK tidak terpasang dengan benar.

pip install <SDK_NAME>

Apa yang harus saya lakukan jika pesan kesalahan "AttributeError: Objek 'CredentialModel' tidak memiliki atribut 'provider_name'" dikembalikan?

Apa yang harus saya lakukan jika pesan kesalahan berikut dikembalikan: code: 400, Parameter input "AccesskeyId" yang wajib untuk memproses permintaan ini tidak diberikan?

• Pesan kesalahan dikembalikan karena permintaan yang dikirim ke gateway tidak berisi ID AccessKey.

• Periksa apakah ID AccessKey Anda telah dikonfigurasi dengan benar saat menggunakan kode sampel lengkap yang diunduh dari OpenAPI Explorer. Konfigurasikan ID AccessKey dan rahasia AccessKey Anda saat memanggil metode utama.

Apa yang harus saya lakukan jika pesan kesalahan berikut dikembalikan: Tea.exceptions.TeaException: Error: SignatureDoesNotMatch.MissingHeader code: 400, Header tanda tangan yang ditentukan "accept;connection;content-type;host;user-agent;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version" tidak ditemukan?

Pesan kesalahan dikembalikan karena header Connection diatur ke close untuk mengimplementasikan koneksi singkat saat memanggil layanan dalam mode penandatanganan mandiri. Namun, metode tanda tangan V3 tidak kompatibel dengan pengaturan ini, yang menghasilkan kesalahan.

Anda dapat memperbaiki kesalahan ini dengan menggunakan pengaturan berikut: config.signature_algorithm = 'v2'.

Apa yang harus saya lakukan jika pesan kesalahan berikut dikembalikan: Tea.exceptions.TeaException: Koneksi dibatalkan?

Pesan kesalahan dikembalikan karena interval permintaan lebih lama dari yang diharapkan. Server hanya menjaga koneksi persisten selama 30 detik, sedangkan klien menjaga koneksi secara persisten. Dalam hal ini, server menutup koneksi setelah 30 detik. Jika klien memulai permintaan setelah 30 detik, kegagalan permintaan terjadi.

• Atur header Connection ke close untuk mengimplementasikan koneksi singkat.

• Konfigurasikan mekanisme ulang untuk memastikan bahwa panggilan diinisiasi dalam 30 detik.

Apa yang harus saya lakukan jika panggilan API habis waktu tunggunya dan pesan kesalahan "requests.exceptions.Timeout" atau "requests.exceptions.ConnectionError" dikembalikan?

Habis waktu tunggu panggilan API dapat disebabkan oleh beberapa faktor. Bagian berikut menggambarkan penyebab umum dan solusi yang sesuai.

Masalah koneksi jaringan

Penyebab: Permintaan tidak dapat mencapai server karena koneksi jaringan antara klien dan server gagal atau jaringan tidak stabil.

Solusi:

Jalankan perintah ping atau curl untuk menguji konektivitas antara host lokal dan titik akhir layanan cloud. Misalnya, jalankan perintah ping dysmsapi.aliyuncs.com atau curl -v https://dysmsapi.aliyuncs.com untuk menguji konektivitas antara host lokal Anda dan titik akhir Layanan Pesan Singkat (SMS) API.

• Jika perintah habis waktu tunggunya atau tidak menerima respons, periksa kebijakan pemblokiran pada firewall atau router lokal Anda.

• Jika respons dikembalikan, kami sarankan Anda menentukan periode timeout yang tepat untuk mencegah kegagalan permintaan yang disebabkan oleh konfigurasi timeout yang tidak tepat. Untuk informasi lebih lanjut, lihat Konfigurasikan periode timeout. Contoh kode:

• # Periode timeout hanya berlaku untuk permintaan yang menggunakan RuntimeOptions.
  runtimeOptions = RuntimeOptions(
      connect_timeout=5000  # Konfigurasikan periode timeout untuk permintaan koneksi. Unit: milidetik.
  )

Penyebab 2: Waktu pemrosesan permintaan yang diperpanjang

Penyebab: Waktu untuk memproses permintaan API melebihi periode timeout baca yang ditentukan.

Solusi: Perpanjang periode timeout untukrespons API. Untuk informasi lebih lanjut, lihat Konfigurasikan periode timeout. Misalnya, Anda dapat mengonfigurasi parameter timeout baca untuk memperpanjang periode timeout baca. Contoh kode:

# Periode timeout hanya berlaku untuk permintaan yang menggunakan RuntimeOptions.
runtimeOptions = RuntimeOptions(
    read_timeout=10000,  # Konfigurasikan periode timeout untuk permintaan baca. Unit: milidetik.
)

Apa yang harus saya lakukan jika pesan kesalahan "-bash: python3: command not found" dikembalikan di Linux?

Jika Anda telah memasang Python, pesan kesalahan ini mungkin dikembalikan karena tautan simbolis tidak dikonfigurasi dengan benar.

• Jalankan perintah which python3 pip3 untuk memeriksa apakah tautan simbolis ada dalam sistem. Jika tautan simbolis ada, hapus tautan simbolis.

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

• Buat tautan simbolis lagi. Temukan direktori instalasi Python, akses direktori bin, dan kemudian temukan pip3.12 dan python3.12. Jalankan perintah berikut untuk membuat tautan simbolis:

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

Apa yang harus saya lakukan jika "Parameter tidak valid" atau kesalahan "MissingRequiredParameter" dilaporkan saat saya memanggil operasi API?

Dalam contoh ini, operasi SendSms dari Layanan Pesan Singkat (SMS) digunakan.

• Masuk ke OpenAPI Explorer. Pergi ke halaman debugging API dari layanan Alibaba Cloud yang ingin Anda panggil. Temukan operasi API yang ingin Anda panggil.

• Periksa apakah semua parameter yang diperlukan seperti PhoneNumbers dan SignName telah ditentukan dalam objek permintaan yang dibuat. Dalam contoh ini, objek SendSmsRequest digunakan.

• Verifikasi bahwa semua parameter yang diperlukan telah ditentukan berdasarkan referensi API.

• Pastikan nilai parameter yang diperlukan valid. Misalnya, periksa apakah nomor ponsel ditentukan dalam format yang valid.

• Sebelum SDK mengirim permintaan API, SDK secara otomatis memverifikasi parameter. Jika satu atau lebih parameter yang diperlukan tidak ditentukan, kesalahan seperti MissingRequiredParameter dilaporkan. Misalnya, jika parameter PhoneNumbers tidak ditentukan, kesalahan "MissingPhoneNumbers: code: 400" dilaporkan. Dalam hal ini, tentukan parameter berdasarkan pesan kesalahan.

send_sms_request = dysmsapi_20170525_models.SendSmsRequest(
            # Nomor ponsel ke mana Anda ingin mengirim pesan teks.
            phone_numbers='<YOUR_VALUE>',
            # Nama tanda tangan SMS.
            sign_name='<YOUR_VALUE>',
            # Kode template SMS.
            template_code='<YOUR_VALUE>',
            # Variabel template SMS. Tentukan nilai dalam format JSON. Contoh: {"code":"1234","name":"1234","time":"1234"}.
            template_param='{"code":"1234","name":"1234","time":"1234"}'
        )

Apa yang harus saya lakukan jika operasi API gagal dipanggil dan kesalahan "Tea.exceptions.UnretryableException" dilaporkan?

Periksa apakah wilayah yang Anda tentukan mendukung layanan yang ingin Anda panggil. Dalam contoh ini, SMS digunakan. Anda dapat pergi ke halaman utama SMS di OpenAPI Explorer dan melihat titik akhir SMS di berbagai wilayah. Pastikan Anda menentukan titik akhir yang valid.

Apa yang harus saya lakukan jika pesan kesalahan berikut dikembalikan: File "/usr/local/python3/lib/python3.6/site-packages/alibabacloud_slb20140515/client.py", line 4, in <module> from Tea.core import TeaCore ModuleNotFoundError: Tidak ada modul bernama 'Tea'?

Pesan kesalahan dikembalikan karena versi pip sudah ketinggalan zaman. Dalam hal ini, dependensi yang terpasang tidak lengkap atau dependensi tertentu dihapus. Anda dapat memperbarui pip dan menjalankan perintah pip install <Installation package> untuk memperbaiki kesalahan ini. Misalnya, jalankan perintah pip install alibabacloud-tea untuk memasang modul Tea.

Pertanyaan 13: Apa yang harus saya lakukan jika pesan kesalahan berikut dikembalikan: Command "python setup.py egg_info" gagal dengan kode kesalahan 1 di xxx?

Pesan kesalahan ini dikembalikan karena versi Python atau pip sudah ketinggalan zaman, atau pustaka atau paket yang diperlukan belum terpasang. Akibatnya, SDK tidak dapat bekerja seperti yang diharapkan.

Solusi:

1. Periksa versi SSL/TLS: Pastikan lingkungan Python pada perangkat lokal mendukung versi SSL/TLS yang digunakan server untuk komunikasi. Dalam beberapa kasus, server hanya mendukung TLS 1.2.

   import ssl
   import urllib3
   
   # Buat konteks SSL dan gunakan 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)
   
   # Inisialisasi manajer pool urllib3.
   http = urllib3.PoolManager(context=ssl_context)
   
   # Kirim permintaan.
   response = http.request('GET', 'https://ocr-api.cn-hangzhou.aliyuncs.com/?Country=Vietnam')
   

2. Periksa masalah lingkungan Python:

   1. Pastikan modul ssl dan versi pustaka urllib3 kompatibel dengan versi Python.

   2. Gunakan lingkungan virtual untuk memasang ulang Python dan dependensi Python:

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

3. Periksa kesalahan konfigurasi jaringan.

   1. Pastikan firewall pada perangkat lokal mengizinkan lalu lintas ke port HTTPS (port 443).

   2. Jika proxy digunakan, pastikan konfigurasi proxy benar.

   import requests
   
   # Gunakan 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. Perbarui pustaka requests dan urllib3 untuk menyelesaikan masalah.

   pip install --upgrade requests urllib3

5. Jika masalah tetap ada setelah pembaruan, masalah tersebut mungkin disebabkan oleh sertifikat lingkungan. Konfigurasikan parameter berikut untuk mengabaikan sertifikat dan menyesuaikan periode timeout:

   # Nonaktifkan verifikasi sertifikat.
   runtimeOptions = RuntimeOptions(
    ignore_ssl=True # Nonaktifkan verifikasi sertifikat SSL. Secara default, verifikasi sertifikat SSL diaktifkan.
   )
   
   # Sesuaikan periode timeout.
   runtimeOptions = RuntimeOptions(
       read_timeout=xxx,  # Periode timeout untuk permintaan baca. Unit: milidetik.
       connect_timeout=xxx  # Periode timeout untuk permintaan koneksi. Unit: milidetik.
   )

6. Jika masalah tetap ada setelah verifikasi sertifikat SSL dinonaktifkan, atur variabel lingkungan PYTHONHTTPSVERIFY ke 0 untuk menonaktifkan verifikasi sertifikat SSL.

   export PYTHONHTTPSVERIFY=0  # Nonaktifkan verifikasi HTTPS.

7. Periksa sertifikat SSL pada mesin lokal: Pastikan sertifikat SSL pada mesin lokal sudah diperbarui dan lengkap. Anda dapat menggunakan alat seperti certbot untuk memperbarui dan memasang sertifikat.

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