Docs Menu
Docs Home
/ /

Import Deployments

Note

Groups and projects are synonymous terms. Your {PROJECT-ID} is the same as your project id. For existing groups, your group/project id remains the same. This page uses the more familiar term group when referring to descriptions. The endpoint remains as stated in the document.

Import existing MongoDB deployments into Ops Manager automation. This set of endpoints allows you to add multiple existing MongoDB processes to both monitoring and automation management, facilitating large-scale imports of existing clusters.

Important

This feature is available starting in Ops Manager 8.0.13.

The imported deployments are added to the project's automation configuration. The MongoDB Agent will begin monitoring the processes and manage them according to the automation configuration.

Endpoint
Method
Description

Create Import Deployment Request

POST

Create a new import deployment request to add existing MongoDB processes to automation.

GET

Retrieve all import deployment requests for a project.

GET

Retrieve the status of a specific import deployment request.

POST

Cancel an in-progress import deployment request.

DELETE

Delete a failed import deployment request and clean up resources.

Import deployment requests progress through several states:

State
Description

PENDING

Import request has been created and is waiting to start.

AWAIT_SEED_HOST_CONNECTED

Attempting to connect to the seed host specified in the request.

AWAIT_HOSTS_DISCOVERED

Connected to seed host and discovering all required MongoDB processes.

AWAIT_AUTOMATION_IMPORTED

All processes discovered, importing configuration into automation.

AWAIT_GOAL_STATE

Import complete, waiting for automation to reach goal state.

SUCCESS

Import completed successfully. Processes are now managed by automation.

FAILED

Import failed. Use the delete endpoint to clean up.

CANCELLED

Import was cancelled by user request.

All import deployment endpoints require the Project Automation Admin role.

Back

Get Status of Last 50 Plans

On this page