Obtener despliegue

OBTENER /api/v1/projects/{id}/deployments/{deployment_id}
Autorización del portador

Se utilizan proxies para ECP para recuperar un despliegue individual por ID con transformaciones de campo (por ejemplo, pendiente > en cola). El alcance del proyecto se define mediante el parámetro de ruta del ID, y la organización se deriva de dicho proyecto.

Parámetros de path

  • ID string Requerido

    ID del proyecto

  • id_de_despliegue string Requerido

    ID de implementación

Respuestas

  • 406

    Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.
  • 200

    OK

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • aer_http_endpoint string

      AERHTTPEndpoint es el nombre anterior del punto final HTTP del entorno aislado del agente.

    • agent_http_endpoint string

      AgentHTTPEndpoint es el punto final HTTP del entorno aislado del agente. Tiene el mismo valor que aer_http_endpoint.

    • agent_stack_name string
    • app_id string
    • sucursal string
    • ID de compilación string
    • commit_sha string
    • completed_at string
    • imágenes_componentes Objeto
      Ocultar atributos de component_images Mostrar atributos de component_images Objeto
      • aer string

        AER es el nombre anterior de la imagen del entorno aislado del agente.

      • agente string

        Agent es la imagen del entorno aislado del agente. Tiene el mismo valor que aer.

      • servidor de memoria string
      • oe string
      • Herramienta string
    • Componentes arreglo[objeto]

      Estado de cada componente: se envía tal cual desde ECP para la vista detallada.

      Ocultar atributos de componentes Mostrar los atributos de los componentes Objeto
      • available booleano
      • mensaje de error string
      • motivo de fallo string
      • Nombre string
      • réplicas listas entero
      • replicas entero

        Replicas es el número de pods deseado. Cero significa que la plataforma no ha informado de ninguno; los consumidores no deben interpretar cero como escalado a cero.

      • sandbox string

        Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos (agente, herramienta). Se omite para los nombres de origen desconocidos.

      • tipo string
    • condiciones arreglo[objeto]
      Ocultar atributos de condiciones Mostrar atributos de condiciones Objeto
      • último_tiempo_de_transición string
      • mensaje string
      • motivo string
      • Estado string
      • tipo string
    • created_at string

      Marcas de tiempo.

    • id_de_despliegue string

      Identidad y estado central (siempre presente).

    • duración_ms entero
    • mensaje de error string

      Contexto de fallo: se muestra para que las interfaces de usuario de administración puedan priorizar el problema sin tener que recurrir primero a Splunk.

    • tipo_ejecutor string
    • primer despliegue booleano

      FirstDeploy se cumple en cada intento hasta (e incluyendo) el primer despliegue exitoso del espacio de trabajo. Se omite cuando se desconoce.

    • salud Objeto

      Campos extendidos.

      Ocultar atributos de salud Mostrar atributos de salud Objeto
      • available booleano
      • comprobado_en string
      • Componentes arreglo[objeto]
        Ocultar atributos de componentes Mostrar los atributos de los componentes Objeto
        • Nombre string
        • Listo booleano
        • réplicas listas entero
        • sandbox string

          Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos (agente, herramienta). Se omite para los nombres de origen desconocidos.

    • imagen_uri string

      Imagen / fuente.

    • Idioma string

      El lenguaje es el lenguaje de ejecución del agente ("python" | "typescript"), proporcionado por ECP. Se omite cuando no se especifica (las versiones anteriores usan python por defecto).

    • last_event_seq entero
    • memoria habilitada booleano

      MemoryEnabled es la configuración de memoria efectiva en tiempo de ejecución de la implementación. Se omite cuando no está disponible.

    • secretos perdidos array[string]
    • operator_namespace string
    • org_id string
    • mensaje_de_error_post_deploy string
    • URI de imagen anterior string
    • proyecto_eliminado booleano

      Cierto cuando el proyecto propietario del despliegue se ha eliminado de forma lógica. Siempre se emite para que los consumidores puedan ramificarse en el campo, no en su ausencia.

    • project_id string
    • número_de_lanzamiento entero

      ReleaseNumber es el identificador de versión monótono por espacio de trabajo (controla la etiqueta v{N} en la interfaz de usuario). 0/omitido para registros heredados antes de la migración de relleno.

    • imágenes_solicitadas arreglo[objeto]

      RequestedImages es una intención de despliegue anclada al resumen. Se omite para despliegues heredados creados antes de que se habilitara el seguimiento del resumen de imágenes; [] significa que el escritor se ejecutó pero no resolvió nada.

      Ocultar los atributos de requested_images Mostrar atributos de requested_images Objeto
      • componente string
      • digest string
      • sandbox string

        Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos. Se omite para los nombres de origen desconocidos.

    • ID de destino solicitado string

      RequestedTargetID es un identificador interno de la flota y no se muestra intencionadamente en las respuestas de Gateway. Permanece vacío por motivos de compatibilidad.

    • rollback_error string
    • rollback_from_id string

      establecido cuando se revirtió esta implementación

    • rollback_of string

      Mecanismo de retroceso.

    • enviado_en_lanzamiento string

      ShippedInRelease es la versión que envió esta implementación. Se omite cuando no pertenece a ninguna. Reenviado desde ECP; derivado en el momento de la lectura.

    • source_build_id string
    • ID del proyecto de origen string
    • ID de promoción de origen string
    • source_workspace_id string
    • comenzó_en string
    • Estado string
    • espacio_de_nombres_destino string

      Ubicación de Kubernetes.

    • Activador string
    • updated_at string
    • Versión string

      La versión es la versión del agente declarada por el desarrollador y enviada desde ECP. Se omite para los registros sin versión.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • aer_http_endpoint string

      AERHTTPEndpoint es el nombre anterior del punto final HTTP del entorno aislado del agente.

    • agent_http_endpoint string

      AgentHTTPEndpoint es el punto final HTTP del entorno aislado del agente. Tiene el mismo valor que aer_http_endpoint.

    • agent_stack_name string
    • app_id string
    • sucursal string
    • ID de compilación string
    • commit_sha string
    • completed_at string
    • imágenes_componentes Objeto
      Ocultar atributos de component_images Mostrar atributos de component_images Objeto
      • aer string

        AER es el nombre anterior de la imagen del entorno aislado del agente.

      • agente string

        Agent es la imagen del entorno aislado del agente. Tiene el mismo valor que aer.

      • servidor de memoria string
      • oe string
      • Herramienta string
    • Componentes arreglo[objeto]

      Estado de cada componente: se envía tal cual desde ECP para la vista detallada.

      Ocultar atributos de componentes Mostrar los atributos de los componentes Objeto
      • available booleano
      • mensaje de error string
      • motivo de fallo string
      • Nombre string
      • réplicas listas entero
      • replicas entero

        Replicas es el número de pods deseado. Cero significa que la plataforma no ha informado de ninguno; los consumidores no deben interpretar cero como escalado a cero.

      • sandbox string

        Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos (agente, herramienta). Se omite para los nombres de origen desconocidos.

      • tipo string
    • condiciones arreglo[objeto]
      Ocultar atributos de condiciones Mostrar atributos de condiciones Objeto
      • último_tiempo_de_transición string
      • mensaje string
      • motivo string
      • Estado string
      • tipo string
    • created_at string

      Marcas de tiempo.

    • id_de_despliegue string

      Identidad y estado central (siempre presente).

    • duración_ms entero
    • mensaje de error string

      Contexto de fallo: se muestra para que las interfaces de usuario de administración puedan priorizar el problema sin tener que recurrir primero a Splunk.

    • tipo_ejecutor string
    • primer despliegue booleano

      FirstDeploy se cumple en cada intento hasta (e incluyendo) el primer despliegue exitoso del espacio de trabajo. Se omite cuando se desconoce.

    • salud Objeto

      Campos extendidos.

      Ocultar atributos de salud Mostrar atributos de salud Objeto
      • available booleano
      • comprobado_en string
      • Componentes arreglo[objeto]
        Ocultar atributos de componentes Mostrar los atributos de los componentes Objeto
        • Nombre string
        • Listo booleano
        • réplicas listas entero
        • sandbox string

          Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos (agente, herramienta). Se omite para los nombres de origen desconocidos.

    • imagen_uri string

      Imagen / fuente.

    • Idioma string

      El lenguaje es el lenguaje de ejecución del agente ("python" | "typescript"), proporcionado por ECP. Se omite cuando no se especifica (las versiones anteriores usan python por defecto).

    • last_event_seq entero
    • memoria habilitada booleano

      MemoryEnabled es la configuración de memoria efectiva en tiempo de ejecución de la implementación. Se omite cuando no está disponible.

    • secretos perdidos array[string]
    • operator_namespace string
    • org_id string
    • mensaje_de_error_post_deploy string
    • URI de imagen anterior string
    • proyecto_eliminado booleano

      Cierto cuando el proyecto propietario del despliegue se ha eliminado de forma lógica. Siempre se emite para que los consumidores puedan ramificarse en el campo, no en su ausencia.

    • project_id string
    • número_de_lanzamiento entero

      ReleaseNumber es el identificador de versión monótono por espacio de trabajo (controla la etiqueta v{N} en la interfaz de usuario). 0/omitido para registros heredados antes de la migración de relleno.

    • imágenes_solicitadas arreglo[objeto]

      RequestedImages es una intención de despliegue anclada al resumen. Se omite para despliegues heredados creados antes de que se habilitara el seguimiento del resumen de imágenes; [] significa que el escritor se ejecutó pero no resolvió nada.

      Ocultar los atributos de requested_images Mostrar atributos de requested_images Objeto
      • componente string
      • digest string
      • sandbox string

        Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos. Se omite para los nombres de origen desconocidos.

    • ID de destino solicitado string

      RequestedTargetID es un identificador interno de la flota y no se muestra intencionadamente en las respuestas de Gateway. Permanece vacío por motivos de compatibilidad.

    • rollback_error string
    • rollback_from_id string

      establecido cuando se revirtió esta implementación

    • rollback_of string

      Mecanismo de retroceso.

    • enviado_en_lanzamiento string

      ShippedInRelease es la versión que envió esta implementación. Se omite cuando no pertenece a ninguna. Reenviado desde ECP; derivado en el momento de la lectura.

    • source_build_id string
    • ID del proyecto de origen string
    • ID de promoción de origen string
    • source_workspace_id string
    • comenzó_en string
    • Estado string
    • espacio_de_nombres_destino string

      Ubicación de Kubernetes.

    • Activador string
    • updated_at string
    • Versión string

      La versión es la versión del agente declarada por el desarrollador y enviada desde ECP. Se omite para los registros sin versión.
  • 400

    Solicitud incorrecta

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 403

    Forbidden

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 502

    Puerta de enlace incorrecta

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
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"
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}