Skip to content

Get remote backup runs

GetRemoteBackupRuns

GetRemoteBackupRuns

Description: Reads run identifiers available on a configured remote backup server endpoint.

Use this command to inspect what has been uploaded to a remote backup server before importing a run back into the local backup catalog.

Access Control

SESSION_ADMIN, SESSION_MANAGER

Request Parameters

Field Type Required Description
server_name string Yes Backup endpoint name from GetBackupConfig

Request Example

{
  "command": "GetRemoteBackupRuns",
  "extID": "1",
  "data": {
    "server_name": "backup-eu-1"
  }
}

Response Example

{
  "rows": [
    "20260629-121045-000001",
    "20260629-123000-000002"
  ]
}

Errors

Error HTTP Code Description
INVALID_DATA 400 server_name is missing or is not a string
REMOTE_BACKUP_LIST_FAILED 409 The endpoint is missing, unavailable, unauthorized, or returned invalid data