Consulta paginada de detalles de paquetes compartidos.
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/shared-packages -
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 esquemaAuthorization: Bearer {API_KEY}. Una solicitud debe llevar los encabezados comunesx-acs-action: ListSubscriptionSharedPackages,x-acs-version: 2026-02-10,x-acs-date,x-acs-content-sha256,x-acs-signature-nonceyAuthorization.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.
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 | El 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 |
Parámetros de respuesta
Parámetro | Tipo | Descripción |
|---|---|---|
Success | boolean | Indica si la llamada a la API fue exitosa: |
Code | string | Código de estado de la respuesta. |
Message | string | Mensaje de respuesta. |
Data | object | Datos comerciales. |
Items | Array[Object] | Entradas de datos |
Array[Object] | Entradas de datos | |
InstanceCode | string | Código de instancia de asiento |
EquityList | Array[Object] | Instancias de derechos vigentes actualmente |
object | ||
EquityType | string | Tipo de derecho (como CREDITS, SPN, paquetes de recursos, etc.) |
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 del ciclo actual |
CycleSurplusValue | number | Cuota restante del ciclo actual |
CycleVersion | integer | Versión de serie temporal del ciclo actual |
Status | string | Estado del asiento: |
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. Valor predeterminado: 1. |
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/shared-packages?PageNo=1&PageSize=10&StatusList.1=NORMAL" \
--header "x-acs-action: ListSubscriptionSharedPackages" \
--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": 1775232000,
"CycleEndTime": 1756310400,
"CycleTotalValue": 100,
"CycleSurplusValue": 40,
"CycleVersion": 1
}
],
"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.