获取组织策略部署状态

获取 /api/v1/organizations/{id}/policies/rollout

持有者身份验证

报告组织中是否每个项目都在运行最新的平台策略生成，将网关尚未实现的项目与数据平面尚未确认的项目区分开来。

路径参数

id 字符串必需

组织 ID

响应

406

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。
隐藏响应属性显示响应属性对象
- badRequestDetail 对象
  
  标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。
  
  隐藏 BadRequestDetail 属性显示 BadRequestDetail 属性对象
  
  字段大量[对象]
  
  验证失败的字段。
  
  隐藏字段属性显示字段属性对象
  
  字段及其验证失败。
  
  描述字符串必需
  
  人类可读的验证失败。
  
  字段字符串必需
  
  无效请求字段的名称或路径。
- 详细信息字符串必需
  
  人类可读的错误详细信息。
- 错误整型必需
  
  HTTP status code.
- 错误代码字符串必需
  
  机器可读的错误代码。
- 参数 array[string]
  
  与错误相关的请求参数名称；不应用时省略。
- 原因字符串必需
  
  HTTP状态原因短语。
隐藏响应属性显示响应属性对象
- badRequestDetail 对象
  
  标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。
  
  隐藏 BadRequestDetail 属性显示 BadRequestDetail 属性对象
  
  字段大量[对象]
  
  验证失败的字段。
  
  隐藏字段属性显示字段属性对象
  
  字段及其验证失败。
  
  描述字符串必需
  
  人类可读的验证失败。
  
  字段字符串必需
  
  无效请求字段的名称或路径。
- 详细信息字符串必需
  
  人类可读的错误详细信息。
- 错误整型必需
  
  HTTP status code.
- 错误代码字符串必需
  
  机器可读的错误代码。
- 参数 array[string]
  
  与错误相关的请求参数名称；不应用时省略。
- 原因字符串必需
  
  HTTP状态原因短语。
200

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

正常
隐藏响应属性显示响应属性对象
- 融合整型
- dead_lettered 整型
- laging_projects 大量[对象]
  
  LagingProjects 对最新一代背后的项目进行采样，上限为 policyRolloutLagingProjectLimit。截断报告示例是否为部分样本。
  
  隐藏 laging_projects 属性显示 lag_projects 属性对象
  
  尝试整型
  
  dead_lettered 布尔
  
  failure_kind 字符串
  
  FailureKind 是一种稳定的分类，而不是原始原因。根本的错误可以携带驾驶员和基础架构的详细信息，并且任何组织成员都可以访问此路由，因此原始文本保留在操作员的文档和日志中。
  
  生成整型
  
  生成是该项目的最新物化运行时生成，而 ReceivedGeneration 是 ECP 已确认的最新生成。当变更正在传递到数据平面时，它们会有所不同。
  
  PROJECT_ID 字符串
  
  原因字符串
  
  收到的_生成整型
- missing_config 整型
  
  MissingConfig 会对根本没有运行时配置的活动项目进行计数。当组织没有政策时（没有什么可实现的）；否则，它是一个间隙，这就是为什么它被报告而不是折叠到聚合中的原因。
- org_id 字符串
- pending_materialization 整型
- pending_publish 整型
- projects_total 整型
  
  ProjectsTotal 计算的是组织的活动项目，而不是运行时配置行，因此从未实现的项目仍会显示在分母中。
- truncated 布尔
隐藏响应属性显示响应属性对象
- 融合整型
- dead_lettered 整型
- laging_projects 大量[对象]
  
  LagingProjects 对最新一代背后的项目进行采样，上限为 policyRolloutLagingProjectLimit。截断报告示例是否为部分样本。
  
  隐藏 laging_projects 属性显示 lag_projects 属性对象
  
  尝试整型
  
  dead_lettered 布尔
  
  failure_kind 字符串
  
  FailureKind 是一种稳定的分类，而不是原始原因。根本的错误可以携带驾驶员和基础架构的详细信息，并且任何组织成员都可以访问此路由，因此原始文本保留在操作员的文档和日志中。
  
  生成整型
  
  生成是该项目的最新物化运行时生成，而 ReceivedGeneration 是 ECP 已确认的最新生成。当变更正在传递到数据平面时，它们会有所不同。
  
  PROJECT_ID 字符串
  
  原因字符串
  
  收到的_生成整型
- missing_config 整型
  
  MissingConfig 会对根本没有运行时配置的活动项目进行计数。当组织没有政策时（没有什么可实现的）；否则，它是一个间隙，这就是为什么它被报告而不是折叠到聚合中的原因。
- org_id 字符串
- pending_materialization 整型
- pending_publish 整型
- projects_total 整型
  
  ProjectsTotal 计算的是组织的活动项目，而不是运行时配置行，因此从未实现的项目仍会显示在分母中。
- truncated 布尔
400

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

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

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

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

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

内部服务器错误
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔

GET /api/v1/organizations/{id}/policies/rollout

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/organizations/{id}/policies/rollout' \
 --header "Authorization: $API_KEY"

响应示例 (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"
}

响应示例 (200)

{
  "converged": 42,
  "dead_lettered": 42,
  "lagging_projects": [
    {
      "attempts": 42,
      "dead_lettered": true,
      "failure_kind": "string",
      "generation": 42,
      "project_id": "string",
      "reason": "string",
      "received_generation": 42
    }
  ],
  "missing_config": 42,
  "org_id": "string",
  "pending_materialization": 42,
  "pending_publish": 42,
  "projects_total": 42,
  "truncated": true
}

响应示例 (200)

{
  "converged": 42,
  "dead_lettered": 42,
  "lagging_projects": [
    {
      "attempts": 42,
      "dead_lettered": true,
      "failure_kind": "string",
      "generation": 42,
      "project_id": "string",
      "reason": "string",
      "received_generation": 42
    }
  ],
  "missing_config": 42,
  "org_id": "string",
  "pending_materialization": 42,
  "pending_publish": 42,
  "projects_total": 42,
  "truncated": true
}

响应示例 (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
}

响应示例 (500)

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

响应示例 (500)

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