Skip to main content

Obter detalhes dos assentos da assinatura

Consulta paginada dos detalhes dos assentos da assinatura.

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/subscription/seat-detail

  • 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: GetSubscriptionSeatDetails, 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 query string. Parâmetros de array (StatusList) usam o formato Flat: passe cada elemento como ParameterName.N, onde N começa em 1. Por exemplo, StatusList.1=NORMAL e StatusList.2=<second value>.

Parâmetro

Tipo

Obrigatório

Descrição

PageNo

integer

Não

Número da página. Valor padrão: 1 Intervalo de valores: inteiros positivos.

PageSize

integer

Não

Parâmetro de paginação: número de itens exibidos por página, valor padrão 10.

StatusList

Array

Não

Lista de filtros de status de assento

SeatId

string

Não

ID do assento

SeatType

string

Não

Tipo de assento (specType)
standard - Standard seat
pro - Pro seat
max - Max seat

QueryAssigned

boolean

Não

Filtro de status de atribuição de assentos. true=Atribuído, false=Não atribuído, null=Todos

Parâmetros de resposta

Parâmetro

Tipo

Descrição

Success

boolean

Se a chamada de API foi bem-sucedida:
true: sucesso
false: falha

Code

string

Código de status da resposta.

Message

string

Mensagem de resposta.

Data

object

Dados comerciais.

Items

Array[Object]

Itens de dados

Array[Object]

Itens de dados

InstanceCode

string

Código de instância do assento

EquityList

Array[Object]

Instâncias de benefícios atualmente ativas; para o produto TokenPlan, esta lista conterá apenas uma instância de benefício ativa

object

EquityType

string

Tipo de benefício (como CREDITS, SPN, pacotes de recursos, etc.)

CycleInstanceId

string

Código do benefício (código da assinatura, não requer consumo no cenário de credits)

CycleStartTime

integer

Hora de início do ciclo atual, milissegundos

CycleEndTime

integer

Hora de término do ciclo atual, milissegundos

CycleTotalValue

número

Cota total do ciclo atual

CycleSurplusValue

número

Cota restante do ciclo atual

CycleVersion

integer

Versão temporal do ciclo atual

EndTime

integer

Tempo de expiração do assento

SeatId

string

ID do Assento

SpecType

string

Tipo de assento.
standard - Assento padrão
pro - Assento Pro
max - Assento Max

StartTime

integer

Hora de início do assento

AssignedStatus

string

Status de atribuição
ASSIGNED
UNASSIGNED

AccountId

string

ID da conta do membro vinculado

AccountName

string

Nome da conta do membro

AccountEmail

string

E-mail da conta do membro

Status

string

Status do assento:
CREATING —— Criando
NORMAL —— Status ativo
LIMIT —— Restrito por inadimplência
RELEASE —— Liberado por expiração
STOP —— Paralisado por expiração
REFUNDED —— Reembolsado

Total

integer

Quantidade total de assentos

PageNo

integer

Número da página, valor maior que 0 e não superior ao valor máximo do tipo de dados Integer

PageSize

integer

Número de itens por página.

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/subscription/seat-detail?PageNo=1&PageSize=10&StatusList.1=NORMAL&SeatId=seat-123456&SeatType=standard&QueryAssigned=true" \
    --header "x-acs-action: GetSubscriptionSeatDetails" \
    --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

{
  "Success": true,
  "Data": {
    "Items": [
      {
        "InstanceCode": "subs-1234567",
        "EquityList": [
          {
            "EquityType": "CREDITS",
            "CycleInstanceId": "123456",
            "CycleStartTime": 1788328800000,
            "CycleEndTime": 1790920800000,
            "CycleTotalValue": 100,
            "CycleSurplusValue": 40,
            "CycleVersion": 1
          }
        ],
        "EndTime": 1790920800000,
        "SeatId": "seat_123456",
        "SpecType": "standard",
        "StartTime": 1788328800000,
        "AssignedStatus": "ASSIGNED",
        "AccountId": "acc_123456789",
        "AccountName": "ExampleName",
        "AccountEmail": "test@email.com",
        "Status": "NORMAL"
      }
    ],
    "Total": 100,
    "PageNo": 1,
    "PageSize": 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.