Skip to main content

共有パッケージの一覧表示

共有パッケージの詳細をページネーション付きで照会します。

前提条件

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey を取得しており、その ID にこの操作を呼び出すために必要な RAM 権限が付与されていること。AccessKey をハードコーディングするのではなく、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET として設定することを推奨します。

リクエストの説明

  • HTTPメソッド：GET
  • リクエスト URL

    リージョン

    エンドポイント

    シンガポール

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

  • 認証 この操作は、AccessKey ベースの署名（ACS3-HMAC-SHA256 アルゴリズム）を使用する Alibaba Cloud OpenAPI 操作です。Authorization: Bearer {API_KEY} スキームはサポートされていません。リクエストには共通ヘッダー x-acs-action: ListSubscriptionSharedPackages、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce、および Authorization を含める必要があります。 署名を自分で計算する必要がないよう、Alibaba Cloud SDK または OpenAPI Explorer を使用してこの操作を呼び出すことを推奨します。

リクエストパラメーター

すべてのパラメーターはクエリ文字列で渡されます。配列パラメーター（StatusList）は Flat 形式を使用します。各要素を ParameterName.N として渡します。N は 1 から始まります。例：StatusList.1=NORMAL および StatusList.2=<second value>。

パラメーター

タイプ

必須

説明

PageNo

integer

いいえ

ページ番号。デフォルト値：1。値の範囲：正の整数。

PageSize

integer

いいえ

ページネーションパラメータ：1ページあたりの表示件数、デフォルト値は 10 です。

StatusList

Array

いいえ

ステータスフィルタリングリスト

レスポンスパラメーター

パラメーター

タイプ

説明

Success

boolean

API呼び出しが成功したかどうか：
true：成功
false：失敗

Code

string

レスポンスステータスコード。

Message

string

レスポンスメッセージ。

Data

object

ビジネスデータ。

Items

Array[Object]

データエントリ

Array[Object]

データエントリ

InstanceCode

string

シートのインスタンスコード

EquityList

Array[Object]

現在有効な権益インスタンス

object

EquityType

string

権益タイプ（CREDITS、SPN、リソースパックなど）

CycleInstanceId

string

権益コード（サブスクリプションコード。credits シナリオでは消費不要）

CycleStartTime

integer

現在のサイクル開始時刻（ミリ秒）

CycleEndTime

integer

現在のサイクル終了時刻（ミリ秒）

CycleTotalValue

数値

現在のサイクルの総クォータ

CycleSurplusValue

数値

現在のサイクルの残クォータ

CycleVersion

integer

現在のサイクルの時系列バージョン

Status

string

シートステータス：
CREATING —— 作成中
NORMAL —— 有効状態
LIMIT —— 料金滞納による制限
RELEASE —— 期限切れによるリリース
STOP —— 期限切れによる停止
REFUNDED —— 返金済み

Total

integer

シートの総数

PageNo

integer

ページ番号、値は 0 より大きく Integer データ型の最大値以下で、デフォルト値は 1 です。ページ番号、値は 0 より大きく Integer データ型の最大値以下です。

PageSize

integer

1ページあたりの表示件数。

リクエスト例

この操作では Alibaba Cloud OpenAPI の署名を使用します。以下の例では、${SIGNATURE} を ACS3-HMAC-SHA256 アルゴリズムで計算する必要があり、x-acs-date および x-acs-signature-nonce を実際の値に置き換える必要があります。 
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}"

レスポンス例 

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

エラーコード

呼び出しに失敗した場合、エラーメッセージが返されます。その他のエラーコードと解決策については、エラーコードを参照してください。