/ /

Recursos

Implementaciones de importación

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Implementaciones de importación

Obtener solicitudes de implementación de importación

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} Es el mismo que el ID de tu proyecto. Para los grupos existentes, el ID de tu grupo/proyecto permanece igual. Esta página utiliza el término "grupo" para las descripciones. El punto final se mantiene como se indica en el documento.

Recupera todas las solicitudes de implementación de importación de un proyecto. Este punto final devuelve una lista de todas las solicitudes de implementación de importación creadas para el proyecto especificado, incluyendo su estado actual e historial.

Importante

Esta funcionalidad está disponible desde Ops Manager 8.0.13.

Roles necesarios

Este punto final requiere el Project Automation Admin role.

Endpoint

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

GET /automation/importDeployment/{PROJECT-ID}

Solicitud

Parámetros de ruta

Nombre	Tipo	Necesidad	Descripción
PROJECT-ID	string	Requerido	Identificador único de la proyecto.

Parámetros de consulta

Los siguientes parámetros de consulta son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonita

booleano

Opcional

Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint formato.

false

envolvente

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta.

Para los puntos finales que devuelven un resultado, el cuerpo de la respuesta incluye:

Nombre	Descripción
`status`	Código de respuestaHTTP
`content`	Cuerpo de respuesta esperado

false

Parámetros corporales

Este punto final no utiliza parámetros del cuerpo de la solicitud HTTP.

Respuesta

Nombre	Tipo	Necesidad	Descripción
resultados	arreglo	Siempre	Matriz de objetos de solicitud de implementación de importación.
resultados[n].id	string	Siempre	Identificador único de la solicitud de implementación de importación.
resultados[n].groupId	string	Siempre	Identificador del proyecto.
resultados[n].userId	string	Siempre	Usuario que creó la solicitud de importación.
resultados[n].estado	string	Siempre	Estado actual de la importación. Valores posibles: `PENDING`, `AWAIT_SEED_HOST_CONNECTED`, `AWAIT_HOSTS_DISCOVERED`, `AWAIT_AUTOMATION_IMPORTED`, `AWAIT_GOAL_STATE`, `SUCCESS`, `FAILED`, `CANCELLED`.
results[n].transitionsHistory	arreglo	Siempre	Historial de transiciones de estado para esta solicitud de importación.
resultados[n].transicionesHistorial[n].estado	string	Siempre	El estado al que se realizó la transición.
resultados[n].transicionesHistorial[n].transicionadoEn	string	Siempre	Marca de tiempo ISO 8601 cuando se produjo la transición.

Ejemplo de solicitud

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/automation/importDeployment/{PROJECT-ID}?pretty=true"

Ejemplo de respuesta

Encabezado de respuesta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Cuerpo de respuesta

{
  "results": [
    {
      "id": "507f1f77bcf86cd799439011",
      "groupId": "507f1f77bcf86cd799439012",
      "userId": "507f1f77bcf86cd799439013",
      "state": "SUCCESS",
      "transitionsHistory": [
        {
          "state": "PENDING",
          "transitionedAt": "2025-10-20T10:00:00.000Z"
        },
        {
          "state": "AWAIT_SEED_HOST_CONNECTED",
          "transitionedAt": "2025-10-20T10:02:00.000Z"
        },
        {
          "state": "SUCCESS",
          "transitionedAt": "2025-10-20T10:15:00.000Z"
        }
      ]
    }
  ]
}

Volver

Crear solicitud de implementación de importación

Obtener el estado de la solicitud de implementación de importación