OpenAI 列出项目用户角色分配
2026-11-17 18:25 更新
列出项目用户角色分配
get /projects/{project_id}/users/{user_id}/roles
列出项目中分配给用户的项目角色。
路径参数
project_id: string
要查看的项目 ID。
user_id: string
要查看的用户 ID。
查询参数
after: optional string
分页游标。提供上次响应的 next 字段值,以继续列出项目角色。
limit: optional integer
返回的项目角色分配数量上限。
minimum: 0, maximum: 1000
order: optional "asc" or "desc"
返回的项目角色的排序顺序。
"asc"
"desc"
返回值
data: array of object { id, assignment_sources, created_at, 9 more }
当前页返回的角色分配。
id: string
角色标识符。
assignment_sources: array of object { principal_id, principal_type } or null
如果有相关信息,给出此角色分配所继承自的主体。
principal_id: string
principal_type: string
created_at: integer or null
角色创建时间。
format: unixtime
created_by: string or null
创建角色的操作者标识符。
created_by_user_obj: map[unknown] or null
如果有相关信息,给出创建角色的操作者的用户详情。
description: string or null
角色描述。
metadata: map[unknown] or null
存储在角色上的任意元数据。
name: string
角色名称。
permissions: array of string
与角色关联的权限。
predefined_role: boolean
角色是否由 OpenAI 预定义。
resource_type: string
角色适用的资源类型。
updated_at: integer or null
角色上次更新时间。
format: unixtime
has_more: boolean
分页时是否还有其他分配可用。
next: string or null
用于获取下一页结果的游标;没有更多分配时为 null。
object: "list"
固定为 list。
"list"
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/projects/$PROJECT_ID/users/$USER_ID/roles" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY"
200 — 示例
{
"data": [
{
"id": "id",
"assignment_sources": [
{
"principal_id": "principal_id",
"principal_type": "principal_type"
}
],
"created_at": 0,
"created_by": "created_by",
"created_by_user_obj": {
"foo": "bar"
},
"description": "示例描述",
"metadata": {
"foo": "bar"
},
"name": "示例名称",
"permissions": [
"string"
],
"predefined_role": true,
"resource_type": "resource_type",
"updated_at": 0
}
],
"has_more": true,
"next": "next",
"object": "list"
}
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/projects/proj_abc123/users/user_abc123/roles" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json"
响应示例
{
"object": "list",
"data": [
{
"id": "role_01J1F8PROJ",
"name": "项目 API 密钥管理员",
"permissions": [
"api.organization.projects.api_keys.read",
"api.organization.projects.api_keys.write"
],
"resource_type": "api.project",
"predefined_role": false,
"description": "允许管理项目的 API 密钥",
"created_at": 1711471533,
"updated_at": 1711472599,
"created_by": "user_abc123",
"created_by_user_obj": {
"id": "user_abc123",
"name": "艾达·洛夫莱斯",
"email": "ada@example.com"
},
"metadata": {},
"assignment_sources": [
{
"principal_id": "user_abc123",
"principal_type": "user"
}
]
}
],
"has_more": false,
"next": null
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: