Skip to main content

シートの一括取り消し

複数のメンバーからシートを一括で取り消します。

前提条件

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

リクエストの説明

  • HTTP メソッド:POST
  • リクエスト URL

    リージョン

    エンドポイント

    シンガポール

    POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-revocations

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

リクエストパラメーター

すべてのパラメータはクエリ文字列で渡されます。配列パラメータ Items の値は JSON 文字列です(例:Items=[{"AccountId": "acc_123456789"}])。リクエスト送信時に値を URL エンコードしてください。

パラメーター

タイプ

必須

説明

Items

Array[Object]

いいえ

取り消す項目のリスト。空にすることはできません。

Items[].AccountId

string

いいえ

現在バインドされているメンバーID。

Locale

string

いいえ

ロケール情報:zh-CN/en-US。

レスポンスパラメーター

パラメーター

タイプ

説明

Success

boolean

リクエストが成功したかどうか。

Code

string

エラーコード(成功時は空)。

Message

string

エラーメッセージ(成功時は空)。

リクエスト例

この操作では Alibaba Cloud OpenAPI の署名を使用します。以下の例では、${SIGNATURE} を ACS3-HMAC-SHA256 アルゴリズムで計算する必要があり、x-acs-date および x-acs-signature-nonce を実際の値に置き換える必要があります。
curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-revocations?Items=%5B%7B%22AccountId%22%3A%22acc_123456789%22%7D%5D&Locale=en-US" \
    --header "x-acs-action: BatchRevokeSeats" \
    --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
}

エラーコード

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