Obtener detalles de asientos de suscripción - Alibaba Cloud Model Studio

Consulta paginada de detalles de asientos de suscripción.

Requisitos previos

Ha obtenido la AccessKey de una cuenta de Alibaba Cloud o de un usuario RAM, y a la identidad se le han otorgado los permisos RAM necesarios para invocar esta operación. Le recomendamos que configure la AccessKey como las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET en lugar de codificarla directamente.

Descripción de la solicitud

Método HTTP: GET
URL de solicitud
Región
Endpoint
Singapur
GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail
Autenticación
Esta operación es una operación de OpenAPI de Alibaba Cloud que utiliza firmas basadas en AccessKey (el algoritmo ACS3-HMAC-SHA256). No se admite el esquema Authorization: Bearer {API_KEY}. Una solicitud debe llevar los encabezados comunes x-acs-action: GetSubscriptionSeatDetails, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce y Authorization.

Le recomendamos que invoque esta operación con un SDK de Alibaba Cloud o OpenAPI Explorer para no tener que calcular la firma usted mismo.

Región	Endpoint
Singapur	`GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail`

Parámetros de solicitud

Todos los parámetros se pasan en la cadena de consulta. Los parámetros de matriz (StatusList) utilizan el formato Flat: pase cada elemento como ParameterName.N, donde N comienza desde 1. Por ejemplo, StatusList.1=NORMAL y StatusList.2=<second value>.

Parámetro	Tipo	Obligatorio	Descripción
PageNo	integer	No	Número de página. Valor predeterminado: 1. Valores válidos: enteros positivos.
PageSize	integer	No	Parámetro de paginación: número de entradas por página. Valor predeterminado: 10.
StatusList	Array	No	Lista de filtros de estado de asiento.
SeatId	string	No	ID de asiento.
SeatType	string	No	Tipo de asiento (specType). standard - Asiento estándar pro - Asiento Pro max - Asiento Max
QueryAssigned	boolean	No	Filtro de estado de asignación de asiento. true=asignado, false=no asignado, null=todos.

Parámetros de respuesta

Parámetro	Tipo	Descripción
Success	boolean	Indica si la llamada a la API fue exitosa: true: éxito false: fallo
Code	string	Código de estado de la respuesta.
Message	string	Mensaje de respuesta.
Data	object	Datos comerciales.
Items	Array[Object]	Elementos de datos.
	Array[Object]	Elementos de datos.
InstanceCode	string	Código de instancia de asiento.
EquityList	Array[Object]	La instancia de derecho actualmente vigente. Para el producto TokenPlan, esta lista contiene solo una instancia de derecho vigente.
	object
EquityType	string	Tipo de derecho (por ejemplo, CREDITS, SPN, paquete de recursos).
CycleInstanceId	string	Código de derecho (código de suscripción; no se consume en escenarios de créditos).
CycleStartTime	integer	Hora de inicio del ciclo actual, en milisegundos.
CycleEndTime	integer	Hora de finalización del ciclo actual, en milisegundos.
CycleTotalValue	number	Cuota total para el ciclo actual.
CycleSurplusValue	number	Cuota restante para el ciclo actual.
CycleVersion	integer	Versión temporal del ciclo actual.
EndTime	integer	Hora de vencimiento del asiento.
SeatId	string	ID de asiento.
SpecType	string	Tipo de asiento. standard - Asiento estándar pro - Asiento Pro max - Asiento Max
StartTime	integer	Hora de inicio del asiento.
AssignedStatus	string	Estado de asignación. ASSIGNED UNASSIGNED
AccountId	string	ID de cuenta de miembro vinculada.
AccountName	string	Nombre de la cuenta del miembro.
AccountEmail	string	Correo electrónico de la cuenta del miembro.
Status	string	Estado del asiento: CREATING — Creando NORMAL — Activo LIMIT — Restringido por pago atrasado RELEASE — Liberado por vencimiento STOP — Suspendido por vencimiento REFUNDED — Reembolsado
Total	integer	Número total de asientos.
PageNo	integer	Número de página. El valor debe ser mayor que 0 y no exceder el valor máximo del tipo de datos Integer.
PageSize	integer	Número de entradas por página.

Ejemplo de solicitud

Esta operación utiliza firmas de OpenAPI de Alibaba Cloud. En el siguiente ejemplo, ${SIGNATURE} debe calcularse con el algoritmo ACS3-HMAC-SHA256, y x-acs-date y x-acs-signature-nonce deben reemplazarse con valores reales.

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

Ejemplo de respuesta

{
  "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 error

Si la llamada falla, se devuelve un mensaje de error. Para obtener más códigos de error y soluciones, consulte Códigos de error.