Skip to main content

Révocation groupée de sièges

Révoquer des sièges de plusieurs membres en une seule fois.

Prérequis

Vous avez obtenu l'AccessKey d'un compte Alibaba Cloud ou d'un utilisateur RAM, et l'identité s'est vu accorder les autorisations RAM nécessaires pour appeler cette opération. Nous vous recommandons de définir l'AccessKey comme variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET plutôt que de le coder en dur.

Description de la requête

  • Méthode HTTP : POST
  • URL de la requête

    Région

    Point de terminaison

    Singapour

    POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-revocations

  • Authentification Cette opération est une opération OpenAPI Alibaba Cloud qui utilise des signatures basées sur AccessKey (l'algorithme ACS3-HMAC-SHA256). Le schéma Authorization: Bearer {API_KEY} n'est pas pris en charge. Une requête doit comporter les en-têtes communs x-acs-action: BatchRevokeSeats, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce et Authorization. Nous vous recommandons d'appeler cette opération avec un SDK Alibaba Cloud ou OpenAPI Explorer afin de ne pas avoir à calculer la signature vous-même.

Paramètres de la requête

Tous les paramètres sont transmis dans la chaîne de requête. La valeur du paramètre tableau Items est une chaîne JSON, par exemple Items=[{"AccountId": "acc_123456789"}]. Encodez l'URL de la valeur lors de l'envoi de la requête.

Paramètre

Type

Obligatoire

Description

Items

Array[Object]

Non

Liste des éléments à révoquer. Ne peut pas être vide.

Items[].AccountId

string

Non

ID du membre actuellement lié.

Locale

string

Non

Informations de locale : zh-CN/en-US.

Paramètres de réponse

Paramètre

Type

Description

Success

boolean

Indique si la requête a réussi.

Code

string

Code d'erreur (vide en cas de succès).

Message

string

Message d'erreur (vide en cas de succès).

Exemple de requête

Cette opération utilise les signatures OpenAPI d'Alibaba Cloud. Dans l'exemple suivant, ${SIGNATURE} doit être calculé avec l'algorithme ACS3-HMAC-SHA256, et x-acs-date ainsi que x-acs-signature-nonce doivent être remplacés par des valeurs réelles.
curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-revocations?Items=%5B%7B%22AccountId%22%3A%22acc_123456789%22%7D%5D&Locale=en-US" \
    --header "x-acs-action: BatchRevokeSeats" \
    --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: ${SIGNATURE_NONCE}" \
    --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}"

Exemple de réponse

{
  "Success": true
}

Codes d'erreur

Si l'appel échoue, un message d'erreur est renvoyé. Pour plus de codes d'erreur et de solutions, consultez Codes d'erreur.