MongoDBMongoDB Atlas Administration API v2
POST/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots
Manage take Group Cluster Backup Snapshots.
Contract-preserving POST endpoint for take Group Cluster Backup Snapshots 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
takeGroupClusterBackupSnapshots- Server
https://cloud.mongodb.com- Authentication
- ServiceAccounts, DigestAuth
Request parameters
envelope
queryboolean
envelope value in the Atlas Administration API contract.
pretty
queryboolean
pretty value in the Atlas Administration API contract.
groupId
pathstringrequired
group Id value in the Atlas Administration API contract.
32b6e34b3d91647abb20e7b8
clusterName
pathstringrequired
cluster Name value in the Atlas Administration API contract.
Request body
DiskBackupOnDemandSnapshotRequestrequired
Content-Type: application/vnd.atlas.2023-01-01+json
Properties: descriptionlinksretentionInDays
Responses
200
DiskBackupSnapshotapplication/vnd.atlas.2023-01-01+json
Successful supplier response.
Properties: createdAtdescriptionexpiresAtfrequencyTypeidlinksmasterKeyUUIDmongodVersionpolicyItemssnapshotTypestatusstorageSizeBytestype
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
{
"frequencyType": "hourly",
"id": "32b6e34b3d91647abb20e7b8",
"links": {
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
}