查询组织成员列表(含席位信息),支持按名称、状态、是否分配席位过滤,支持分页。
前提条件
已获取阿里云账号或 RAM 用户的 AccessKey,并已为其授予调用本接口所需的 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 -
认证方式
本接口是阿里云 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 |
请求示例
本接口使用阿里云 OpenAPI 签名,下例中 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 算法计算得出,x-acs-date、x-acs-signature-nonce 需替换为实际值。示例 URL 中的中文取值为便于阅读未做编码;实际计算签名时,规范化请求(CanonicalRequest)的 Query String 需按 RFC 3986 对键和取值做百分号编码,否则会返回 SignatureDoesNotMatch。使用阿里云 SDK 时会自动处理。