Databases

Managed PostgreSQL Database Backup View

get
https://api.linode.com/v4/databases/postgresql/instances/{instanceId}/backups/{backupId}

Display information for a single backup for an accessible Managed PostgreSQL Database.

The Database must not be provisioning to perform this command.

Path Parameters

instanceId
Required
integer

The ID of the Managed PostgreSQL Database.

backupId
Required
integer

The ID of the Managed PostgreSQL Database backup.

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/databases/postgresql/instances/123/backups/456

Response Samples

{
  "created": "2022-01-01T00:01:01",
  "id": 1234,
  "label": "Scheduled - 02/04/22 11:11 UTC-XcCRmI",
  "type": "auto"
}

Responses

200: Returns a single backup for the Managed PostgreSQL Database.

created
Filterable
string <datetime>

A time value given in a combined date and time format that represents when the database backup was created.

id
integer

The ID of the database backup object.

label
string <= 30 characters

The database backup's label, for display purposes only.

Must include only ASCII letters or numbers.

type
Filterable
string
Enum: "snapshot""auto"

The type of database backup, determined by how the backup was created.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.

Managed PostgreSQL Database Backup Delete

delete
https://api.linode.com/v4/databases/postgresql/instances/{instanceId}/backups/{backupId}

Delete a single backup for an accessible Managed PostgreSQL Database.

Requires read_write access to the Database.

The Database must not be provisioning to perform this command.

Path Parameters

instanceId
Required
integer

The ID of the Managed PostgreSQL Database.

backupId
Required
integer

The ID of the Managed PostgreSQL Database backup.

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    -X DELETE \
    https://api.linode.com/v4/databases/postgresql/instances/123/backups/456

Response Samples

{}

Responses

200: Request to delete Database backup successful.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.