Alibaba Cloud Model Studio:Ajouter des sièges

Ajoutez des sièges à un abonnement existant.

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 BssOpenApi. 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.

Vous disposez d'un abonnement de sièges Token Plan édition équipe valide et vous avez obtenu ProductCode, ProductType et SubscriptionType en appelant QueryProductList.

Description de la requête

• Méthode HTTP：POST

• URL de la requête

  Région	Endpoint
  Singapour	POST https://business.ap-southeast-1.aliyuncs.com/

• Authentification

  Cette opération appartient à BssOpenApi (version 2023-09-30) et utilise des signatures RPC AccessKey (HMAC-SHA1). Le schéma Authorization: Bearer {API_KEY} n'est pas pris en charge. Nous vous recommandons de l'appeler avec la classe CommonRequest d'un SDK Alibaba Cloud. Le SDK génère les paramètres communs et calcule la signature automatiquement.

Paramètres de la requête

Tous les paramètres sont transmis sous forme de données de formulaire ou dans la chaîne de requête. Les paramètres de tableau utilisent le format Flat : Configs.1.Code et Configs.1.Value, l'index commençant à 1.

Paramètre	Type	Obligatoire	Description
ProductCode	string	Oui	Code produit. Obtenez-le en appelant QueryProductList. Exemple : sfm.
ProductType	string	Oui	Type de produit. Obtenez-le en appelant QueryProductList. Exemple : sfm_tokenplanteams_dp_intl.
SubscriptionType	string	Oui	Type d'abonnement. Obtenez-le en appelant QueryProductList. Exemple : Subscription.
ClientToken	string	Oui	Jeton d'idempotence. Générez-le côté client et rendez-le unique entre les requêtes. Longueur maximale : 64 caractères ASCII.
Seats	long	Oui	Nombre de sièges à ajouter. Valeur minimale : 1.
Configs	Array	Oui	Propriétés du module.
Configs.N.Code	string	Non	Code de la propriété du module. Exemple : plan_type.
Configs.N.Value	string	Non	Valeur de la propriété du module. Exemples : standard, pro et max.

Paramètres de réponse

Paramètre	Type	Description
RequestId	string	ID de la requête.
Success	boolean	Indique si la requête a réussi.
Code	string	Code de résultat. La valeur est Success lorsque la requête réussit.
Message	string	Message de résultat.
Data	object	Données métier.
Data.OrderId	long	ID de commande.
Data.InstanceId	Array[string]	ID d'instance.
Data.HostId	string	Identifiant du site. Ce champ peut être omis dans certaines réponses.
AccessDeniedDetail	string	Informations détaillées sur l'erreur renvoyées lorsque les autorisations RAM sont refusées.

Exemple de requête

Cette opération utilise les signatures RPC de BssOpenApi. Dans l'exemple suivant, ${SIGNATURE} doit être calculé avec l'algorithme de signature, et SignatureNonce et Timestamp doivent être remplacés par des valeurs réelles. Un SDK Alibaba Cloud gère automatiquement les paramètres communs et la signature.

curl -X POST "https://business.ap-southeast-1.aliyuncs.com/" \
    --data-urlencode "Action=AddCreditSeats" \
    --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 "Seats=1" \
    --data-urlencode "Configs.1.Code=plan_type" \
    --data-urlencode "Configs.1.Value=standard"

Exemple de réponse

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "OrderId": 1234567890123457,
    "InstanceId": [
      "subs-example0000000002"
    ]
  }
}

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 BssOpenApi.