Alibaba Cloud SDK:Integrasikan SDK

Persyaratan lingkungan

Python 3.7 atau versi yang lebih baru.

1. Masuk ke SDK Center dan pilih produk yang API-nya ingin Anda panggil, seperti Short Message Service (SMS).

2. Pada halaman Installation, dan untuk All Languages, pilih Python. Lalu, pada tab Quick Start, Anda dapat menemukan metode instalasi SDK untuk Short Message Service (SMS).

Skenario khusus: Konfigurasi API Advance untuk unggah file

Beberapa produk cloud (seperti Image Search dan Visual Intelligence API) tidak mendukung unggah file langsung melalui OpenAPI standar. Gunakan API Advance untuk meneruskan aliran file. File tersebut disimpan sementara di OSS (wilayah default: cn-shanghai), lalu dibaca oleh produk tersebut. Contoh berikut menggunakan API DetectBodyCount dari Alibaba Cloud Visual Intelligence API (Face and Body):

1. 1. Inisialisasi klien permintaan

   Atur baik region_id maupun endpoint produk. region_id menentukan wilayah OSS untuk penyimpanan file sementara. Jika region_id tidak sesuai dengan wilayah produk, timeout dapat terjadi.

   def create_client() -> facebody20191230Client:
       config = open_api_models.Config(
           # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah diatur di lingkungan eksekusi kode Anda.
           access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
           # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur di lingkungan eksekusi kode Anda.
           access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
       )
       # Titik akhir dan regionId harus diatur ke wilayah yang sama.
       config.region_id = 'cn-shanghai'
       config.endpoint = 'facebody.cn-shanghai.aliyuncs.com'
       return facebody20191230Client(config)

2. Buat objek permintaan

   Buat objek <NamaOpenAPI>AdvanceRequest dan teruskan aliran file sebagai ImageURLObject.

   # Buka file sebagai aliran biner.
   with open('<FILE_PATH>', "rb") as f:  # Ganti dengan path file Anda.
        # Atur parameter permintaan.
        detect_body_count_advance_request = facebody_20191230_models.DetectBodyCountAdvanceRequest(
                  image_urlobject = f,
        )

3. Kirim permintaan

   Panggil <namaApi>Advance untuk mengirim permintaan, di mana <namaApi> adalah nama OpenAPI dalam format lower camelCase.

   # Konfigurasi runtime.
   runtime = util_models.RuntimeOptions()
   client = create_client()
   # Kirim permintaan.
   res = client.detect_body_count_advance(detect_body_count_advance_request, runtime)

import os

from alibabacloud_facebody20191230 import models as facebody_20191230_models
from alibabacloud_facebody20191230.client import Client as facebody20191230Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_tea_util import models as util_models


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> facebody20191230Client:
        config = open_api_models.Config(
            # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah diatur di lingkungan eksekusi kode Anda.
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur di lingkungan eksekusi kode Anda.
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )
        config.region_id = 'cn-shanghai'
        return facebody20191230Client(config)

    @staticmethod
    def main() -> None:
        client = Sample.create_client()
        # Buka file sebagai aliran biner.
        with open('<FILE_PATH>', "rb") as f:  # Ganti <FILE_PATH> dengan path file Anda.
            # Atur parameter permintaan.
            detect_body_count_advance_request = facebody_20191230_models.DetectBodyCountAdvanceRequest(
                image_urlobject=f,
            )
            runtime = util_models.RuntimeOptions()
            try:
                # Kirim permintaan.
                res = client.detect_body_count_advance(detect_body_count_advance_request, runtime)
                print(res)
            except Exception as error:
                # Ini hanya untuk pencetakan dan demonstrasi. Tangani pengecualian dengan hati-hati dan jangan mengabaikannya dalam proyek Anda.
                print(error)


if __name__ == '__main__':
    Sample.main()

FAQ

1. Pemanggilan OpenAPI menghasilkan kesalahan "You are not authorized to perform this operation".

   Penyebab dan solusi

   Penyebab: Pengguna RAM yang terkait dengan AccessKey Anda tidak memiliki izin untuk memanggil API ini.

   Solusi: Berikan izin OpenAPI yang diperlukan kepada pengguna RAM. Kelola izin pengguna RAM.

   Sebagai contoh, jika pemanggilan operasi atau SendMessageToGlobe menghasilkan kesalahan ini, buat kebijakan izin kustom seperti berikut dan sambungkan ke pengguna RAM.

   {
     "Version": "1",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": "dysms:SendMessageToGlobe",
         "Resource": "*"
       }
     ]
   }

2. Pemanggilan OpenAPI menghasilkan kesalahan "SDK.EndpointResolvingError" terkait Titik Akhir.

   Penyebab dan solusi

   Penyebab: Titik akhir yang ditentukan tidak didukung oleh API ini.

   Solusi: Perbarui titik akhir ke nilai yang didukung dan coba lagi. Konfigurasi titik akhir.

3. Pemanggilan OpenAPI menghasilkan kesalahan `AttributeError: 'AttributeError' object has no attribute 'message'` atau `KeyError: 'ALIBABA_CLOUD_ACCESS_KEY_ID'` terkait AccessKey.

   Penyebab dan solusi

   Penyebab: AccessKey Anda tidak diteruskan dengan benar.

   Solusi: Verifikasi bahwa AccessKey diteruskan dengan benar saat menginisialisasi klien. os.environ("XXX") membaca nilai XXX dari variabel lingkungan.

Solusi kesalahan SDK tambahan: FAQ.