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 esquemaAuthorization: Bearer {API_KEY}não é suportado. Uma solicitação deve incluir os cabeçalhos comunsx-acs-action: GetSubscriptionSeatDetails,x-acs-version: 2026-02-10,x-acs-date,x-acs-content-sha256,x-acs-signature-nonceeAuthorization. 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) |
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: |
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. |
StartTime | integer | Hora de início do assento |
AssignedStatus | string | Status de atribuição |
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: |
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.