Obter sistema

OBTER /api/v1/projects/{id}/deployments/{deployment_id}

Proxies para ECP para recuperar uma única implantação por ID com transformações de campo (por exemplo, pending -> queued). O escopo do projeto é realizado pelo parâmetro route id path e a organização é derivada desse projeto.

parâmetros de caminho

id string Obrigatório

ID do Projeto
deployment_id string Obrigatório

deploymentId

Respostas

406

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Versão de API não permitida ou malformada, uma operação indisponível no contrato publicado selecionado ou uma representação inaceitável (incluindo parâmetros de tipo de mídia não suportados ou SSE excluído). Falhas existentes de autenticação, autorização e limite de taxa têm precedência.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Campos com falhas de validação.
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Um campo e sua falha de validação.
  
  Descrição string Obrigatório
  
  Falha na validação legível por humanos.
  
  Campo string Obrigatório
  
  Nome ou caminho do campo de solicitação inválido .
- detalhe string Obrigatório
  
  Detalhes de erro legíveis por humanos.
- Erro inteiro Obrigatório
  
  HTTP status code.
- Código de erro string Obrigatório
  
  Código de erro legível por máquina.
- Parâmetros array[string]
  
  Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.
- Razão string Obrigatório
  
  Frase de razão do status HTTP.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Campos com falhas de validação.
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Um campo e sua falha de validação.
  
  Descrição string Obrigatório
  
  Falha na validação legível por humanos.
  
  Campo string Obrigatório
  
  Nome ou caminho do campo de solicitação inválido .
- detalhe string Obrigatório
  
  Detalhes de erro legíveis por humanos.
- Erro inteiro Obrigatório
  
  HTTP status code.
- Código de erro string Obrigatório
  
  Código de erro legível por máquina.
- Parâmetros array[string]
  
  Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.
- Razão string Obrigatório
  
  Frase de razão do status HTTP.
200

aplicação/vnd.agent-engine-2026-09-20-preview+json

aplicação/vnd.agent-engine-2026-09-20-preview+json aplicação/json

OK
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- aer_http_endpoint string
  
  AERHTTPEndpoint é o nome legado do endpoint HTTP da sandbox do agente .
- agent_http_endpoint string
  
  AgentHTTPEndpoint é o endpoint HTTP da sandbox do agente . O mesmo valor que aer_http_endpoint.
- agent_stack_name string
- app_id string
- branch string
- build_id string
- commit_sha string
- completed_at string
- components_images objeto
  
  Ocultar atributos de components_images Mostrar atributos de components_images objeto
  
  aer string
  
  AER é o nome legado da imagem da sandbox do agente .
  
  Agente string
  
  Agente é a imagem da sandbox do agente . O mesmo valor que aer.
  
  memory_server string
  
  oe string
  
  Ferramenta string
- Componentes array[objeto]
  
  Integridade por componente — encaminhado como está do ECP para visualização detalhada.
  
  Ocultar atributos dos componentes Mostrar atributos dos componentes objeto
  
  available booleano
  
  failure_message string
  
  failure_reason string
  
  name string
  
  read_replicas inteiro
  
  réplicas inteiro
  
  Réplicas é a contagem de pods desejada. Zero significa que a plataforma não comunicou um; os consumidores não devem tratar zero como escala para zero.
  
  sandbox string
  
  Sandbox é o nome canônico da sandbox para valores de componentes conhecidos (agente, ferramenta). Omitido para nomes upstream desconhecidos.
  
  type string
- condições array[objeto]
  
  Ocultar atributos de condições Mostrar atributos de condições objeto
  
  last_transition_time string
  
  mensagem string
  
  Razão string
  
  Status string
  
  type string
- created_at string
  
  Carimbos de data/hora.
- deployment_id string
  
  Identity & status principal ( sempre presente ).
- duration_ms inteiro
- error_message string
  
  Contexto de falha — exibido para que as UIs de administrador possam fazer a triagem sem ir primeiro ao Splunk.
- executor_type string
- first_deploy booleano
  
  O FirstDeploy é verdadeiro para todas as tentativas até (e incluindo) a primeira implantação bem-sucedida do espaço de trabalho. Omitido quando desconhecido.
