Skip to main content

Listar membros

Consulta a lista de membros da organização (incluindo informações de assento), suportando filtragem por nome, status e atribuição de assento, com suporte à paginação.

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/members

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

Todos os parâmetros são passados na string de consulta.

Parâmetro

Tipo

Obrigatório

Descrição

Name

string

Não

Filtro difuso de nome do membro (corresponde a accountName ou email, ignora maiúsculas e minúsculas)

Status

string

Não

Filtro de status do membro (como ACTIVE, FROZEN), null indica sem filtro

HasSeat

boolean

Não

Filtro de assento alocado:

PageNum

integer

Não

Número da página, começando em 1, padrão 1

PageSize

integer

Não

Itens por página, padrão 20, máximo 100

Parâmetros de resposta

Parâmetro

Tipo

Descrição

PageNo

integer

Número da página atual

PageSize

integer

Itens por página

Total

integer

Total de registros

Success

boolean

Se a solicitação foi bem-sucedida.

Code

string

Código de status da resposta.

Message

string

Mensagem de resposta.

Data

Array[Object]

Dados comerciais.

Array[Object]

Resultado da operação

AccountId

string

ID da conta do membro

AccountName

string

Nome da conta do membro

AccountBizId

string

ID comercial do membro

Email

string

E-mail do membro

OrgId

string

ID da Organização.

Status

string

Status do membro

Roles

Array

Lista de funções do membro

string

Função do membro

GmtCreate

string

Data de ingresso

SeatId

string

ID de alocação de recurso de assento

SpecType

string

Tipo de especificação de assento
standard - Assento Standard
pro - Assento Pro
max - Assento Max

ApiKeyId

string

ID da Chave de API

MaskedApiKey

string

Chave de API mascarada

PackLimitInfo

object

HasShareLimit

boolean

UpperLimit

número

UsedCredits

número

AvailableLimit

número

FrozenCredits

número

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

número

CycleSurplusValue

número

EquityUnit

string

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/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}"

Exemplo de resposta

{
  "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": ""
          }
        ]
      }
    }
  ]
}

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.