All Products
Search
Document Center

Intelligent Media Management:Contoh integrasi OpenAPI

Last Updated:May 01, 2026

Topik ini menyediakan contoh lengkap penggunaan OpenAPI untuk membuat proyek Intelligent Media Management (IMM).

Dokumentasi OpenAPI

Baca ikhtisar API untuk menemukan OpenAPI guna membuat proyek Intelligent Media Management: CreateProject. Tinjau dokumentasi API untuk memahami parameter yang diperlukan dan izin yang dibutuhkan.

Identitas pengguna dan izin

Identitas

  • Anda dapat memanggil operasi API ini menggunakan Akun Alibaba Cloud, sebagai RAM user, atau dengan mengasumsikan RAM role. Untuk informasi lebih lanjut mengenai perbedaan antara identitas tersebut, lihat Identitas, kredensial, dan otorisasi. Contoh ini menggunakan RAM user untuk memanggil API. Masuk ke Resource Access Management (RAM), buat RAM user yang hanya mengizinkan pemanggilan API, lalu catat pasangan AccessKey. Untuk detail lebih lanjut, lihat Buat RAM user.

Otorisasi

  1. Buka Users, lalu pada kolom Actions untuk RAM user yang dituju, klik Add Permissions.

  2. Pada panel Add Permissions, pilih AliyunIMMFullAccess dan AliyunSTSAssumeRoleAccess.

    Catatan
  3. Klik Grant permissions.

Kredensial akses

  • Kredensial akses temporary: Untuk skenario yang memerlukan keamanan lebih tinggi, seperti memberikan otorisasi sementara kepada aplikasi untuk mengakses OSS, gunakan kredensial akses temporary. Kredensial akses temporary membatasi durasi validitas kredensial, sehingga mengurangi risiko kebocoran kredensial. Kredensial ini juga mendukung kontrol izin, yang membantu menghindari pemberian izin berlebihan. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses (Go SDK V1).

  • Kredensial akses jangka panjang: Untuk alasan keamanan, jangan gunakan kredensial akses jangka panjang. Gunakan kredensial akses temporary sebagai gantinya. Untuk skenario yang memerlukan kenyamanan, kredensial akses jangka panjang menghindari refresh berulang dalam periode yang lebih lama. Rotasi kredensial akses jangka panjang Anda setiap tiga bulan untuk meningkatkan keamanan akun. Jika kredensial akses jangka panjang bocor atau tidak lagi diperlukan, segera hapus atau nonaktifkan untuk mengurangi risiko keamanan. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses (Go SDK V1).

AccessKey jangka panjang

  1. AccessKey dapat dihasilkan saat Anda membuat RAM user.

  2. Klik nama RAM user yang dituju untuk membuka halaman detail pengguna. Pada tab Authentication, klik Create AccessKey. Untuk langkah-langkah detail, lihat Buat AccessKey.

Kredensial temporary STS

Penting

Anda hanya dapat memanggil operasi ini sebagai RAM user atau dengan mengasumsikan RAM role, bukan dengan Akun Alibaba Cloud.

  1. Buat RAM user.

    Untuk informasi lebih lanjut, lihat Buat RAM user.

  2. Berikan izin AliyunSTSAssumeRoleAccess kepada RAM user tersebut.

    Untuk informasi lebih lanjut, lihat Berikan izin kepada RAM user.

  3. Sebagai RAM user, panggil operasi AssumeRole dari Security Token Service (STS) untuk mendapatkan kredensial akses temporary.

    Untuk informasi lebih lanjut, lihat AssumeRole.

Catatan

Menggunakan token STS untuk pemanggilan API lebih aman daripada menggunakan AccessKey karena melindungi AccessKey jangka panjang Anda dari paparan. Jika Anda perlu melakukan beberapa pemanggilan temporary ke IMM, Anda harus merefresh token STS secara manual.

Panggil OpenAPI

Artikel ini menunjukkan cara memanggil OpenAPI menggunakan Python SDK. Penggunaan SDK untuk bahasa lain serupa. Untuk informasi lebih lanjut, lihat .

Siapkan lingkungan Python

