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
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号