Skip to main content

Obter estatísticas de assentos e créditos da assinatura

Consultar estatísticas de assentos e créditos da assinatura, incluindo período da assinatura, contagem de assentos por tipo, assentos atribuídos e créditos restantes.

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/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: GetSubscriptionStats, 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

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.

SubscriptionStartTime

integer

Hora de início da assinatura, milissegundos

SubscriptionEndTime

integer

Hora de término da assinatura, milissegundos

Items

Array[Object]

Lista de informações de assentos (agrupadas por specType)

object

Dados da lista

SeatType

string

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

SeatRefreshTime

integer

Hora de atualização do ciclo atual, milissegundos

TotalSeats

integer

Total de assentos

AssignedSeats

integer

Assentos atribuídos

SeatCredits

número

Cota total de Credits dos assentos

SeatRemainingCredits

número

Credits restantes neste ciclo

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/stats" \
    --header "x-acs-action: GetSubscriptionStats" \
    --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": {
    "SubscriptionStartTime": 1788328800000,
    "SubscriptionEndTime": 1790920800000,
    "Items": [
      {
        "SeatType": "standard",
        "SeatRefreshTime": 1790920800000,
        "TotalSeats": 2,
        "AssignedSeats": 1,
        "SeatCredits": 100,
        "SeatRemainingCredits": 40
      }
    ]
  }
}

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.