Skip to main content

Perpanjang Seat

Perpanjang langganan seat secara keseluruhan.

Prasyarat

Anda telah memperoleh AccessKey dari akun Alibaba Cloud atau pengguna RAM, dan identitas tersebut telah diberikan izin RAM yang diperlukan untuk memanggil BssOpenApi. Kami menyarankan Anda menetapkan AccessKey sebagai variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET alih-alih meng-hardcode-nya. Anda memiliki langganan seat Token Plan edisi tim yang valid, dan telah memperoleh ProductCode, ProductType, dan SubscriptionType dengan memanggil QueryProductList.

Deskripsi permintaan

  • Metode HTTP:POST
  • URL permintaan

    Wilayah

    Endpoint

    Singapura

    POST https://business.ap-southeast-1.aliyuncs.com/

  • Autentikasi Operasi ini termasuk dalam BssOpenApi (versi 2023-09-30) dan menggunakan tanda tangan RPC AccessKey (HMAC-SHA1). Skema Authorization: Bearer {API_KEY} tidak didukung. Kami menyarankan Anda memanggil operasi ini dengan kelas CommonRequest dari SDK Alibaba Cloud. SDK akan membuat parameter umum dan menghitung tanda tangan secara otomatis.

Parameter permintaan

Semua parameter dikirim sebagai data formulir atau dalam string kueri. Parameter array menggunakan format Flat: Configs.1.Code dan Configs.1.Value, dengan indeks dimulai dari 1.

Parameter

Tipe

Wajib

Deskripsi

ProductCode

string

Ya

Kode produk. Dapatkan dengan memanggil QueryProductList. Contoh: sfm.

ProductType

string

Ya

Tipe produk. Dapatkan dengan memanggil QueryProductList. Contoh: sfm_tokenplanteams_dp_intl.

SubscriptionType

string

Ya

Tipe langganan. Dapatkan dengan memanggil QueryProductList. Contoh: Subscription.

ClientToken

string

Ya

Token idempotensi. Buat di klien dan pastikan unik di antara permintaan. Panjang maksimum: 64 karakter ASCII.

Period

integer

Ya

Periode langganan. Nilai minimum: 1.

PeriodUnit

string

Ya

Unit periode. Nilai yang valid: Year dan Month.

AutoRenew

boolean

Tidak

Menentukan apakah perpanjangan otomatis diaktifkan.

Parameter respons

Parameter

Tipe

Deskripsi

RequestId

string

ID permintaan.

Success

boolean

Menentukan apakah permintaan berhasil.

Code

string

Kode hasil. Nilainya Success saat permintaan berhasil.

Message

string

Pesan hasil.

Data

object

Data bisnis.

Data.OrderId

long

ID pesanan.

Data.HostId

string

Pengenal situs. Kolom ini mungkin tidak dikembalikan pada beberapa respons.

AccessDeniedDetail

string

Informasi kesalahan terperinci yang dikembalikan saat izin RAM ditolak.

Contoh permintaan

Operasi ini menggunakan tanda tangan RPC BssOpenApi. Dalam contoh berikut, ${SIGNATURE} harus dihitung dengan algoritma tanda tangan, dan SignatureNonce serta Timestamp harus diganti dengan nilai sebenarnya. SDK Alibaba Cloud menangani parameter umum dan tanda tangan secara otomatis.
curl -X POST "https://business.ap-southeast-1.aliyuncs.com/" \
    --data-urlencode "Action=RenewCreditSeat" \
    --data-urlencode "Version=2023-09-30" \
    --data-urlencode "Format=JSON" \
    --data-urlencode "AccessKeyId=${ALIBABA_CLOUD_ACCESS_KEY_ID}" \
    --data-urlencode "SignatureMethod=HMAC-SHA1" \
    --data-urlencode "SignatureVersion=1.0" \
    --data-urlencode "SignatureNonce=${SIGNATURE_NONCE}" \
    --data-urlencode "Timestamp=2026-01-01T12:00:00Z" \
    --data-urlencode "Signature=${SIGNATURE}" \
    --data-urlencode "ProductCode=sfm" \
    --data-urlencode "ProductType=sfm_tokenplanteams_dp_intl" \
    --data-urlencode "SubscriptionType=Subscription" \
    --data-urlencode "ClientToken=example-client-token-001" \
    --data-urlencode "Period=1" \
    --data-urlencode "PeriodUnit=Month" \
    --data-urlencode "AutoRenew=false"

Contoh respons

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "OrderId": 1234567890123459
  }
}

Kode kesalahan

Kode kesalahan umum untuk perpanjangan: INSTANCE_HOLDING_LIMIT_EXCEEDED, MissingParameter, dan ResourceNotExists. Jika panggilan gagal, pesan kesalahan akan dikembalikan. Untuk kode kesalahan dan solusi selengkapnya, lihat Kode kesalahan BssOpenApi.