OpenAI 向群组分配项目角色

2026-11-17 18:23 更新

向群组分配项目角色

post /projects/{project_id}/groups/{group_id}/roles

在项目中向群组分配项目角色。

路径参数

  • project_id: string

要更新的项目 ID。

  • group_id: string

要接收项目角色的群组 ID。

请求体参数

内容类型:application/json

  • role_id: string

要分配的角色标识符。

返回值

  • group: object { id, created_at, name, 2 more }

角色分配响应中返回的群组概要信息。

  • id: string

群组标识符。

  • created_at: integer

群组创建时间的 Unix 时间戳,单位为秒。

format: unixtime

  • name: string

群组的显示名称。

  • object: "group"

固定为 group。

  • "group"

  • scim_managed: boolean

群组是否通过 SCIM 管理。

  • object: "group.role"

固定为 group.role。

  • "group.role"

  • role: Role

可通过公共 Roles API 分配的角色详情。

  • id: string

角色标识符。

  • description: string or null

可选的角色描述。

  • name: string

角色的唯一名称。

  • object: "role"

固定为 role。

  • "role"

  • permissions: array of string

角色授予的权限。

  • predefined_role: boolean

角色是否由 OpenAI 预定义和管理。

  • resource_type: string

角色绑定的资源类型,例如 api.organization 或 api.project。

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/projects/$PROJECT_ID/groups/$GROUP_ID/roles" \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{
          "role_id": "role_id"
        }'

200 — 示例

{
  "group": {
    "id": "id",
    "created_at": 0,
    "name": "示例名称",
    "object": "group",
    "scim_managed": true
  },
  "object": "group.role",
  "role": {
    "id": "id",
    "description": "示例描述",
    "name": "示例名称",
    "object": "role",
    "permissions": [
      "string"
    ],
    "predefined_role": true,
    "resource_type": "resource_type"
  }
}

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl -X POST "https://api.openai.com/v1/projects/proj_abc123/groups/group_01J1F8ABCDXYZ/roles" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "role_id": "role_01J1F8PROJ"
  }'

响应示例

{
    "object": "group.role",
    "group": {
        "object": "group",
        "id": "group_01J1F8ABCDXYZ",
        "name": "支持团队",
        "created_at": 1711471533,
        "scim_managed": false
    },
    "role": {
        "object": "role",
        "id": "role_01J1F8PROJ",
        "name": "项目 API 密钥管理员",
        "description": "允许管理项目的 API 密钥",
        "permissions": [
            "api.organization.projects.api_keys.read",
            "api.organization.projects.api_keys.write"
        ],
        "resource_type": "api.project",
        "predefined_role": false
    }
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号