Skip to main content

Obtenir les statistiques des membres et des sièges

Interroger les statistiques des membres de l'organisation, y compris le nombre total de membres, le nombre d'administrateurs, le nombre de membres réguliers, le nombre de membres avec siège et le nombre de membres sans siège.

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/member-seat-stats

  • 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: GetOrganizationMemberSeatStats, 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

Cette API n'a aucun paramètre de requête.

Paramètres de réponse

Paramètre

Type

Description

OrgId

string

ID de l'organisation.

TotalMemberCount

integer

Nombre total de membres.

OwnerRoleUserCount

integer

Nombre de propriétaires (rôle ORG_OWNER).

AdminRoleUserCount

integer

Nombre d'administrateurs (rôle ORG_ADMIN).

MemberRoleUserCount

integer

Nombre de membres réguliers (rôle ORG_MEMBER).

SeatedMemberCount

integer

Nombre de membres avec siège.

UnseatedMemberCount

integer

Nombre de membres sans siège.

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/member-seat-stats" \
    --header "x-acs-action: GetOrganizationMemberSeatStats" \
    --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

{
  "OrgId": "5ffd468b1e45db3c1cc26ad6",
  "TotalMemberCount": 12,
  "OwnerRoleUserCount": 1,
  "AdminRoleUserCount": 3,
  "MemberRoleUserCount": 8,
  "SeatedMemberCount": 2,
  "UnseatedMemberCount": 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.