创建项目服务帐户

发布 /api/v1/projects/{id}/service-accounts
持有者身份验证

创建项目范围的客户服务帐户并返回其密钥一次。角色只接受一个名称：PROJECT_OWNER、PROJECT_READ_ONLY 或 AGENT_DEVELOPER。 PROJECT_MEMBER 仍被接受。 role_signments 与存储的助手引擎角色相呼应。需要 PROJECT_OWNER；所属组织的 ORG_ADMIN 也会通过。

路径参数

  • id 字符串 必需

    项目 ID

application/json

body 必需

创建请求

  • 描述 字符串

    最大长度为 500。

  • ip_access_list array[string]

    可选IP/CIDR 白名单。为空或省略表示不受限制。最多 100 个条目。

    不超过 100 个元素。

  • 名称 字符串 必需

    最大长度为 100。

  • 角色 array[string] 必需

    Roles 是初始角色设立。只需要一个角色。组织帐户接受 ORG_GROUP_CREATOR 或 ORG_READ_ONLY。项目帐户接受 PROJECT_OWNER、PROJECT_READ_ONLY 或 AGENT_DEVELOPER。仍接受旧版代理引擎名称（ORG_ADMIN、ORG_MEMBER、PROJECT_MEMBER）。 role_signments 回显这些名称解析为的存储的代理引擎角色。

    至少 1 个但不超过 1 个元素。

  • secret_expires_after_hours 整型

    可选密钥TTL （以小时为单位）。省略时默认为 2160（90 天）。

响应

  • 406

    不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。

    隐藏响应属性 显示响应属性 对象
    • badRequestDetail 对象

      标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

      隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象
      • 字段 大量[对象]

        验证失败的字段。

        隐藏字段属性 显示字段属性 对象

        字段及其验证失败。

        • 描述 字符串 必需

          人类可读的验证失败。

        • 字段 字符串 必需

          无效请求字段的名称或路径。

    • 详细信息 字符串 必需

      人类可读的错误详细信息。

    • 错误 整型 必需

      HTTP status code.

    • 错误代码 字符串 必需

      机器可读的错误代码。

    • 参数 array[string]

      与错误相关的请求参数名称；不应用时省略。

    • 原因 字符串 必需

      HTTP状态原因短语。

    隐藏响应属性 显示响应属性 对象
    • badRequestDetail 对象

      标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

      隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象
      • 字段 大量[对象]

        验证失败的字段。

        隐藏字段属性 显示字段属性 对象

        字段及其验证失败。

        • 描述 字符串 必需

          人类可读的验证失败。

        • 字段 字符串 必需

          无效请求字段的名称或路径。

    • 详细信息 字符串 必需

      人类可读的错误详细信息。

    • 错误 整型 必需

      HTTP status code.

    • 错误代码 字符串 必需

      机器可读的错误代码。

    • 参数 array[string]

      与错误相关的请求参数名称；不应用时省略。

    • 原因 字符串 必需

      HTTP状态原因短语。
  • 201

    已创建

    隐藏响应属性 显示响应属性 对象
    • client_secret 字符串
    • service_account 对象
      隐藏 service_account 属性 显示 service_account 属性 对象
      • active_secret 对象
        隐藏 Active_Secret 属性 显示active_secret 属性 对象
        • created_at 字符串
        • expires_at 字符串
        • last_used_at 字符串
        • masked_value 字符串
      • client_id 字符串
      • created_at 字符串
      • 描述 字符串
      • id 字符串
      • ip_access_list array[string]
      • is_active 布尔
      • is_system_managed 布尔
      • 名称 字符串
      • org_id 字符串
      • 所有者 字符串
      • PROJECT_ID 字符串
      • role_signments 大量[对象]
        隐藏 role_signments 属性 显示 role_signments 属性 对象
        • org_id 字符串
        • PROJECT_ID 字符串
        • 角色 字符串
      • 类型 字符串
      • updated_at 字符串
    隐藏响应属性 显示响应属性 对象
    • client_secret 字符串
    • service_account 对象
      隐藏 service_account 属性 显示 service_account 属性 对象
      • active_secret 对象
        隐藏 Active_Secret 属性 显示active_secret 属性 对象
        • created_at 字符串
        • expires_at 字符串
        • last_used_at 字符串
        • masked_value 字符串
      • client_id 字符串
      • created_at 字符串
      • 描述 字符串
      • id 字符串
      • ip_access_list array[string]
      • is_active 布尔
      • is_system_managed 布尔
      • 名称 字符串
      • org_id 字符串
      • 所有者 字符串
      • PROJECT_ID 字符串
      • role_signments 大量[对象]
        隐藏 role_signments 属性 显示 role_signments 属性 对象
        • org_id 字符串
        • PROJECT_ID 字符串
        • 角色 字符串
      • 类型 字符串
      • updated_at 字符串
  • 400

    Bad Request

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 403

    Forbidden

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 404

    未找到

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 409

    冲突

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 429

    请求过多

    隐藏标头属性 显示标头属性
    • 重试后 字符串

      重试前等待的秒数

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 500

    内部服务器错误

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 503

    服务不可用

    隐藏标头属性 显示标头属性
    • 重试后 字符串

      重试前等待的秒数

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
POST /api/v1/projects/{id}/service-accounts 
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/service-accounts' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "description": "string",
  "ip_access_list": [
    "string"
  ],
  "name": "string",
  "roles": [
    "string"
  ],
  "secret_expires_after_hours": 42
}'
请求示例 
{
  "description": "string",
  "ip_access_list": [
    "string"
  ],
  "name": "string",
  "roles": [
    "string"
  ],
  "secret_expires_after_hours": 42
}
响应示例 (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
响应示例 (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
响应示例 (201) 
{
  "client_secret": "string",
  "service_account": {
    "active_secret": {
      "created_at": "string",
      "expires_at": "string",
      "last_used_at": "string",
      "masked_value": "string"
    },
    "client_id": "string",
    "created_at": "string",
    "description": "string",
    "id": "string",
    "ip_access_list": [
      "string"
    ],
    "is_active": true,
    "is_system_managed": true,
    "name": "string",
    "org_id": "string",
    "owner": "string",
    "project_id": "string",
    "role_assignments": [
      {
        "org_id": "string",
        "project_id": "string",
        "role": "string"
      }
    ],
    "type": "string",
    "updated_at": "string"
  }
}
响应示例 (201) 
{
  "client_secret": "string",
  "service_account": {
    "active_secret": {
      "created_at": "string",
      "expires_at": "string",
      "last_used_at": "string",
      "masked_value": "string"
    },
    "client_id": "string",
    "created_at": "string",
    "description": "string",
    "id": "string",
    "ip_access_list": [
      "string"
    ],
    "is_active": true,
    "is_system_managed": true,
    "name": "string",
    "org_id": "string",
    "owner": "string",
    "project_id": "string",
    "role_assignments": [
      {
        "org_id": "string",
        "project_id": "string",
        "role": "string"
      }
    ],
    "type": "string",
    "updated_at": "string"
  }
}
响应示例 (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (409) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (409) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (429) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (429) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (503) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (503) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}