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/organization/member-seat-stats

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

リクエストパラメーター

このAPIにはリクエストパラメータはありません。

レスポンスパラメーター

パラメーター

タイプ

説明

OrgId

string

組織IDです。

TotalMemberCount

integer

メンバー総数です。

OwnerRoleUserCount

integer

オーナー数(ORG_OWNERロール)です。

AdminRoleUserCount

integer

管理者数(ORG_ADMINロール)です。

MemberRoleUserCount

integer

一般メンバー数(ORG_MEMBERロール)です。

SeatedMemberCount

integer

シート割り当て済みメンバー数です。

UnseatedMemberCount

integer

シート未割り当てメンバー数です。

リクエスト例

この操作では 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/organization/member-seat-stats" \
    --header "x-acs-action: GetOrganizationMemberSeatStats" \
    --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}"

レスポンス例

{
  "OrgId": "5ffd468b1e45db3c1cc26ad6",
  "TotalMemberCount": 12,
  "OwnerRoleUserCount": 1,
  "AdminRoleUserCount": 3,
  "MemberRoleUserCount": 8,
  "SeatedMemberCount": 2,
  "UnseatedMemberCount": 10
}

エラーコード

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