Unduh dan instal Python 3.

Catatan

Untuk memeriksa versi Python Anda, buka terminal dan masukkan python --version.

Konfigurasikan variabel lingkungan AccessKey

Bagian ini menggunakan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET sebagai contoh. Anda dapat mengganti nama variabel sesuai kebutuhan, misalnya OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET.

Penting

Pasangan AccessKey dari Akun Alibaba Cloud memiliki izin atas semua operasi API. Gunakan pasangan AccessKey dari RAM user untuk memanggil operasi API atau melakukan O&M rutin. Jangan simpan kredensial secara langsung di kode aplikasi Anda atau commit ke kontrol versi.

Tetapkan AccessKey Alibaba Cloud dalam variabel lingkungan di Linux dan macOS

Bagian ini menggunakan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET sebagai contoh. Anda dapat mengganti nama variabel sesuai kebutuhan, misalnya OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET.

Konfigurasikan variabel lingkungan menggunakan perintah export

Penting

Variabel lingkungan temporary yang ditetapkan menggunakan perintah export hanya berlaku untuk sesi saat ini. Variabel akan dihapus ketika sesi berakhir. Untuk penyimpanan jangka panjang (LTR), tambahkan perintah export ke file konfigurasi startup sistem operasi Anda.

  • Konfigurasikan ID AccessKey dan tekan Enter.

    # Ganti yourAccessKeyID dengan ID AccessKey Anda.
    export ALIBABA_CLOUD_ACCESS_KEY_ID=yourAccessKeyID
  • Konfigurasikan rahasia AccessKey dan tekan Enter.

    # Ganti yourAccessKeySecret dengan rahasia AccessKey Anda.
    export ALIBABA_CLOUD_ACCESS_KEY_SECRET=yourAccessKeySecret
  • Verifikasi konfigurasi.

    Jalankan perintah echo $ALIBABA_CLOUD_ACCESS_KEY_ID. Jika perintah mengembalikan ID AccessKey yang benar, konfigurasi berhasil.

Tetapkan AccessKey Alibaba Cloud dalam variabel lingkungan di Windows

Bagian ini menggunakan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET sebagai contoh. Anda dapat mengganti nama variabel sesuai kebutuhan, misalnya OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET.

Gunakan antarmuka pengguna grafis (GUI)

  • Prosedur

    Langkah-langkah berikut menjelaskan cara menetapkan variabel lingkungan menggunakan GUI di Windows 10.

    Di desktop Anda, klik kanan This PC dan pilih Properties > Advanced system settings > Environment Variables > New di bawah System variables atau User variables. Lalu, lengkapi konfigurasi.

    Variabel

    Nilai contoh

    AccessKey ID

    • Nama variabel: ALIBABA_CLOUD_ACCESS_KEY_ID

    • Nilai variabel: yourAccessKeyID

    AccessKey Secret

    • Nama variabel: ALIBABA_CLOUD_ACCESS_KEY_SECRET

    • Nilai variabel: yourAccessKeySecret

  • Uji konfigurasi

    Klik Start (atau gunakan pintasan keyboard Win+R), klik Run, masukkan `cmd`, lalu klik OK (atau tekan Enter) untuk membuka command prompt. Jalankan perintah echo %ALIBABA_CLOUD_ACCESS_KEY_ID% dan echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%. Jika perintah mengembalikan AccessKey yang benar, konfigurasi berhasil.

Gunakan command prompt (CMD)

  • Prosedur

    Buka command prompt sebagai administrator dan jalankan perintah berikut untuk menambahkan variabel lingkungan baru ke sistem.

    setx ALIBABA_CLOUD_ACCESS_KEY_ID yourAccessKeyID /M
    setx ALIBABA_CLOUD_ACCESS_KEY_SECRET yourAccessKeySecret /M

    Parameter /M menunjukkan variabel lingkungan sistem. Anda dapat menghilangkan parameter ini saat menetapkan variabel lingkungan pengguna.

  • Uji konfigurasi

    Klik Start (atau gunakan pintasan keyboard Win+R), klik Run, masukkan `cmd`, lalu klik OK (atau tekan Enter) untuk membuka command prompt. Jalankan perintah echo %ALIBABA_CLOUD_ACCESS_KEY_ID% dan echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%. Jika perintah mengembalikan AccessKey yang benar, konfigurasi berhasil.

