Copy

Prasyarat

Anda telah memperoleh AccessKey dari akun Alibaba Cloud atau pengguna RAM, dan identitas tersebut telah diberikan izin RAM yang diperlukan untuk memanggil operasi ini. Kami menyarankan Anda menetapkan AccessKey sebagai variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET alih-alih meng-hardcode-nya.

Deskripsi permintaan

Metode HTTP: GET
URL Permintaan
Wilayah
Endpoint
Singapura
GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/shared-packages
Autentikasi Operasi ini adalah operasi Alibaba Cloud OpenAPI yang menggunakan tanda tangan berbasis AccessKey (algoritma ACS3-HMAC-SHA256). Skema Authorization: Bearer {API_KEY} tidak didukung. Permintaan harus menyertakan header umum x-acs-action: ListSubscriptionSharedPackages, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce, dan Authorization. Kami menyarankan Anda memanggil operasi ini dengan Alibaba Cloud SDK atau OpenAPI Explorer sehingga Anda tidak perlu menghitung tanda tangan sendiri.

Wilayah	Endpoint
Singapura	`GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/shared-packages`

Parameter permintaan

Semua parameter diteruskan dalam query string. Parameter array (StatusList) menggunakan format Flat: teruskan setiap elemen sebagai ParameterName.N, di mana N dimulai dari 1. Contohnya, StatusList.1=NORMAL dan StatusList.2=<second value>.

Parameter	Tipe	Wajib	Deskripsi
PageNo	integer	Tidak	Nomor halaman paginasi. Nilai default: 1 Rentang nilai: bilangan bulat positif.
PageSize	integer	Tidak	Parameter paginasi: jumlah item yang ditampilkan per halaman, nilai default 10.
StatusList	Array	Tidak	Daftar filter status

Parameter respons

Parameter	Tipe	Deskripsi
Success	boolean	Apakah panggilan API berhasil: true: berhasil false: gagal
Code	string	Kode status respons.
Message	string	Pesan respons.
Data	object	Data bisnis.
Items	Array[Object]	Entri data
	Array[Object]	Entri data
InstanceCode	string	kode instance seat
EquityList	Array[Object]	Instans hak yang berlaku saat ini
	object
EquityType	string	Jenis hak (seperti CREDITS, SPN, paket sumber daya, dll.)
CycleInstanceId	string	Kode hak (kode langganan, tidak perlu dikonsumsi dalam skenario credits)
CycleStartTime	integer	Waktu mulai periode saat ini, dalam milidetik
CycleEndTime	integer	Waktu berakhir periode saat ini, dalam milidetik
CycleTotalValue	angka	Kuota total periode saat ini
CycleSurplusValue	angka	Sisa kuota periode saat ini
CycleVersion	integer	Versi urutan waktu periode saat ini
Status	string	Status kursi: CREATING —— Sedang dibuat NORMAL —— Status aktif LIMIT —— Terbatas karena tunggakan RELEASE —— Dirilis karena kedaluwarsa STOP —— Dihentikan karena kedaluwarsa REFUNDED —— Telah direfund
Total	integer	Jumlah total seat
PageNo	integer	Nomor halaman, nilai lebih besar dari 0 dan tidak melebihi nilai maksimum tipe data Integer, nilai default adalah 1. Nomor halaman, nilai lebih besar dari 0 dan tidak melebihi nilai maksimum tipe data Integer
PageSize	integer	Jumlah item per halaman.

Contoh permintaan

Operasi ini menggunakan tanda tangan Alibaba Cloud OpenAPI. Dalam contoh berikut, ${SIGNATURE} harus dihitung dengan algoritma ACS3-HMAC-SHA256, dan x-acs-date serta x-acs-signature-nonce harus diganti dengan nilai aktual.

curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/shared-packages?PageNo=1&PageSize=10&StatusList.1=NORMAL" \
    --header "x-acs-action: ListSubscriptionSharedPackages" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

Contoh respons

{
  "Success": true,
  "Data": {
    "Items": [
      {
        "InstanceCode": "subs-1234567",
        "EquityList": [
          {
            "EquityType": "CREDITS",
            "CycleInstanceId": "123456",
            "CycleStartTime": 1775232000,
            "CycleEndTime": 1756310400,
            "CycleTotalValue": 100,
            "CycleSurplusValue": 40,
            "CycleVersion": 1
          }
        ],
        "Status": "NORMAL"
      }
    ],
    "Total": 100,
    "PageNo": 1,
    "PageSize": 10
  }
}

Kode kesalahan

Jika pemanggilan gagal, pesan kesalahan akan dikembalikan. Untuk kode kesalahan dan solusi selengkapnya, lihat Kode kesalahan.

​Prasyarat

​Deskripsi permintaan

​Parameter permintaan

​Parameter respons

​Contoh permintaan

​Contoh respons