/show/backup

URL: http://<db.host>:<db.port>/show/backup

Shows information about a backup Returns detailed information about one or more backup instances.

Input Parameter Description

NameTypeDescription
backup_namestringName of the backup object. An empty string or '*' will return all existing backups. The default value is ''.
datasource_namestringDatasource where backup is located.
optionsmap of string to strings

Optional parameters. The default value is an empty map ( {} ).

Supported Parameters (keys)Parameter Description
backup_idBackup instance ID to show. Leave empty to show information from the most recent backup instance in the container. The default value is ''.
show_contents

Shows the contents of the specified backup_id The default value is none.

Supported ValuesDescription
noneNo backup contents
object_namesObject names only
object_filesObject names and files
no_error_if_not_exists

If false will return an error if the provided input parameter backup_name does not exist. If true then it will return an empty result. The default value is false. The supported values are:

  • true
  • false

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

NameTypeDescription
statusString'OK' or 'ERROR'
messageStringEmpty if success or an error message
data_typeString'show_backup_response' or 'none' in case of an error
dataStringEmpty string
data_strJSON or String

This embedded JSON represents the result of the /show/backup endpoint:

NameTypeDescription
backup_namestringValue of input parameter backup_name.
backup_descriptionarray of maps of string to stringsBackup description
backup_idsarray of maps of string to stringsBackup instances in this backup
backup_contentsarray of maps of string to stringsBackup contents
deleted_backup_idsarray of maps of string to stringsBackup instances that have been deleted from this backup object
infomap of string to stringsAdditional information.

Empty string in case of an error.