Skip to main content
Subscription and Usage

List Shared Packages

Paginated query of shared package details.

Prerequisites

You have obtained the AccessKey of an Alibaba Cloud account or a RAM user, and the identity has been granted the RAM permissions required to call this operation. We recommend that you set the AccessKey as the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET instead of hard-coding it.

Request description

  • HTTP method:GET
  • Request URL

    Region

    Endpoint

    Singapore

    GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/shared-packages

  • Authentication This operation is an Alibaba Cloud OpenAPI operation that uses AccessKey-based signatures (the ACS3-HMAC-SHA256 algorithm). The Authorization: Bearer {API_KEY} scheme is not supported. A request must carry the common headers x-acs-action: ListSubscriptionSharedPackages, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce, and Authorization. We recommend that you call this operation with an Alibaba Cloud SDK or OpenAPI Explorer so that you do not have to calculate the signature yourself.

Request parameters

All parameters are passed in the query string. Array parameters (StatusList) use the Flat format: pass each element as ParameterName.N, where N starts from 1. For example, StatusList.1=NORMAL and StatusList.2=<second value>.

Parameter

Type

Required

Description

PageNo

integer

No

分页页号。默认值:1 取值范围:正整数。

PageSize

integer

No

分页参数:每页显示条数,默认值 10。

StatusList

Array

No

状态筛选列表

Response parameters

Parameter

Type

Description

Success

boolean

Whether the API call was successful:
true: success
false: failure

Code

string

Response status code.

Message

string

Response message.

Data

object

Business data.

Items

Array[Object]

数据条目

Array[Object]

数据条目

InstanceCode

string

席位 instance code

EquityList

Array[Object]

当前生效的权益实例

object

EquityType

string

权益类型(如 CREDITS、SPN、资源包等)

CycleInstanceId

string

权益 code(订阅 code,credits 场景下不需要消费)

CycleStartTime

integer

当前周期开始时间,毫秒

CycleEndTime

integer

当前周期结束时间,毫秒

CycleTotalValue

number

当前周期的总额度

CycleSurplusValue

number

当前周期的剩余额度

CycleVersion

integer

当前周期的时序版本

Status

string

席位状态:
CREATING —— 创建中
NORMAL —— 有效状态
LIMIT ——欠费受限
RELEASE —— 到期释放
STOP —— 到期停机
REFUNDED —— 已退款

Total

integer

席位的总数量

PageNo

integer

页码,取值大于 0 且不超过 Integer 数据类型的最大值,默认值为 1。页码,取值大于 0 且不超过 Integer 数据类型的最大值

PageSize

integer

每页条数。

Request example

This operation uses Alibaba Cloud OpenAPI signatures. In the following example, ${SIGNATURE} must be calculated with the ACS3-HMAC-SHA256 algorithm, and x-acs-date and x-acs-signature-nonce must be replaced with actual values.
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: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --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}"

Response example

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

Error codes

If the call fails, an error message is returned. For more error codes and solutions, see Error codes.
Text Generation
Image Generation
  • FAQ
Video Generation
World models
Audio
  • Audio generation
Realtime API
Text Embedding
TokenPlan
Model Production