배포서버 가져오기

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

필드 변환이 있는 단일 배포서버 ID 별로 조회 위해 ECP에 프록시합니다(예: 보류 중 -> 대기 중). 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.

경로 매개변수

  • id 문자열 필수 사항

    프로젝트 ID

  • deployment_id 문자열 필수 사항

    deploymentId

응답

  • 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에서 전달된 개발자 선언 에이전트 버전입니다. 버전이 없는 레코드의 경우 생략됩니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • 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에서 전달된 개발자 선언 에이전트 버전입니다. 버전이 없는 레코드의 경우 생략됩니다.
  • 400

    잘못된 요청

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

    Forbidden

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

    잘못된 게이트웨이

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
GET /api/v1/projects/{id}/deployments/{deployment_id} 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/deployments/{deployment_id}' \
 --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) 
{
  "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"
}
응답 예시(200) 
{
  "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"
}
응답 예시(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
}