- saúde objeto
  
  Campos estendidos.
  
  Ocultar atributos de integridade Mostrar atributos de integridade objeto
  
  available booleano
  
  check_at string
  
  Componentes array[objeto]
  
  Ocultar atributos dos componentes Mostrar atributos dos componentes objeto
  
  name string
  
  pronto booleano
  
  read_replicas inteiro
  
  sandbox string
  
  Sandbox é o nome canônico da sandbox para valores de componentes conhecidos (agente, ferramenta). Omitido para nomes upstream desconhecidos.
- page_uri string
  
  Imagem / fonte.
- Linguagem string
  
  Idioma é o idioma de tempo de execução do agente ("python" | "typescript"), encaminhado pelo ECP. Omitido quando não definido (as construções mais antigas são padronizadas para o python downstream).
- last_event_seq inteiro
- memory_enabled booleano
  
  MemoryEnabled é a configuração de memória de tempo de execução efetiva do sistema. Omitido quando indisponível.
- missing_secrets array[string]
- operator_namespace string
- org_id string
- post_deploy_error_message string
- anterior_imagem_uri string
- project_deleted booleano
  
  Verdadeiro quando o projeto proprietário do sistema tiver sido excluído de forma reversível. Sempre emitido para que os consumidores possam se ramificar no campo, não em sua ausência.
- PROJECT_ID string
- release_number inteiro
  
  ReleaseNumber é o identificador de versão monotônica por espaço de trabalho (conduz o rótulo v{N} na UI). 0/omitido para registros legado antes da migração de preenchimento.
- imagens_solicitadas array[objeto]
  
  RequestedImages é uma intenção de implantação fixada em resumo. Omitido para sistemas legado criados antes que o rastreamento de resumo de imagens fosse ativado; [] significa que o escritor executou, mas não conseguiu resolver nada.
  
  Ocultar atributos de query_images Mostrar atributos de requires_images objeto
  
  componente string
  
  digerir string
  
  sandbox string
  
  Sandbox é o nome canônico da sandbox para valores de componentes conhecidos. Omitido para nomes upstream desconhecidos.
- ordered_target_id string
  
  RequestedTargetID é procedência interna da Frota e intencionalmente não é exibido pelas respostas do Gateway. Permanece vazio para compatibilidade.
- rollback_error string
- rollback_from_id string
  
  definido quando este sistema foi revertido de
- rollback_of string
  
  Vinculação de rollback.
- fornecido_in_release string
  
  ShuppedInRelease é a versão que enviou esta implantação. Omitido quando não pertence a nenhum. Encaminhado pela ECP; derivado no tempo de leitura.
- source_build_id string
- source_project_id string
- source_promoção_id string
- source_workspace_id string
- started_at string
- Status string
- target_namespace string
  
  Colocação do Kubernetes.
- Trigger string
- updated_at string
- Versão string
  
  Versão é a versão do agente declarada pelo desenvolvedor encaminhada pelo ECP. Omitido para registros não versionados.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- aer_http_endpoint string
  
  AERHTTPEndpoint é o nome legado do endpoint HTTP da sandbox do agente .
- agent_http_endpoint string
  
  AgentHTTPEndpoint é o endpoint HTTP da sandbox do agente . O mesmo valor que aer_http_endpoint.
- agent_stack_name string
- app_id string
- branch string
- build_id string
- commit_sha string
- completed_at string
- components_images objeto
  
  Ocultar atributos de components_images Mostrar atributos de components_images objeto
  
  aer string
  
  AER é o nome legado da imagem da sandbox do agente .
  
  Agente string
  
  Agente é a imagem da sandbox do agente . O mesmo valor que aer.
  
  memory_server string
  
  oe string
  
  Ferramenta string
- Componentes array[objeto]
  
  Integridade por componente — encaminhado como está do ECP para visualização detalhada.
  
  Ocultar atributos dos componentes Mostrar atributos dos componentes objeto
  
  available booleano
  
  failure_message string
  
  failure_reason string
  
  name string
  
  read_replicas inteiro
  
  réplicas inteiro
  
  Réplicas é a contagem de pods desejada. Zero significa que a plataforma não comunicou um; os consumidores não devem tratar zero como escala para zero.
  
  sandbox string
  
  Sandbox é o nome canônico da sandbox para valores de componentes conhecidos (agente, ferramenta). Omitido para nomes upstream desconhecidos.
  
  type string
