Skip to main content

Obter Estatísticas de Membros e Assentos

Consultar estatísticas de membros da organização, incluindo contagem total de membros, contagem de administradores, contagem de membros regulares, contagem de membros com assento e contagem de membros sem assento.

Pré-requisitos

Você obteve o AccessKey de uma conta Alibaba Cloud ou de um usuário RAM, e a identidade recebeu as permissões RAM necessárias para chamar esta operação. Recomendamos que você defina o AccessKey como as variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET em vez de codificá-lo diretamente.

Descrição da solicitação

  • Método HTTP: GET
  • URL da solicitação

    Região

    Endpoint

    Singapura

    GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization/member-seat-stats

  • Autenticação Esta operação é uma operação da OpenAPI da Alibaba Cloud que utiliza assinaturas baseadas em AccessKey (o algoritmo ACS3-HMAC-SHA256). O esquema Authorization: Bearer {API_KEY} não é suportado. Uma solicitação deve incluir os cabeçalhos comuns x-acs-action: GetOrganizationMemberSeatStats, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce e Authorization. Recomendamos que você chame esta operação com um SDK da Alibaba Cloud ou o OpenAPI Explorer para que não seja necessário calcular a assinatura manualmente.

Parâmetros da solicitação

Esta API não possui parâmetros de solicitação.

Parâmetros de resposta

Parâmetro

Tipo

Descrição

OrgId

string

ID da Organização.

TotalMemberCount

integer

Contagem total de membros.

OwnerRoleUserCount

integer

Contagem de proprietários (função ORG_OWNER).

AdminRoleUserCount

integer

Contagem de administradores (função ORG_ADMIN).

MemberRoleUserCount

integer

Contagem de membros regulares (função ORG_MEMBER).

SeatedMemberCount

integer

Contagem de membros com assento.

UnseatedMemberCount

integer

Contagem de membros sem assento.

Exemplo de solicitação

Esta operação utiliza assinaturas da OpenAPI da Alibaba Cloud. No exemplo a seguir, ${SIGNATURE} deve ser calculado com o algoritmo ACS3-HMAC-SHA256, e x-acs-date e x-acs-signature-nonce devem ser substituídos pelos valores reais.
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}"

Exemplo de resposta

{
  "OrgId": "5ffd468b1e45db3c1cc26ad6",
  "TotalMemberCount": 12,
  "OwnerRoleUserCount": 1,
  "AdminRoleUserCount": 3,
  "MemberRoleUserCount": 8,
  "SeatedMemberCount": 2,
  "UnseatedMemberCount": 10
}

Códigos de erro

Se a chamada falhar, uma mensagem de erro será retornada. Para mais códigos de erro e soluções, consulte Códigos de erro.