Child pages
  • WHM API 1 Functions - backup_list_transported

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

Excerpt

This function lists backup files that the system sent through a specified additional backup transport.


Panel
bgColor#F2F2F2
borderStylenone

Examples 


Panel
bgColor#FFFFFF
borderStylenone


Expand
titleJSON API


Code Block
languagexml
https://hostname.example.com:2087/cpsess##########/json-api/backup_list_transported?api.version=1&transport=exampletransport



Expand
titleCommand Line


Code Block
languagebash
whmapi1 backup_list_transported transport=exampletransport

Include Page
LIB:_WHMAPI1CLINote
LIB:_WHMAPI1CLINote


Expand
titleOutput (JSON)


Code Block
languagetext
linenumberstrue
{
    "data": {
        'remote_backups' : {
            'exampletransport': {
                'account1': ['2018-07-19','2017-07-20'],
                'account2': ['2018-07-19']
                          }
             }
    },
    "metadata": {
        "version": 1,
        "reason": "OK",
        "result": 1,
        "command": "backup_user_list"
    }
}


Include Page
LIB:_WHMAPIShellNote
LIB:_WHMAPIShellNote


Parameters

ParameterTypeDescriptionPossible valuesExample
transportstring

The transport ID.

If you do not specify this parameter, the function returns all transported backup files.

A valid transport ID.

exampletransport

Returns

ReturnTypeDescriptionPossible valuesExample
remote_backups hash A hash of the backup destination information.This hash includes the transport_name hash.
 

transport_name

hash

The backup transport's name.

Note
titleNote:

The function uses the name of the transport as the return's name.

The function returns this value in the remote_backups hash.

This hash includes the account_name array.


account_name

string

An array of the account's backup file dates.

Note
titleNote:

The function uses the name of the account as the return's name.

The function returns this value in the transport_name hash.

A date in YYYY-MM-DD format, where:

  • YYYY represents the year.
  • MM represents the month.
  • DD represents the day.
2018-07-19