Créez un ou plusieurs sièges Token Plan édition équipe.
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 avez obtenu ProductCode, ProductType et SubscriptionType en appelant QueryProductList. Pour Token Plan édition équipe, les valeurs d'exemple sont sfm, sfm_tokenplanteams_dp_intl et Subscription.
Description de la requête
-
Méthode HTTP:POST
-
URL de la requête
Région
Endpoint
Singapour
-
Authentification
Cette opération appartient à BssOpenApi (version
2023-09-30) et utilise des signatures RPC AccessKey (HMAC-SHA1). Le schémaAuthorization: Bearer {API_KEY}n'est pas pris en charge. Nous vous recommandons de l'appeler avec la classeCommonRequestd'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 |
ProductType | string | Oui | Type de produit. Obtenez-le en appelant |
SubscriptionType | string | Oui | Type d'abonnement. Obtenez-le en appelant |
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. |
Period | integer | Oui | Période d'abonnement. Valeur minimale : 1. |
PeriodUnit | string | Oui | Unité de la période. Valeurs valides : |
AutoRenew | boolean | Non | Indique si le renouvellement automatique est activé. |
SubscriptionConfigs | Array | Oui | Liste des spécifications d'abonnement. Vous pouvez créer plusieurs spécifications en une seule requête. |
SubscriptionConfigs.N.Seats | long | Oui | Nombre de sièges. Valeur minimale : 1. |
SubscriptionConfigs.N.Configs | Array | Oui | Propriétés du module. |
SubscriptionConfigs.N.Configs.N.Code | string | Non | Code de la propriété du module. Exemple : |
SubscriptionConfigs.N.Configs.N.Value | string | Non | Valeur de la propriété du module. Exemples : |
RemarqueCode et Value dans Configs doivent être spécifiés par paire. Les valeurs prises en charge dépendent du produit.
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 |
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=CreateCreditSeat" \
--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" \
--data-urlencode "SubscriptionConfigs.1.Seats=1" \
--data-urlencode "SubscriptionConfigs.1.Configs.1.Code=plan_type" \
--data-urlencode "SubscriptionConfigs.1.Configs.1.Value=standard"
Exemple de réponse
{
"RequestId": "request-id-example",
"Success": true,
"Code": "Success",
"Message": "Successful!",
"Data": {
"OrderId": 1234567890123456,
"InstanceId": [
"subs-example0000000001"
]
}
}
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.