团队
团队将组织成员归组，用于责任归属、流量归因和共享治理。预算、限流策略和 MCP 访问策略可以使用团队身份，控制来自已绑定团队的调用方 API Key 的流量。
团队成员关系与调用方 API Key 绑定的用途不同。成员名单用于标识谁属于该团队；只有请求使用的调用方 API Key 显式绑定到该团队时，流量才会计入团队控制。
创建团队
- 打开 团队，选择 新建团队。
- 输入 显示名称 和 描述（可选）。
- 选择 创建团队。
团队将显示其成员数量和 团队 ID。选择团队名称或 管理 可打开团队详情页。
其他指南要求设置 TEAM_ID 时，请复制 Team ID。团队详情页 URL 的末尾也包含同一个 UUID。
export TEAM_ID="YOUR_TEAM_ID"
添加和管理成员
团队成员来自组织成员池。将成员加入团队之前，请先创建或邀请成员。
- 打开团队详情页。
- 在 成员 下选择 添加成员。
- 选择 组织成员，并为其分配团队角色 成员 或 负责人。
- 选择 添加成员。
Member 和 Lead 标签属于团队成员名单，不会取代成员的组织角色。当团队只有一名 Lead 时，需要先将另一名成员提升为 Lead，才能降级或移除唯一的 Lead。
使用成员行中的角色选择器更改其团队角色。选择移除操作可将成员移出团队，但不会移除其组织成员资格。
使用 Admin API 管理团队
AISIX Cloud Admin API 支持同样的团队生命周期和成员名单操作：
| 任务 | 方法和路径 |
|---|---|
| 列出或创建团队 | GET 或 POST /teams |
| 查看、更新或删除团队 | GET、PATCH 或 DELETE /teams/{team_id} |
| 列出或添加成员 | GET 或 POST /teams/{team_id}/members |
| 更改成员的团队角色或移除成员 | PATCH 或 DELETE /teams/{team_id}/members/{user_id} |
GET /teams/{team_id}/members 接受可选的 q、page 和 page_size，含义与 GET /members 相同。不传 page_size 时在 data 中返回完整名单，传了 page_size 时响应多出 total、page 和 page_size。每一行都带 id，即调用方 API Key 负责人和预算引用的组织成员资格 ID。
成员条目路径使用的是成员账号的 user_id，而不是调用方 Key 归属所用的组织成员资格 ID。团队权益通过 /teams/{team_id}/entitlements 提供。这些操作需要相应的 Admin Token 权限范围和组织权限。请求和响应 Schema 参见 AISIX Enterprise / Cloud Admin API 参考。
将调用方 API Key 绑定到团队
仅加入团队不会让流量归因到团队。需要将应使用团队预算、限流或 MCP 访问权限的每个调用方 API Key 绑定到团队：
- 打开环境，选择 API 密钥。
- 使用 新建 API 密钥 创建 Key，或编辑已有 Key。
- 在 团队 中选择团队。
- 可以选择 所有者。选择团队后，所有者列表只包含该团队的成员。
- 创建 Key 或保存更改。
API Key 所在行会显示其团队绑定。成员出现在团队名单中，并不意味着其个人 Key 的流量会计入该团队。
将 Key 绑定到团队或改绑到其他团队，只影响该 Key 之后的请求。已计入原团队预算的支出仍留在原团队。详见支出如何计入。
配置团队控制
团队详情页提供 团队预算（共享）、每成员预算 和 MCP 权益 控件。以下指南介绍完整行为：
团队还可以带有成本归属标签，可在团队的创建和编辑表单中设置，也可通过 POST /teams 和 PATCH /teams/{team_id} 的 tags 字段设置。通过绑定到团队的调用方 API Key 发出的请求，凡 Key 自己没有设置、JWT Claim 也没有提供的标签，都取团队的值。
从身份提供方同步团队
SCIM 目录同步会将身份提供方中的组表示为同名团队。组成员关系变化会自动更新团队名单。请在身份提供方中管理目录同步团队的名单，避免后续同步覆盖控制台中的更改。
目录同步团队可以与控制台中创建的团队一样，使用调用方 API Key 绑定、预算、限流策略和 MCP 权益。
编辑或删除团队
打开团队详情页，选择 编辑 可更改显示名称、描述或标签。选择 删除 可删除团队及其成员名单。名单中的人员仍然是组织成员。
下一步
继续阅读调用方 API Key，创建绑定到团队的凭证。然后为团队配置预算、限流策略或 MCP 访问策略。