- condições array[objeto]
  
  Ocultar atributos de condições Mostrar atributos de condições objeto
  
  last_transition_time string
  
  mensagem string
  
  Razão string
  
  Status string
  
  type string
- created_at string
  
  Carimbos de data/hora.
- deployment_id string
  
  Identity & status principal ( sempre presente ).
- duration_ms inteiro
- error_message string
  
  Contexto de falha — exibido para que as UIs de administrador possam fazer a triagem sem ir primeiro ao Splunk.
- executor_type string
- first_deploy booleano
  
  O FirstDeploy é verdadeiro para todas as tentativas até (e incluindo) a primeira implantação bem-sucedida do espaço de trabalho. Omitido quando desconhecido.
- saúde objeto
  
  Campos estendidos.
  
  Ocultar atributos de integridade Mostrar atributos de integridade objeto
  
  available booleano
  
  check_at string
  
  Componentes array[objeto]
  
  Ocultar atributos dos componentes Mostrar atributos dos componentes objeto
  
  name string
  
  pronto booleano
  
  read_replicas inteiro
  
  sandbox string
  
  Sandbox é o nome canônico da sandbox para valores de componentes conhecidos (agente, ferramenta). Omitido para nomes upstream desconhecidos.
- page_uri string
  
  Imagem / fonte.
- Linguagem string
  
  Idioma é o idioma de tempo de execução do agente ("python" | "typescript"), encaminhado pelo ECP. Omitido quando não definido (as construções mais antigas são padronizadas para o python downstream).
- last_event_seq inteiro
- memory_enabled booleano
  
  MemoryEnabled é a configuração de memória de tempo de execução efetiva do sistema. Omitido quando indisponível.
- missing_secrets array[string]
- operator_namespace string
- org_id string
- post_deploy_error_message string
- anterior_imagem_uri string
- project_deleted booleano
  
  Verdadeiro quando o projeto proprietário do sistema tiver sido excluído de forma reversível. Sempre emitido para que os consumidores possam se ramificar no campo, não em sua ausência.
- PROJECT_ID string
- release_number inteiro
  
  ReleaseNumber é o identificador de versão monotônica por espaço de trabalho (conduz o rótulo v{N} na UI). 0/omitido para registros legado antes da migração de preenchimento.
- imagens_solicitadas array[objeto]
  
  RequestedImages é uma intenção de implantação fixada em resumo. Omitido para sistemas legado criados antes que o rastreamento de resumo de imagens fosse ativado; [] significa que o escritor executou, mas não conseguiu resolver nada.
  
  Ocultar atributos de query_images Mostrar atributos de requires_images objeto
  
  componente string
  
  digerir string
  
  sandbox string
  
  Sandbox é o nome canônico da sandbox para valores de componentes conhecidos. Omitido para nomes upstream desconhecidos.
- ordered_target_id string
  
  RequestedTargetID é procedência interna da Frota e intencionalmente não é exibido pelas respostas do Gateway. Permanece vazio para compatibilidade.
- rollback_error string
- rollback_from_id string
  
  definido quando este sistema foi revertido de
- rollback_of string
  
  Vinculação de rollback.
- fornecido_in_release string
  
  ShuppedInRelease é a versão que enviou esta implantação. Omitido quando não pertence a nenhum. Encaminhado pela ECP; derivado no tempo de leitura.
- source_build_id string
- source_project_id string
- source_promoção_id string
- source_workspace_id string
- started_at string
- Status string
- target_namespace string
  
  Colocação do Kubernetes.
- Trigger string
- updated_at string
- Versão string
  
  Versão é a versão do agente declarada pelo desenvolvedor encaminhada pelo ECP. Omitido para registros não versionados.
400

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Solicitação inválida
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
403

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Proibido
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
502

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Gateway incorreto
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso 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"

Exemplos de resposta (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"
}

Exemplos de resposta (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"
}

Exemplos de resposta (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"
}

Exemplos de resposta (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"
}

Exemplos de resposta (400)

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

Exemplos de resposta (400)

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

Exemplos de resposta (403)

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

Exemplos de resposta (403)

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

Exemplos de resposta (502)

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

Exemplos de resposta (502)

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