查詢組織成員清單(含席位資訊),支援按名稱、狀態、是否分配席位篩選,支援分頁。
前提條件
已取得阿里雲帳號或 RAM 使用者的 AccessKey,並已為其授予呼叫此 API 所需的 RAM 權限。建議將 AccessKey 設定為環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET,避免以明文寫入程式碼。
請求說明
- HTTP 方法:GET
-
請求地址
地域
Endpoint
新加坡
GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization/members -
驗證方式
此 API 為阿里雲 OpenAPI,採用 AccessKey 簽名(簽名演算法
ACS3-HMAC-SHA256),不支援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。 建議使用阿里雲 SDK 或 OpenAPI Explorer 發起呼叫,可免去自行計算簽名。
請求參數
所有參數均透過 Query String 傳遞。
參數 | 類型 | 必選 | 描述 |
|---|---|---|---|
Name | string | 否 | 成員名稱模糊篩選(匹配 accountName 或 email,忽略大小寫) |
Status | string | 否 | 成員狀態篩選(如 ACTIVE、FROZEN),null 表示不篩選 |
HasSeat | boolean | 否 | 是否已分配席位篩選: |
PageNum | integer | 否 | 頁碼,從 1 開始,預設 1 |
PageSize | integer | 否 | 每頁筆數,預設 20,最大 100 |
返回參數
參數 | 類型 | 描述 |
|---|---|---|
PageNo | integer | 目前頁碼 |
PageSize | integer | 每頁數量 |
Total | integer | 總記錄數 |
Success | boolean | 是否成功 |
Code | string | 回應狀態碼。 |
Message | string | 回應訊息。 |
Data | Array[Object] | 業務資料 |
Array[Object] | 操作結果 | |
AccountId | string | 成員帳號 ID |
AccountName | string | 成員帳號名稱 |
AccountBizId | string | 成員業務 ID |
string | 成員電子郵件 | |
OrgId | string | 組織 ID |
Status | string | 成員狀態 |
Roles | Array | 成員角色清單 |
string | 成員角色 | |
GmtCreate | string | 加入時間 |
SeatId | string | 席位資源分配 ID |
SpecType | string | 席位規格類型 |
ApiKeyId | string | API Key ID |
MaskedApiKey | string | 去識別化 API Key |
PackLimitInfo | object | |
HasShareLimit | boolean | |
UpperLimit | number | |
UsedCredits | number | |
AvailableLimit | number | |
FrozenCredits | number | |
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 | number | |
CycleSurplusValue | number | |
EquityUnit | string |
請求範例
此 API 使用阿里雲 OpenAPI 簽名,下列範例中的 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 演算法計算得出,x-acs-date、x-acs-signature-nonce 需替換為實際值。範例 URL 中的中文取值為便於閱讀未做編碼;實際計算簽名時,規範化請求(CanonicalRequest)的 Query String 需按 RFC 3986 對鍵和取值進行百分比編碼,否則會返回 SignatureDoesNotMatch。使用阿里雲 SDK 時會自動處理。