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/seat-detail

  • 認証 この操作は、AccessKey ベースの署名（ACS3-HMAC-SHA256 アルゴリズム）を使用する Alibaba Cloud OpenAPI 操作です。Authorization: Bearer {API_KEY} スキームはサポートされていません。リクエストには共通ヘッダー x-acs-action: GetSubscriptionSeatDetails、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

いいえ

シートステータスフィルターリスト

SeatId

string

いいえ

シートID

SeatType

string

いいえ

シートタイプ（specType）
standard - Standard seat
pro - Pro seat
max - Max seat

QueryAssigned

boolean

いいえ

シート割り当てステータスのフィルター条件。true=割り当て済み、false=未割り当て、null=すべて

レスポンスパラメーター

パラメーター

タイプ

説明

Success

boolean

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

Code

string

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

Message

string

レスポンスメッセージ。

Data

object

ビジネスデータ。

Items

Array[Object]

データ項目

Array[Object]

データ項目

InstanceCode

string

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

EquityList

Array[Object]

現在有効な権益インスタンス。TokenPlan 製品の場合、このリストには有効な権益インスタンスが1つだけ含まれます。

object

EquityType

string

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

CycleInstanceId

string

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

CycleStartTime

integer

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

CycleEndTime

integer

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

CycleTotalValue

数値

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

CycleSurplusValue

数値

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

CycleVersion

integer

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

EndTime

integer

シートの有効期限

SeatId

string

シートID

SpecType

string

シートタイプ。
standard - 標準シート
pro - Proシート
max - Maxシート

StartTime

integer

シートの開始時刻

AssignedStatus

string

割り当てステータス
ASSIGNED
UNASSIGNED

AccountId

string

紐付けられたメンバーアカウントID

AccountName

string

メンバーアカウント名

AccountEmail

string

メンバーアカウントメールアドレス

Status

string

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

Total

integer

シートの総数

PageNo

integer

ページ番号。値は 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/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}"

レスポンス例 

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

エラーコード

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