Menggunakan Windows PowerShell

Di PowerShell, Anda dapat menetapkan variabel lingkungan baru yang berlaku untuk semua sesi baru:

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'yourAccessKeySecret', [System.EnvironmentVariableTarget]::User)

Untuk menetapkan variabel lingkungan bagi semua pengguna, Anda harus memiliki izin administratif:

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'yourAccessKeySecret', [System.EnvironmentVariableTarget]::Machine)

Anda dapat menetapkan variabel lingkungan temporary yang hanya berlaku untuk sesi saat ini:

$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "yourAccessKeyID"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "yourAccessKeySecret"

Di PowerShell, jalankan perintah Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID dan Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET. Jika perintah mengembalikan AccessKey yang benar, konfigurasi berhasil.

Penting

Setelah Anda mengonfigurasi variabel lingkungan, Anda mungkin perlu me-restart alat pengembangan Anda, seperti integrated development environments (IDEs), atau layanan agar pengaturan baru berlaku.

Konfigurasikan variabel lingkungan token Security Token Service (STS)

Mac OS X/Linux/Unix

export IMM_ACCESS_KEY_ID=<ALIBABA_CLOUD_ACCESS_KEY_ID>
export IMM_ACCESS_KEY_SECRET=<ALIBABA_CLOUD_ACCESS_KEY_SECRET>
export IMM_SESSION_TOKEN=<ALIBABA_CLOUD_SECURITY_TOKEN>

Windows

set IMM_ACCESS_KEY_ID <ALIBABA_CLOUD_ACCESS_KEY_ID>
set IMM_ACCESS_KEY_SECRET <ALIBABA_CLOUD_ACCESS_KEY_SECRET>
set IMM_SESSION_TOKEN <ALIBABA_CLOUD_SECURITY_TOKEN>

Unduh kode contoh dan instal dependensi


pip install alibabacloud_credentials

Pada tab Parameter Configuration, masukkan informasi parameter yang diperlukan, seperti projectName untuk proyek yang ingin Anda buat.

pip install alibabacloud_tea_console

Ekstrak paket kode contoh secara lokal dan masuk ke direktori alibabacloud_sample.

Jalankan kode contoh

Jalankan perintah berikut di terminal Anda.

python sample.py

Output berikut dikembalikan.

{
    "headers":{
        "date":"Thu, 10 Aug 2023 06:34:51 GMT",
        "content-type":"application/json;charset=utf-8",
        "content-length":"602",
        "connection":"keep-alive",
        "keep-alive":"timeout=25",
        "access-control-allow-origin":"*",
        "access-control-expose-headers":"*",
        "x-acs-request-id":"2C489857-69E6-5974-B963-A7DF99EFFF43",
        "x-acs-trace-id":"eccc35df82a086e7bb4f4fe778f****",
        "etag":"6HYADxT6iVDNgQUq+wGO****"
    },
    "statusCode":200,
    "body":{
        "Project":{
            "CreateTime":"2023-08-10T14:34:51.586696893+08:00",
            "DatasetCount":0,
            "DatasetMaxBindCount":10,
            "DatasetMaxEntityCount":10000000000,
            "DatasetMaxFileCount":100000000,
            "DatasetMaxRelationCount":100000000000,
            "DatasetMaxTotalFileSize":90000000000000000,
            "Description":"",
            "EngineConcurrency":200,
            "FileCount":0,
            "ProjectMaxDatasetCount":1000000000,
            "ProjectName":"testproject",
            "ProjectQueriesPerSecond":200,
            "ServiceRole":"AliyunIMMDefaultRole",
            "TemplateId":"Official:DefaultEmptyId",
            "TotalFileSize":0,
            "UpdateTime":"2023-08-10T14:34:51.586696977+08:00"
        },
        "RequestId":"2C489857-69E6-5974-B963-A7DF99EFFF43"
    }
}