Create Database Snapshot

POST

/dbaas/{managed_db_id}/snapshots/

curl --request POST \
  --url 'https://api.e2enetworks.com/myaccount/api/v1/gpu/dbaas/{managed_db_id}/snapshots/?project_id=<PROJECT_ID>&location=<LOCATION>&apikey=<API_KEY>' \
  --header 'Authorization: Bearer <API_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "orders-db-20261026-093000"
}'

Takes a snapshot of the database’s disk and returns it as Creating at once. The database stays online while the snapshot is taken. Call List Database Snapshots until status is Completed or Failed. A snapshot not finished within about 10 minutes is marked Failed. When it completes, an email goes to the person who created the database. Works only while the database is Running. Needs the Create permission for DBaaS.

Parameters

Path Parameters

managed_db_id

required

integer

Database ID

Query Parameters

project_id

required

integer

Project ID

active_iam

integer

Active IAM ID (To access contact person account) Find your Active IAM ID here

location

required

string

Allowed values: Delhi Chennai

Location

Request Body^required

Media typeapplication/json

object

name

required

Up to 63 characters: lowercase letters, numbers and hyphens, starting and ending with a letter or number. Not used by another snapshot in the project in this region, including other databases’ snapshots; a name taken by another database’s snapshot fails with 412.

string

<= 63 characters

Example

orders-db-20261026-093000

Responses

201

The snapshot, as Creating

Media typeapplication/json

object

code

integer

message

string

data

object

id

integer

name

string

status

A new snapshot is Creating until it finishes as Completed or Failed.

string

Allowed values: Creating Completed Failed

size

Size of the disk the snapshot holds, in bytes (the database’s storage size), set when the snapshot completes; 0 before that.

integer

nullable

backup_type

on_demand for a snapshot someone took, scheduled for one the snapshot schedule took.

string

Allowed values: on_demand scheduled

created_at

string

errors

object

Example

{
  "code": 201,
  "message": "Created Successfully",
  "data": {
    "id": 41,
    "name": "orders-db-20261026-093000",
    "status": "Creating",
    "size": 21474836480,
    "backup_type": "on_demand",
    "created_at": "2026-10-26T09:30:00Z"
  },
  "errors": {}
}

400

The name is missing, breaks the rule (“Name must contain only lowercase letters, numbers and hyphens, start and end with a letter or number, and be at most 63 characters.”) or is taken (“A snapshot with this name already exists.”). A missing or invalid project ID gives errors “Project ID is missing or invalid”.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

object

Example

{
  "code": 400,
  "message": "Bad Request",
  "data": {},
  "errors": {
    "name": [
      "A snapshot with this name already exists."
    ]
  }
}

403

The caller lacks the permission the call needs on the project, or the region is not allowed.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 403,
  "message": "Forbidden",
  "data": {},
  "errors": "You don't have permission to access this service. Please verify your policy or project."
}

404

No database with that ID in the project and region.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 404,
  "message": "Bad Request",
  "data": {},
  "errors": "Invalid request! Database Not Found"
}

412

The database is not Running (as shown), or the snapshot could not be started (“Snapshot creation failed”).

Media typeapplication/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 412,
  "message": "Precondition Failed",
  "data": {},
  "errors": "Database NOT in RUNNING state. Please try again later."
}