Skip to main content

查詢成員清單

查詢組織成員清單(含席位資訊),支援按名稱、狀態、是否分配席位篩選,支援分頁。

前提條件

已取得阿里雲帳號或 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

Email

string

成員電子郵件

OrgId

string

組織 ID

Status

string

成員狀態

Roles

Array

成員角色清單

string

成員角色

GmtCreate

string

加入時間

SeatId

string

席位資源分配 ID

SpecType

string

席位規格類型
standard - 標準席位
pro - 進階席位
max - 尊享席位

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 時會自動處理。
curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization/members?Name=成员名称&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: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --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": ""
          }
        ]
      }
    }
  ]
}

錯誤碼

如果呼叫失敗,會返回錯誤訊息。更多錯誤碼及解決方法,請參閱錯誤訊息。