Alibaba Cloud Model Studio:Lister les packages partagés

Requête paginée des détails des packages partagés.

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/shared-packages

• 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: ListSubscriptionSharedPackages, 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. 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 par statut

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]	Entrées de données
	Array[Object]	Entrées de données
InstanceCode	string	Code d'instance du siège
EquityList	Array[Object]	Instances d'avantages actuellement actives
	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
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, la valeur par défaut est 1. 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/shared-packages?PageNo=1&PageSize=10&StatusList.1=NORMAL" \
    --header "x-acs-action: ListSubscriptionSharedPackages" \
    --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": 1775232000,
            "CycleEndTime": 1756310400,
            "CycleTotalValue": 100,
            "CycleSurplusValue": 40,
            "CycleVersion": 1
          }
        ],
        "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.