조직 정책 출시 상태 가져오기

얻다 /api/v1/organizations/{id}/poliencies/rollout

베어러 인증

조직 의 모든 프로젝트 에서 최신 플랫폼 정책 생성을 실행 중인지 보고하며, 게이트웨이가 아직 구체화되지 않은 프로젝트와 데이터 플레인이 아직 승인하지 않은 프로젝트를 구분합니다.

경로 매개변수

id 문자열 필수 사항

조직 ID

응답

406

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  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

확인
응답 속성 숨기기 응답 속성 표시 객체
- 수렴 integer
- Dead_lettered integer
- lagging_projects 배열[객체]
  
  LagingProjects는 최신 세대 뒤에 있는 프로젝트를 샘플링하며, 최대치는 정책 롤아웃 지연 프로젝트 제한입니다. 잘림은 샘플 부분적인지 여부를 보고합니다.
  
  lagging_projects 속성 숨기기 lagging_projects 속성 표시 객체
  
  시도 integer
  
  Dead_lettered 부울
  
  Failure_ Kind 문자열
  
  FailureKind는 원시 원인이 아닌 안정적인 분류입니다. 기본 오류에는 운전자 및 인프라 세부 정보가 포함될 수 있으며 모든 조직 구성원이 이 경로에 연결할 수 있으므로 원본 텍스트는 연산자를 위해 문서 와 로그에 유지됩니다.
  
  생성 integer
  
  생성은 프로젝트 에 대해 구체화된 최신 런타임 생성이며 ReceivedGeneration 은 ECP가 승인한 최신 생성입니다. 변경 사항이 데이터 영역으로 이동하는 동안에는 다릅니다.
  
  PROJECT_ID 문자열
  
  이유 문자열
  
  Received_generation integer
- missing_config integer
  
  MissingConfig는 런타임 구성이 전혀 없는 활성 프로젝트의 수를 계산합니다. 조직에 정책이 없는 경우에 예상됩니다(실체화할 것이 없음). 그렇지 않으면 격차가 발생하므로 수렴으로 접히지 않고 보고됩니다.
- org_id 문자열
- 보류 중인_물질화 integer
- 보류 중인_게시 integer
- projects_total integer
  
  ProjectsTotal은 런타임 구성 행이 아닌 조직의 활성 프로젝트를 계산하므로 구체화되지 않은 프로젝트 여전히 분모에 표시됩니다.
- 잘린 부울
응답 속성 숨기기 응답 속성 표시 객체
- 수렴 integer
- Dead_lettered integer
- lagging_projects 배열[객체]
  
  LagingProjects는 최신 세대 뒤에 있는 프로젝트를 샘플링하며, 최대치는 정책 롤아웃 지연 프로젝트 제한입니다. 잘림은 샘플 부분적인지 여부를 보고합니다.
  
  lagging_projects 속성 숨기기 lagging_projects 속성 표시 객체
  
  시도 integer
  
  Dead_lettered 부울
  
  Failure_ Kind 문자열
  
  FailureKind는 원시 원인이 아닌 안정적인 분류입니다. 기본 오류에는 운전자 및 인프라 세부 정보가 포함될 수 있으며 모든 조직 구성원이 이 경로에 연결할 수 있으므로 원본 텍스트는 연산자를 위해 문서 와 로그에 유지됩니다.
  
  생성 integer
  
  생성은 프로젝트 에 대해 구체화된 최신 런타임 생성이며 ReceivedGeneration 은 ECP가 승인한 최신 생성입니다. 변경 사항이 데이터 영역으로 이동하는 동안에는 다릅니다.
  
  PROJECT_ID 문자열
  
  이유 문자열
  
  Received_generation integer
- missing_config integer
  
  MissingConfig는 런타임 구성이 전혀 없는 활성 프로젝트의 수를 계산합니다. 조직에 정책이 없는 경우에 예상됩니다(실체화할 것이 없음). 그렇지 않으면 격차가 발생하므로 수렴으로 접히지 않고 보고됩니다.
- org_id 문자열
- 보류 중인_물질화 integer
- 보류 중인_게시 integer
- projects_total integer
  
  ProjectsTotal은 런타임 구성 행이 아닌 조직의 활성 프로젝트를 계산하므로 구체화되지 않은 프로젝트 여전히 분모에 표시됩니다.
- 잘린 부울
400

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

잘못된 요청
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- 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}/poliencies/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
}