Obtenir les détails des sièges d'abonnement - Alibaba Cloud Model Studio

Requête paginée des détails des sièges d'abonnement.

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 : GET
URL de la requête
Région
Point de terminaison
Singapour
GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail
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: GetSubscriptionSeatDetails, 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.

Région	Point de terminaison
Singapour	`GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail`

Paramètres de la requête

Tous les paramètres sont transmis dans la chaîne de requête. Les paramètres de tableau (StatusList) utilisent le format Flat : transmettre chaque élément sous la forme ParameterName.N, où N commence à 1. Par exemple, StatusList.1=NORMAL et StatusList.2=<second value>.

Paramètre	Type	Obligatoire	Description
PageNo	integer	Non	Numéro de page. Valeur par défaut : 1 Plage de valeurs : entier positif.
PageSize	integer	Non	Paramètre de pagination : nombre d'éléments affichés par page, valeur par défaut 10.
StatusList	Array	Non	Liste de filtrage des statuts de siège
SeatId	string	Non	ID du siège
SeatType	string	Non	Type de siège (specType) standard - Standard seat pro - Pro seat max - Max seat
QueryAssigned	boolean	Non	Filtre de statut d'attribution des sièges. true=Attribué, false=Non attribué, null=Tous

Paramètres de réponse

Paramètre	Type	Description
Success	boolean	Indique si l'appel API a réussi : true : succès false : échec
Code	string	Code d'état de la réponse.
Message	string	Message de réponse.
Data	object	Données métier.
Items	Array[Object]	Élément de données
	Array[Object]	Élément de données
InstanceCode	string	Code d'instance du siège
EquityList	Array[Object]	Instances d'avantages actuellement actives ; pour le produit TokenPlan, cette liste ne contient qu'une seule instance d'avantage active
	object
EquityType	string	Type d'avantage (tel que CREDITS, SPN, pack de ressources, etc.)
CycleInstanceId	string	Code d'avantage (code d'abonnement, aucune consommation requise dans le scénario credits)
CycleStartTime	integer	Heure de début du cycle actuel, en millisecondes
CycleEndTime	integer	Heure de fin du cycle actuel, en millisecondes
CycleTotalValue	nombre	Quota total du cycle actuel
CycleSurplusValue	nombre	Quota restant du cycle actuel
CycleVersion	integer	Version chronologique du cycle actuel
EndTime	integer	Heure d'expiration du siège
SeatId	string	ID du siège
SpecType	string	Type de siège. standard - Siège standard pro - Siège pro max - Siège max
StartTime	integer	Heure de début du siège
AssignedStatus	string	Statut d'attribution ASSIGNED UNASSIGNED
AccountId	string	ID du compte membre lié
AccountName	string	Nom du compte membre
AccountEmail	string	E-mail du compte membre
Status	string	Statut du siège : CREATING —— En cours de création NORMAL —— Statut actif LIMIT —— Restreint pour impayé RELEASE —— Libéré à l'expiration STOP —— Arrêté à l'expiration REFUNDED —— Remboursé
Total	integer	Nombre total de sièges
PageNo	integer	Numéro de page, valeur supérieure à 0 et ne dépassant pas la valeur maximale du type de données Integer
PageSize	integer	Nombre d'éléments par page.

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 GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail?PageNo=1&PageSize=10&StatusList.1=NORMAL&SeatId=seat-123456&SeatType=standard&QueryAssigned=true" \
    --header "x-acs-action: GetSubscriptionSeatDetails" \
    --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,
  "Data": {
    "Items": [
      {
        "InstanceCode": "subs-1234567",
        "EquityList": [
          {
            "EquityType": "CREDITS",
            "CycleInstanceId": "123456",
            "CycleStartTime": 1788328800000,
            "CycleEndTime": 1790920800000,
            "CycleTotalValue": 100,
            "CycleSurplusValue": 40,
            "CycleVersion": 1
          }
        ],
        "EndTime": 1790920800000,
        "SeatId": "seat_123456",
        "SpecType": "standard",
        "StartTime": 1788328800000,
        "AssignedStatus": "ASSIGNED",
        "AccountId": "acc_123456789",
        "AccountName": "ExampleName",
        "AccountEmail": "test@email.com",
        "Status": "NORMAL"
      }
    ],
    "Total": 100,
    "PageNo": 1,
    "PageSize": 10
  }
}

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.