워크스페이스 배포 나열

얻다 /api/v1/projects/{id}/workspaces/{workspace_id}/deployments
베어러 인증

커서 기반 페이지 매김 및 선택적 상태 필터하다 사용하여 작업 공간에 대한 배포를 나열하기 위해 ECP에 프록시합니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.

경로 매개변수

  • id 문자열 필수 사항

    프로젝트 ID

  • Workspace_id 문자열 필수 사항

    작업 공간 ID

쿼리 매개변수

  • cursor 문자열

    불투명 페이지 커서

  • limit integer

    페이지 크기(1-100, 기본값 20)

  • 상태 문자열

    배포 상태 필터하다 (queueed, in_progress, 정리_업, 성공, 실패, 롤백, 취소됨)

  • 선적된_인_릴리스 문자열

    이 출시하다 에 제공된 배포를 반환합니다: 자체 아티팩트 배포와 중단되기 전에 도착한 비릴리스 배포를 반환합니다. 롤백은 제외됩니다.

응답

  • 406

    지원되지 않거나 잘못된 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

    확인

    응답 속성 숨기기 응답 속성 표시 객체
    • 배포서버 배열[객체]
      배포 속성 숨기기 배포 속성 표시 객체
      • aer_http_endpoint 문자열

        AERHTTPEndpoint는 에이전트 샌드박스 HTTP 엔드포인트의 레거시 이름입니다.

      • agent_http_endpoint 문자열

        AgentHTTPEndpoint는 에이전트 샌드박스 HTTP 엔드포인트입니다. aer_http_endpoint와 동일한 값입니다.

      • agent_stack_name 문자열
      • app_id 문자열
      • 호환성 테스트 업데이트 문자열
      • build_id 문자열
      • commit_sha 문자열
      • completed_at 문자열
      • components_images 객체
        component_images 속성 숨기기 component_images 속성 표시 객체
        • aer 문자열

          AER은 에이전트 샌드박스 이미지의 레거시 이름입니다.

        • 에이전트 문자열

          Agent는 에이전트 샌드박스 이미지입니다. aer와 동일한 값입니다.

        • Memory_server 문자열
        • oe 문자열
        • 도구 문자열
      • 구성 요소 배열[객체]

        구성 요소별 상태 - 세부 정보 보기를 위해 ECP에서 있는 그대로 전달됩니다.

        구성 요소 속성 숨기기 구성 요소 속성 표시 객체
        • available 부울
        • fail_message 문자열
        • Failure_reason 문자열
        • 이름 문자열
        • 준비된 복제본 integer
        • 복제본 integer

          복제본은 원하는 파드 수입니다. 0은 플랫폼이 보고하지 않았음을 의미합니다. 소비자는 0을 scale-to-0으로 취급해서는 안 됩니다.

        • sandbox 문자열

          샌드박스는 알려진 구성 요소 값(에이전트, 도구)에 대한 표준 샌드박스 이름입니다. 알 수 없는 업스트림 이름은 생략합니다.

        • 유형 문자열
      • 조건 배열[객체]
        조건 속성 숨기기 조건 속성 표시 객체
        • last_transition_time 문자열
        • 메시지 문자열
        • 이유 문자열
        • 상태 문자열
        • 유형 문자열
      • created_at 문자열

        타임스탬프.

      • deployment_id 문자열

        ID & 핵심 상태(항상 존재).

      • duration_ms integer
      • error_message 문자열

        실패 컨텍스트 - 관리자 UI가 Splunk로 먼저 이동하지 않고도 분류할 수 있도록 표시되었습니다.

      • executor_type 문자열
      • first_deploy 부울

        FirstDeploy 는 작업 공간의 첫 번째 성공적인 배포 까지 (포함)까지 모든 시도에 대해 true입니다. 알 수 없는 경우 생략됩니다.

      • 건강 객체

        확장 필드.

        상태 속성 숨기기 상태 속성 표시 객체
        • available 부울
        • check_at 문자열
        • 구성 요소 배열[객체]
          구성 요소 속성 숨기기 구성 요소 속성 표시 객체
          • 이름 문자열
          • 준비됨 부울
          • 준비된 복제본 integer
          • sandbox 문자열

            샌드박스는 알려진 구성 요소 값(에이전트, 도구)에 대한 표준 샌드박스 이름입니다. 알 수 없는 업스트림 이름은 생략합니다.

      • 이미지_우리 문자열

        이미지/소스.

      • 언어 문자열

        Language는 ECP에서 전달된 에이전트 런타임 언어 ('python' | 설정되지 않은 경우 생략됩니다(이전 빌드는 기본값 Python 다운스트림으로 설정됨).

      • last_event_seq integer
      • Memory_Enabled 부울

        MemoryEnabled는 배포의 효과적인 런타임 메모리 설정입니다. 사용할 수 없는 경우 생략됩니다.

      • missing_secrets array[string]
      • operator_namespace 문자열
      • org_id 문자열
      • post_deploy_error_message 문자열
      • 이전_이미지_우리 문자열
      • project_deleted 부울

        배포를 소유한 프로젝트 일시 삭제된 경우 true입니다. 소비자가 필드의 부재가 아닌 필드 에서 분기할 수 있도록 항상 방출됩니다.

      • PROJECT_ID 문자열
      • release_number integer

        ReleaseNumber는 작업 공간별 단조적 버전 식별자입니다( UI 에서 v{N} 레이블을 구동합니다). 백필 마이그레이션 전 레거시 레코드의 경우 0/생략 .

      • requests_images 배열[객체]

        RequestedImages는 다이제스트 고정 배포 의도입니다. 이미지 다이제스트 추적이 활성화되기 전에 생성된 레거시 배포의 경우 생략됩니다. []는 작성자가 실행되었지만 아무 것도 해결되지 않았음을 의미합니다.

        requests_images 속성 숨기기 requests_images 속성 표시 객체
        • 구성 요소 문자열
        • 다이제스트 문자열
        • sandbox 문자열

          샌드박스는 알려진 구성 요소 값에 대한 표준 샌드박스 이름입니다. 알 수 없는 업스트림 이름은 생략합니다.

      • requests_target_id 문자열

        RequestedTargetID는 내부 플릿 출처이며 게이트웨이 응답에 의도적으로 표시되지 않습니다. 호환성을 위해 비어 있는 상태로 유지됩니다.

      • rollback_error 문자열
      • rollback_from_id 문자열

        이 배포서버 다음에서 롤백될 때 설정하다 .

      • rollback_of 문자열

        롤백 연결.

      • 선적된_인_릴리스 문자열

        ShippedInRelease는 이 배포서버 제공한 출시하다 입니다. none에 속할 경우 생략됩니다. ECP에서 전달. 읽기 시 파생됩니다.

      • source_build_id 문자열
      • source_project_id 문자열
      • source_promotion_id 문자열
      • source_workspace_id 문자열
      • started_at 문자열
      • 상태 문자열
      • target_namespace 문자열

        Kubernetes 배치.

      • 트리거 문자열
      • updated_at 문자열
      • 버전 문자열

        버전은 ECP에서 전달된 개발자 선언 에이전트 버전입니다. 버전이 없는 레코드의 경우 생략됩니다.

    • limit integer

      오프셋 페이지로 매긴 플랫폼 전체 관리자 목록에 의해 설정됩니다. 작업 공간별 엔드포인트는 이러한 값을 0으로 유지하며 와이어에서 생략됩니다.

    • Next_cursor 문자열

      커서 페이지를 매긴 작업 공간별 관리자 목록으로 설정합니다. 플랫폼 전체 엔드포인트는 nil로 둡니다.

    • 오프셋 integer
    • 합계 integer
    응답 속성 숨기기 응답 속성 표시 객체
    • 배포서버 배열[객체]
      배포 속성 숨기기 배포 속성 표시 객체
      • aer_http_endpoint 문자열

        AERHTTPEndpoint는 에이전트 샌드박스 HTTP 엔드포인트의 레거시 이름입니다.

      • agent_http_endpoint 문자열

        AgentHTTPEndpoint는 에이전트 샌드박스 HTTP 엔드포인트입니다. aer_http_endpoint와 동일한 값입니다.

      • agent_stack_name 문자열
      • app_id 문자열
      • 호환성 테스트 업데이트 문자열
      • build_id 문자열
      • commit_sha 문자열
      • completed_at 문자열
      • components_images 객체
        component_images 속성 숨기기 component_images 속성 표시 객체
        • aer 문자열

          AER은 에이전트 샌드박스 이미지의 레거시 이름입니다.

        • 에이전트 문자열

          Agent는 에이전트 샌드박스 이미지입니다. aer와 동일한 값입니다.

        • Memory_server 문자열
        • oe 문자열
        • 도구 문자열
      • 구성 요소 배열[객체]

        구성 요소별 상태 - 세부 정보 보기를 위해 ECP에서 있는 그대로 전달됩니다.

        구성 요소 속성 숨기기 구성 요소 속성 표시 객체
        • available 부울
        • fail_message 문자열
        • Failure_reason 문자열
        • 이름 문자열
        • 준비된 복제본 integer
        • 복제본 integer

          복제본은 원하는 파드 수입니다. 0은 플랫폼이 보고하지 않았음을 의미합니다. 소비자는 0을 scale-to-0으로 취급해서는 안 됩니다.

        • sandbox 문자열

          샌드박스는 알려진 구성 요소 값(에이전트, 도구)에 대한 표준 샌드박스 이름입니다. 알 수 없는 업스트림 이름은 생략합니다.

        • 유형 문자열
      • 조건 배열[객체]
        조건 속성 숨기기 조건 속성 표시 객체
        • last_transition_time 문자열
        • 메시지 문자열
        • 이유 문자열
        • 상태 문자열
        • 유형 문자열
      • created_at 문자열

        타임스탬프.

      • deployment_id 문자열

        ID & 핵심 상태(항상 존재).

      • duration_ms integer
      • error_message 문자열

        실패 컨텍스트 - 관리자 UI가 Splunk로 먼저 이동하지 않고도 분류할 수 있도록 표시되었습니다.

      • executor_type 문자열
      • first_deploy 부울

        FirstDeploy 는 작업 공간의 첫 번째 성공적인 배포 까지 (포함)까지 모든 시도에 대해 true입니다. 알 수 없는 경우 생략됩니다.

      • 건강 객체

        확장 필드.

        상태 속성 숨기기 상태 속성 표시 객체
        • available 부울
        • check_at 문자열
        • 구성 요소 배열[객체]
          구성 요소 속성 숨기기 구성 요소 속성 표시 객체
          • 이름 문자열
          • 준비됨 부울
          • 준비된 복제본 integer
          • sandbox 문자열

            샌드박스는 알려진 구성 요소 값(에이전트, 도구)에 대한 표준 샌드박스 이름입니다. 알 수 없는 업스트림 이름은 생략합니다.

      • 이미지_우리 문자열

        이미지/소스.

      • 언어 문자열

        Language는 ECP에서 전달된 에이전트 런타임 언어 ('python' | 설정되지 않은 경우 생략됩니다(이전 빌드는 기본값 Python 다운스트림으로 설정됨).

      • last_event_seq integer
      • Memory_Enabled 부울

        MemoryEnabled는 배포의 효과적인 런타임 메모리 설정입니다. 사용할 수 없는 경우 생략됩니다.

      • missing_secrets array[string]
      • operator_namespace 문자열
      • org_id 문자열
      • post_deploy_error_message 문자열
      • 이전_이미지_우리 문자열
      • project_deleted 부울

        배포를 소유한 프로젝트 일시 삭제된 경우 true입니다. 소비자가 필드의 부재가 아닌 필드 에서 분기할 수 있도록 항상 방출됩니다.

      • PROJECT_ID 문자열
      • release_number integer

        ReleaseNumber는 작업 공간별 단조적 버전 식별자입니다( UI 에서 v{N} 레이블을 구동합니다). 백필 마이그레이션 전 레거시 레코드의 경우 0/생략 .

      • requests_images 배열[객체]

        RequestedImages는 다이제스트 고정 배포 의도입니다. 이미지 다이제스트 추적이 활성화되기 전에 생성된 레거시 배포의 경우 생략됩니다. []는 작성자가 실행되었지만 아무 것도 해결되지 않았음을 의미합니다.

        requests_images 속성 숨기기 requests_images 속성 표시 객체
        • 구성 요소 문자열
        • 다이제스트 문자열
        • sandbox 문자열

          샌드박스는 알려진 구성 요소 값에 대한 표준 샌드박스 이름입니다. 알 수 없는 업스트림 이름은 생략합니다.

      • requests_target_id 문자열

        RequestedTargetID는 내부 플릿 출처이며 게이트웨이 응답에 의도적으로 표시되지 않습니다. 호환성을 위해 비어 있는 상태로 유지됩니다.

      • rollback_error 문자열
      • rollback_from_id 문자열

        이 배포서버 다음에서 롤백될 때 설정하다 .

      • rollback_of 문자열

        롤백 연결.

      • 선적된_인_릴리스 문자열

        ShippedInRelease는 이 배포서버 제공한 출시하다 입니다. none에 속할 경우 생략됩니다. ECP에서 전달. 읽기 시 파생됩니다.

      • source_build_id 문자열
      • source_project_id 문자열
      • source_promotion_id 문자열
      • source_workspace_id 문자열
      • started_at 문자열
      • 상태 문자열
      • target_namespace 문자열

        Kubernetes 배치.

      • 트리거 문자열
      • updated_at 문자열
      • 버전 문자열

        버전은 ECP에서 전달된 개발자 선언 에이전트 버전입니다. 버전이 없는 레코드의 경우 생략됩니다.

    • limit integer

      오프셋 페이지로 매긴 플랫폼 전체 관리자 목록에 의해 설정됩니다. 작업 공간별 엔드포인트는 이러한 값을 0으로 유지하며 와이어에서 생략됩니다.

    • Next_cursor 문자열

      커서 페이지를 매긴 작업 공간별 관리자 목록으로 설정합니다. 플랫폼 전체 엔드포인트는 nil로 둡니다.

    • 오프셋 integer
    • 합계 integer
  • 400

    잘못된 요청

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 403

    Forbidden

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 502

    잘못된 게이트웨이

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
GET /api/v1/projects/{id}/workspaces/{workspace_id}/deployments 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/deployments' \
 --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) 
{
  "deployments": [
    {
      "aer_http_endpoint": "string",
      "agent_http_endpoint": "string",
      "agent_stack_name": "string",
      "app_id": "string",
      "branch": "string",
      "build_id": "string",
      "commit_sha": "string",
      "completed_at": "string",
      "component_images": {
        "aer": "string",
        "agent": "string",
        "memory_server": "string",
        "oe": "string",
        "tool": "string"
      },
      "components": [
        {
          "available": true,
          "failure_message": "string",
          "failure_reason": "string",
          "name": "string",
          "ready_replicas": 42,
          "replicas": 42,
          "sandbox": "string",
          "type": "string"
        }
      ],
      "conditions": [
        {
          "last_transition_time": "string",
          "message": "string",
          "reason": "string",
          "status": "string",
          "type": "string"
        }
      ],
      "created_at": "string",
      "deployment_id": "string",
      "duration_ms": 42,
      "error_message": "string",
      "executor_type": "string",
      "first_deploy": true,
      "health": {
        "available": true,
        "checked_at": "string",
        "components": [
          {
            "name": "string",
            "ready": true,
            "ready_replicas": 42,
            "sandbox": "string"
          }
        ]
      },
      "image_uri": "string",
      "language": "string",
      "last_event_seq": 42,
      "memory_enabled": true,
      "missing_secrets": [
        "string"
      ],
      "operator_namespace": "string",
      "org_id": "string",
      "post_deploy_error_message": "string",
      "previous_image_uri": "string",
      "project_deleted": true,
      "project_id": "string",
      "release_number": 42,
      "requested_images": [
        {
          "component": "string",
          "digest": "string",
          "sandbox": "string"
        }
      ],
      "requested_target_id": "string",
      "rollback_error": "string",
      "rollback_from_id": "string",
      "rollback_of": "string",
      "shipped_in_release": "string",
      "source_build_id": "string",
      "source_project_id": "string",
      "source_promotion_id": "string",
      "source_workspace_id": "string",
      "started_at": "string",
      "status": "string",
      "target_namespace": "string",
      "trigger": "string",
      "updated_at": "string",
      "version": "string"
    }
  ],
  "limit": 42,
  "next_cursor": "string",
  "offset": 42,
  "total": 42
}
응답 예시(200) 
{
  "deployments": [
    {
      "aer_http_endpoint": "string",
      "agent_http_endpoint": "string",
      "agent_stack_name": "string",
      "app_id": "string",
      "branch": "string",
      "build_id": "string",
      "commit_sha": "string",
      "completed_at": "string",
      "component_images": {
        "aer": "string",
        "agent": "string",
        "memory_server": "string",
        "oe": "string",
        "tool": "string"
      },
      "components": [
        {
          "available": true,
          "failure_message": "string",
          "failure_reason": "string",
          "name": "string",
          "ready_replicas": 42,
          "replicas": 42,
          "sandbox": "string",
          "type": "string"
        }
      ],
      "conditions": [
        {
          "last_transition_time": "string",
          "message": "string",
          "reason": "string",
          "status": "string",
          "type": "string"
        }
      ],
      "created_at": "string",
      "deployment_id": "string",
      "duration_ms": 42,
      "error_message": "string",
      "executor_type": "string",
      "first_deploy": true,
      "health": {
        "available": true,
        "checked_at": "string",
        "components": [
          {
            "name": "string",
            "ready": true,
            "ready_replicas": 42,
            "sandbox": "string"
          }
        ]
      },
      "image_uri": "string",
      "language": "string",
      "last_event_seq": 42,
      "memory_enabled": true,
      "missing_secrets": [
        "string"
      ],
      "operator_namespace": "string",
      "org_id": "string",
      "post_deploy_error_message": "string",
      "previous_image_uri": "string",
      "project_deleted": true,
      "project_id": "string",
      "release_number": 42,
      "requested_images": [
        {
          "component": "string",
          "digest": "string",
          "sandbox": "string"
        }
      ],
      "requested_target_id": "string",
      "rollback_error": "string",
      "rollback_from_id": "string",
      "rollback_of": "string",
      "shipped_in_release": "string",
      "source_build_id": "string",
      "source_project_id": "string",
      "source_promotion_id": "string",
      "source_workspace_id": "string",
      "started_at": "string",
      "status": "string",
      "target_namespace": "string",
      "trigger": "string",
      "updated_at": "string",
      "version": "string"
    }
  ],
  "limit": 42,
  "next_cursor": "string",
  "offset": 42,
  "total": 42
}
응답 예시(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
}
응답 예시(502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(502) 
{
  "code": "string",
  "error": "string",
  "success": true
}