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/members

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

リクエストパラメーター

すべてのパラメーターはクエリ文字列で渡されます。

パラメーター

タイプ

必須

説明

Name

string

いいえ

メンバー名のあいまいフィルタリング（accountName または email に一致、大文字小文字を区別しない）

Status

string

いいえ

メンバーのステータスによるフィルタリング（ACTIVE、FROZEN など）、null はフィルタリングなしを示します

HasSeat

boolean

いいえ

シート割り当て済みかどうかのフィルタリング：

PageNum

integer

いいえ

ページ番号、1 から始まり、デフォルトは 1

PageSize

integer

いいえ

1 ページあたりの件数、デフォルト 20、最大 100

レスポンスパラメーター

パラメーター

タイプ

説明

PageNo

integer

現在のページ番号

PageSize

integer

1 ページあたりの件数

Total

integer

総レコード数

Success

boolean

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

Code

string

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

Message

string

レスポンスメッセージ。

Data

Array[Object]

ビジネスデータ。

Array[Object]

操作結果

AccountId

string

メンバーアカウント ID

AccountName

string

メンバーアカウント名

AccountBizId

string

メンバー業務 ID

Email

string

メンバーのメールアドレス

OrgId

string

組織IDです。

Status

string

メンバーのステータス

Roles

Array

メンバーのロール一覧

string

メンバーのロール

GmtCreate

string

参加日時

SeatId

string

シートリソース割り当て ID

SpecType

string

シートの仕様タイプ
standard - Standard seat
pro - Pro seat
max - Max seat

ApiKeyId

string

APIキーID

MaskedApiKey

string

マスク済み API Key

PackLimitInfo

object

HasShareLimit

boolean

UpperLimit

数値

UsedCredits

数値

AvailableLimit

数値

FrozenCredits

数値

IsAvailable

boolean

CycleStartTime

integer

CycleEndTime

integer

LastConfirmedTime

integer

SubscriptionInfo

object

InstanceCode

string

ProductCode

string

SpecType

string

PayMode

string

Status

string

StartTime

integer

EndTime

integer

EquityList

Array[Object]

object

EquityType

string

CycleStartTime

integer

CycleEndTime

integer

CycleTotalValue

数値

CycleSurplusValue

数値

EquityUnit

string

リクエスト例

この操作では 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/members?Name=Member%20name&Status=ACTIVE&HasSeat=true&PageNum=1&PageSize=20" \
    --header "x-acs-action: ListOrganizationMembers" \
    --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}"

レスポンス例 

{
  "PageNo": 18,
  "PageSize": 20,
  "Total": 1,
  "Success": true,
  "Data": [
    {
      "AccountId": "acc_123456789",
      "AccountName": "test_001",
      "AccountBizId": "112233",
      "Email": "test@email.com",
      "OrgId": "org_123456789",
      "Status": "ACTIVE",
      "Roles": [
        "ORG_MEMBER"
      ],
      "GmtCreate": "2026-06-10T11:57:42.000+00:00",
      "SeatId": "seat_123456",
      "SpecType": "standard",
      "ApiKeyId": "key_123456789",
      "MaskedApiKey": "prefix.abc****456",
      "PackLimitInfo": {
        "HasShareLimit": true,
        "UpperLimit": 0,
        "UsedCredits": 0,
        "AvailableLimit": 0,
        "FrozenCredits": 0,
        "IsAvailable": true,
        "CycleStartTime": 0,
        "CycleEndTime": 0,
        "LastConfirmedTime": 0
      },
      "SubscriptionInfo": {
        "InstanceCode": "",
        "ProductCode": "",
        "SpecType": "",
        "PayMode": "",
        "Status": "",
        "StartTime": 0,
        "EndTime": 0,
        "EquityList": [
          {
            "EquityType": "",
            "CycleStartTime": 0,
            "CycleEndTime": 0,
            "CycleTotalValue": 0,
            "CycleSurplusValue": 0,
            "EquityUnit": ""
          }
        ]
      }
    }
  ]
}

エラーコード

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