Alibaba Cloud SDK：Integrasi dengan Alibaba Cloud SDK V2.0 untuk Python

Prasyarat

Python 3.7 atau yang lebih baru telah diinstal.

1. Masuk ke SDK Center dan pilih layanan yang SDK-nya ingin Anda gunakan. Dalam contoh ini, Short Message Service (SMS) dipilih.

2. Pada halaman Short Message Service, pilih Python di bagian All languages. Pada tab Quick Start, dapatkan metode instalasi Short Message Service (SMS) SDK.

Skenario khusus: Unggah file melalui operasi Advance

Saat Anda menggunakan Image Search atau Visual Intelligence API (VIAPI) untuk memproses gambar pada mesin lokal atau mengunggah gambar, API dari Image Search atau VIAPI yang dijelaskan dalam dokumentasi tidak mendukung pengunggahan langsung. Untuk mengunggah gambar, Anda perlu menggunakan operasi Advance, yang mendukung transmisi aliran file. Layanan cloud menyimpan sementara file yang diunggah di Object Storage Service (OSS), dan membaca file sementara dari OSS jika diperlukan. Wilayah OSS default adalah cn-shanghai. Contoh berikut menunjukkan cara memanggil operasi DetectBodyCount dari VIAPI:

1. Inisialisasi Klien Permintaan

   Pastikan bahwa parameter region_id dan endpoint layanan cloud telah ditentukan. region_id menunjukkan wilayah OSS tempat file sementara disimpan. Jika Anda tidak mengonfigurasi parameter region_id, layanan cloud mungkin menggunakan wilayah yang berbeda dari OSS, yang mengakibatkan timeout API.

   def create_client() -> facebody20191230Client:
       config = open_api_models.Config(
           # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah ditentukan dalam kode.,
           access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
           # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah dikonfigurasi.,
           access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
       )
       # Tentukan wilayah yang sama untuk parameter endpoint dan regionId.
       config.region_id = 'cn-shanghai'
       config.endpoint = 'facebody.cn-shanghai.aliyuncs.com'
       return facebody20191230Client(config)

2. Buat Objek Permintaan

   Buat objek permintaan <Operasi API>AdvanceRequest untuk melewati aliran file. Dalam objek permintaan, atur nama parameter menjadi ImageURLObject.

   # Buka file biner.
   with open('<FILE_PATH>', "rb") as f:  # Ganti jalur file.
        # Tentukan parameter permintaan.
        detect_body_count_advance_request = facebody_20191230_models.DetectBodyCountAdvanceRequest(
                  image_urlobject = f,
        )

3. Ajukan Permintaan

   Panggil fungsi <Nama Operasi API>Advance untuk mengajukan permintaan. Tentukan <Nama Operasi API> dalam camel case.

   /# Konfigurasikan parameter runtime.
   runtime = util_models.RuntimeOptions()
   client = create_client()
   # Ajukan 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 ditentukan dalam kode.,
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah dikonfigurasi.,
            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 biner.
        with open('<FILE_PATH>', "rb") as f:  # Ganti jalur file di <FILE_PATH>.
            # Tentukan parameter permintaan.
            detect_body_count_advance_request = facebody_20191230_models.DetectBodyCountAdvanceRequest(
                image_urlobject=f,
            )
            runtime = util_models.RuntimeOptions()
            try:
                # Ajukan permintaan.
                res = client.detect_body_count_advance(detect_body_count_advance_request, runtime)
                print(res)
            except Exception as error:
                # Tangani pengecualian dengan hati-hati berdasarkan skenario bisnis aktual Anda dan jangan abaikan pengecualian dalam proyek Anda. Pesan kesalahan yang ditampilkan dalam contoh ini hanya untuk referensi.
                print(error)


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

FAQ

1. Bagaimana cara menangani kesalahan "Anda tidak memiliki izin untuk melakukan operasi ini" yang dilempar oleh operasi API?

   Penyebab dan Solusi yang Mungkin

   Penyebab yang Mungkin: Pasangan AccessKey dari pengguna Resource Access Management (RAM) tidak memiliki izin untuk memanggil operasi API.

   Solusi: Berikan izin yang diperlukan kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Berikan Izin kepada Pengguna RAM.

   Sebagai contoh, jika kesalahan "Anda tidak memiliki izin untuk melakukan operasi ini" dilempar oleh operasi API SendMessageToGlobe, buat kebijakan kustom berikut untuk memberikan izin yang diperlukan kepada pengguna RAM:

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

2. Bagaimana cara menangani kesalahan titik akhir "SDK.EndpointResolvingError" yang dilempar oleh operasi API?

   Penyebab dan Solusi yang Mungkin

   Penyebab yang Mungkin: Operasi API tidak mendukung titik akhir yang Anda tentukan saat menginisialisasi klien permintaan.

   Solusi: Tentukan titik akhir yang didukung dan coba lagi. Untuk informasi lebih lanjut, lihat Konfigurasikan Titik Akhir.

3. Bagaimana cara menangani AttributeError: "Objek 'AttributeError' tidak memiliki atribut 'message'" atau "KeyError: 'ALIBABA_CLOUD_ACCESS_KEY_ID'" kesalahan AccessKey?

   Penyebab dan Solusi yang Mungkin

   Penyebab yang Mungkin: Pasangan AccessKey tidak diteruskan dengan benar ke permintaan.

   Solusi: Pastikan pasangan AccessKey diteruskan dengan benar saat Anda menginisialisasi klien permintaan. Nilai XXX dari os.environ("XXX") diperoleh dari variabel lingkungan.

Untuk informasi lebih lanjut tentang cara menangani kesalahan SDK, lihat FAQ.