MongoDBMongoDB Atlas Administration API v2
POST/api/atlas/v2/groups/{groupId}/liveMigrations
Manage create Group Live Migration.
Contract-preserving POST endpoint for create Group Live Migration in the MongoDB Atlas Administration API. Resource-specific values are supplied by the caller at runtime.
All 540 MongoDB Atlas administration endpoints from a fixed Apache-2.0 OpenAPI revision. Hub provides documentation and an independent SDK/CLI, but never proxies account, organization, project, network, backup, or operational data; callers connect directly with local credentials.
Request
- operationId
createGroupLiveMigration- Server
https://cloud.mongodb.com- Authentication
- ServiceAccounts, DigestAuth
Request parameters
groupId
pathstringrequired
group Id value in the Atlas Administration API contract.
32b6e34b3d91647abb20e7b8
envelope
queryboolean
envelope value in the Atlas Administration API contract.
pretty
queryboolean
pretty value in the Atlas Administration API contract.
Request body
LiveMigrationRequestrequired
Content-Type: application/vnd.atlas.2023-01-01+json, application/vnd.atlas.2024-05-30+json
Properties: _iddestinationdropEnabledmigrationHostsshardingsource
Responses
201
LiveMigrationResponseapplication/vnd.atlas.2023-01-01+jsonapplication/vnd.atlas.2024-05-30+json
Successful supplier response.
Properties: _idlagTimeSecondsmigrationHostsreadyForCutoverstatus
400
ApiErrorapplication/json
Supplier response with HTTP status 400.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
401
ApiErrorapplication/json
Supplier response with HTTP status 401.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
403
ApiErrorapplication/json
Supplier response with HTTP status 403.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
404
ApiErrorapplication/json
Supplier response with HTTP status 404.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
429
ApiErrorapplication/json
Supplier response with HTTP status 429.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
500
ApiErrorapplication/json
Supplier response with HTTP status 500.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
{
"_id": "32b6e34b3d91647abb20e7b8",
"lagTimeSeconds": 0,
"migrationHosts": [
"vm001.example.com"
],
"readyForCutover": false,
"status": "NEW"
}