Lister les membres - Alibaba Cloud Model Studio - Centre de documentation Alibaba Cloud

Interroger la liste des membres de l'organisation (y compris les informations sur les sièges), avec prise en charge du filtrage par nom, statut et attribution de siège, ainsi que de la pagination.

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/organization/members
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: ListOrganizationMembers, 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/organization/members`

Paramètres de la requête

Tous les paramètres sont transmis dans la chaîne de requête.

Paramètre	Type	Obligatoire	Description
Name	string	Non	Filtre flou sur le nom du membre (correspondance avec accountName ou email, insensible à la casse)
Status	string	Non	Filtre de statut de membre (tel que ACTIVE, FROZEN), null signifie aucun filtre
HasSeat	boolean	Non	Filtre d'allocation de siège :
PageNum	integer	Non	Numéro de page, commençant à 1, par défaut 1
PageSize	integer	Non	Nombre d'éléments par page, par défaut 20, maximum 100

Paramètres de réponse

Paramètre	Type	Description
PageNo	integer	Numéro de page actuel
PageSize	integer	Nombre d'éléments par page
Total	integer	Nombre total d'enregistrements
Success	boolean	Indique si la requête a réussi.
Code	string	Code d'état de la réponse.
Message	string	Message de réponse.
Data	Array[Object]	Données métier.
	Array[Object]	Résultat de l'opération
AccountId	string	ID du compte membre
AccountName	string	Nom du compte membre
AccountBizId	string	ID métier du membre
Email	string	E-mail du membre
OrgId	string	ID de l'organisation.
Status	string	Statut du membre
Roles	Array	Liste des rôles des membres
	string	Rôle du membre
GmtCreate	string	Date d'adhésion
SeatId	string	ID d'allocation de ressource de siège
SpecType	string	Type de spécification de siège standard - Siège Standard pro - Siège Pro max - Siège Max
ApiKeyId	string	ID de clé API
MaskedApiKey	string	Clé API masquée
PackLimitInfo	object
HasShareLimit	boolean
UpperLimit	nombre
UsedCredits	nombre
AvailableLimit	nombre
FrozenCredits	nombre
IsAvailable	boolean
CycleStartTime	integer
CycleEndTime	integer
LastConfirmedTime	integer
SubscriptionInfo	object
InstanceCode	string
ProductCode	string
SpecType	string
PayMode	string
Status	string
StartTime	integer
EndTime	integer
EquityList	Array[Object]
	object
EquityType	string
CycleStartTime	integer
CycleEndTime	integer
CycleTotalValue	nombre
CycleSurplusValue	nombre
EquityUnit	string

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/organization/members?Name=Member%20name&Status=ACTIVE&HasSeat=true&PageNum=1&PageSize=20" \
    --header "x-acs-action: ListOrganizationMembers" \
    --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

{
  "PageNo": 18,
  "PageSize": 20,
  "Total": 1,
  "Success": true,
  "Data": [
    {
      "AccountId": "acc_123456789",
      "AccountName": "test_001",
      "AccountBizId": "112233",
      "Email": "test@email.com",
      "OrgId": "org_123456789",
      "Status": "ACTIVE",
      "Roles": [
        "ORG_MEMBER"
      ],
      "GmtCreate": "2026-06-10T11:57:42.000+00:00",
      "SeatId": "seat_123456",
      "SpecType": "standard",
      "ApiKeyId": "key_123456789",
      "MaskedApiKey": "prefix.abc****456",
      "PackLimitInfo": {
        "HasShareLimit": true,
        "UpperLimit": 0,
        "UsedCredits": 0,
        "AvailableLimit": 0,
        "FrozenCredits": 0,
        "IsAvailable": true,
        "CycleStartTime": 0,
        "CycleEndTime": 0,
        "LastConfirmedTime": 0
      },
      "SubscriptionInfo": {
        "InstanceCode": "",
        "ProductCode": "",
        "SpecType": "",
        "PayMode": "",
        "Status": "",
        "StartTime": 0,
        "EndTime": 0,
        "EquityList": [
          {
            "EquityType": "",
            "CycleStartTime": 0,
            "CycleEndTime": 0,
            "CycleTotalValue": 0,
            "CycleSurplusValue": 0,
            "EquityUnit": ""
          }
        ]
      }
    }
  ]
}

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.