UAPI Functions - WordPressBackup::get_available_backups

Guide to UAPI

Backup

Backup:: fullbackup_to_ftp

Backup:: fullbackup_to_homedir

Backup:: fullbackup_to_scp_with_key

Backup:: fullbackup_to_scp_with_password

Backup:: list_backups

Bandwidth

Bandwidth:: get_enabled_protocols

Bandwidth:: get_retention_periods

Bandwidth:: query

Batch

Batch:: strict

Brand

Brand:: read

Branding

Branding:: file

Branding:: get_applications

Branding:: get_application_information

Branding:: get_available_applications

Branding:: get_information_for_applications

Branding:: image

Branding:: include

Branding:: spritelist

CacheBuster

CacheBuster:: read

CacheBuster:: update

Chkservd

Chkservd:: get_exim_ports

Chkservd:: get_exim_ports_ssl

Chrome

Chrome:: get_dom

Contactus

Contactus:: is_enabled

cPAddons

cPAddons:: get_available_addons

cPAddons:: get_instance_settings

cPAddons:: list_addon_instances

cPGreyList

cPGreyList:: disable_all_domains

cPGreyList:: disable_domains

cPGreyList:: enable_all_domains

cPGreyList:: enable_domains

cPGreyList:: has_greylisting_enabled

cPGreyList:: list_domains

DAV

DAV:: disable_shared_global_addressbook

DAV:: enable_shared_global_addressbook

DAV:: get_calendar_contacts_config

DAV:: has_shared_global_addressbook

DAV:: is_dav_service_enabled

DAV:: is_horde_enabled

DCV

DCV:: check_domains_via_dns

DCV:: check_domains_via_http

DCV:: ensure_domains_can_pass_dcv

DomainInfo

DomainInfo:: domains_data

DomainInfo:: list_domains

DomainInfo:: main_domain_builtin_subdomain_aliases

DomainInfo:: single_domain_data

DNS

DNS:: ensure_domains_reside_only_locally

DNS:: has_local_authority

DNSSEC

DNSSEC:: disable_dnssec

DNSSEC:: enable_dnssec

DNSSEC:: fetch_ds_records

DNSSEC:: set_nsec3

DNSSEC:: unset_nsec3

Email

Email:: account_name

Email:: add_auto_responder

Email:: add_domain_forwarder

Email:: add_forwarder

Email:: add_list

Email:: add_mailman_delegates

Email:: add_mx

Email:: add_pop

Email:: add_spam_filter

Email:: browse_mailbox

Email:: change_mx

Email:: check_fastmail

Email:: check_pipe_forwarder

Email:: delete_auto_responder

Email:: delete_domain_forwarder

Email:: delete_filter

Email:: delete_forwarder

Email:: delete_held_messages

Email:: delete_list

Email:: delete_mx

Email:: delete_pop

Email:: disable_filter

Email:: disable_mailbox_autocreate

Email:: disable_spam_assassin

Email:: disable_spam_autodelete

Email:: disable_spam_box

Email:: dispatch_client_settings

Email:: edit_pop_quota

Email:: enable_filter

Email:: enable_mailbox_autocreate

Email:: enable_spam_assassin

Email:: enable_spam_box

Email:: fetch_charmaps

Email:: fts_rescan_mailbox

Email:: generate_mailman_otp

Email:: get_auto_responder

Email:: get_charsets

Email:: get_client_settings

Email:: get_default_email_quota

Email:: get_default_email_quota_mib

Email:: get_disk_usage

Email:: get_filter

Email:: get_held_message_count

Email:: get_mailbox_autocreate

Email:: get_mailman_delegates

Email:: get_main_account_disk_usage

Email:: get_main_account_disk_usage_bytes

Email:: get_max_email_quota

Email:: get_max_email_quota_mib

Email:: get_pop_quota

Email:: get_spam_settings

Email:: get_webmail_settings

Email:: has_delegated_mailman_lists

Email:: has_plaintext_authentication

Email:: hold_outgoing

Email:: is_integer

Email:: list_auto_responders

Email:: list_default_address

Email:: list_domain_forwarders

Email:: list_filters

Email:: list_filters_backups

Email:: list_forwarders

Email:: list_forwarders_backups

Email:: list_lists

Email:: list_mail_domains

Email:: list_mxs

Email:: list_pops

Email:: list_pops_with_disk

Email:: list_system_filter_info

Email:: passwd_list

Email:: passwd_pop

Email:: release_outgoing

Email:: remove_mailman_delegates

Email:: reorder_filters

Email:: set_always_accept

Email:: set_default_address

Email:: set_list_privacy_options

Email:: stats_db_status

Email:: store_filter

Email:: suspend_incoming

Email:: suspend_login

Email:: suspend_outgoing

Email:: trace_filter

Email:: unsuspend_incoming

Email:: unsuspend_login

Email:: unsuspend_outgoing

Email:: verify_password

EmailAuth

EmailAuth:: disable_dkim

EmailAuth:: enable_dkim

EmailAuth:: ensure_dkim_keys_exist

EmailAuth:: fetch_dkim_private_keys

EmailAuth:: install_dkim_private_keys

EmailAuth:: install_spf_records

EmailAuth:: validate_current_dkims

EmailAuth:: validate_current_ptrs

EmailAuth:: validate_current_spfs

ExternalAuthentication

ExternalAuthentication:: add_authn_link

ExternalAuthentication:: configured_modules

ExternalAuthentication:: get_authn_links

ExternalAuthentication:: has_external_auth_modules_configured

ExternalAuthentication:: remove_authn_link

Features

Features:: has_feature

Features:: list_features

Fileman

Fileman:: autocompletedir

Fileman:: empty_trash

Fileman:: get_file_content

Fileman:: get_file_information

Fileman:: list_files

Fileman:: save_file_content

Fileman:: transcode

Fileman:: upload_files

Ftp

Ftp:: add_ftp

Ftp:: allows_anonymous_ftp

Ftp:: allows_anonymous_ftp_incoming

Ftp:: delete_ftp

Ftp:: ftp_exists

Ftp:: get_ftp_daemon_info

Ftp:: get_port

Ftp:: get_quota

Ftp:: get_welcome_message

Ftp:: kill_session

Ftp:: list_ftp

Ftp:: list_ftp_with_disk

Ftp:: list_sessions

Ftp:: passwd

Ftp:: server_name

Ftp:: set_anonymous_ftp

Ftp:: set_anonymous_ftp_incoming

Ftp:: set_homedir

Ftp:: set_quota

Ftp:: set_welcome_message

Integration

Integration:: fetch_url

KnownHosts

KnownHosts:: create

KnownHosts:: delete

KnownHosts:: update

KnownHosts:: verify

LangPHP

LangPHP:: php_get_domain_handler

LangPHP:: php_get_impacted_domains

LangPHP:: php_get_installed_versions

LangPHP:: php_get_system_default_version

LangPHP:: php_get_vhost_versions

LangPHP:: php_ini_get_user_basic_directives

LangPHP:: php_ini_get_user_content

LangPHP:: php_ini_get_user_paths

LangPHP:: php_ini_set_user_basic_directives

LangPHP:: php_ini_set_user_content

LangPHP:: php_set_vhost_versions

LastLogin

LastLogin:: get_last_or_current_logged_in_ip

Locale

Locale:: get_attributes

Mailboxes

Mailboxes:: expunge_mailbox_messages

Mailboxes:: expunge_messages_for_mailbox_guid

Mailboxes:: get_mailbox_status

Mailboxes:: has_utf8_mailbox_names

Mailboxes:: set_utf8_mailbox_names

Market

Market:: cancel_pending_ssl_certificate

Market:: create_shopping_cart

Market:: get_all_products

Market:: get_certificate_status_details

Market:: get_login_url

Market:: get_pending_ssl_certificates

Market:: get_provider_specific_dcv_constraints

Market:: get_providers_list

Market:: get_ssl_certificate_if_available

Market:: process_ssl_pending_queue

Market:: request_ssl_certificates

Market:: set_status_of_pending_queue_items

Market:: set_url_after_checkout

Market:: validate_login_token

Mime

Mime:: add_handler

Mime:: add_hotlink

Mime:: add_mime

Mime:: add_redirect

Mime:: delete_handler

Mime:: delete_hotlink

Mime:: delete_mime

Mime:: delete_redirect

Mime:: list_handlers

Mime:: list_hotlinks

Mime:: list_mime

Mime:: list_redirects

Mime:: redirect_info

ModSecurity

ModSecurity:: disable_all_domains

ModSecurity:: disable_domains

ModSecurity:: enable_all_domains

ModSecurity:: enable_domains

ModSecurity:: has_modsecurity_installed

ModSecurity:: list_domains

Mysql

Mysql:: add_host

Mysql:: add_host_note

Mysql :: check_database

Mysql:: create_database

Mysql:: create_user

Mysql:: delete_database

Mysql:: delete_host

Mysql:: delete_user

Mysql:: get_host_notes

Mysql:: get_privileges_on_database

Mysql:: get_restrictions

Mysql:: get_server_information

Mysql:: locate_server

Mysql:: rename_database

Mysql:: rename_user

Mysql:: repair_database

Mysql:: revoke_access_to_database

Mysql:: set_password

Mysql:: set_privileges_on_database

Notifications

Notifications:: get_notifications_count

NVData

NVData:: get

NVData:: set

Parser

Parser:: firstfile_relative_uri

PassengerApps

PassengerApps:: disable_application

PassengerApps:: edit_application

PassengerApps:: enable_application

PassengerApps:: list_applications

PassengerApps:: register_application

PassengerApps:: unregister_application

PasswdStrength

PasswdStrength:: get_required_strength

Personalization

Personalization::set

Personalization ::get

Postgresql

Postgresql:: create_database

Postgresql:: create_user

Postgresql:: delete_database

Postgresql:: get_restrictions

Postgresql:: grant_all_privileges

Postgresql:: rename_database

Postgresql:: rename_user

Postgresql:: rename_user_no_password

Postgresql:: revoke_all_privileges

Postgresql:: set_password

Pushbullet

Pushbullet:: send_test_message

Quota

Quota:: get_quota_info

Resellers

Resellers:: list_accounts

ResourceUsage

ResourceUsage:: get_usages

Restore

Restore:: directory_listing

Restore:: get_users

Restore:: query_file_info

Restore:: restore_file

Session

Session:: create_temp_user

SiteTemplates

SiteTemplates:: list_site_templates

SiteTemplates:: list_user_settings

SiteTemplates:: publish

SpamAssassin

SpamAssassin :: clear_spam_box

SpamAssassin:: get_symbolic_test_names

SpamAssassin:: get_user_preferences

SpamAssassin:: update_user_preference

SSH

SSH:: get_port

SSL

SSL:: add_autossl_excluded_domains

SSL:: check_shared_cert

SSL:: delete_cert

SSL:: delete_csr

SSL:: delete_key

SSL:: delete_ssl

SSL :: disable_mail_sni

SSL:: enable_mail_sni

SSL:: fetch_best_for_domain

SSL:: fetch_cert_info

SSL:: fetch_certificates_for_fqdns

SSL:: fetch_key_and_cabundle_for_certificate

SSL:: find_certificates_for_key

SSL:: find_csrs_for_key

SSL:: generate_cert

SSL:: generate_csr

SSL:: generate_key

SSL:: get_autossl_excluded_domains

SSL:: get_autossl_pending_queue

SSL:: get_autossl_problems

SSL:: get_cabundle

SSL:: get_cn_name

SSL:: install_ssl

SSL:: installed_host

SSL:: installed_hosts

SSL:: is_autossl_check_in_progress

SSL:: is_mail_sni_supported

SSL:: is_sni_supported

SSL:: list_certs

SSL:: list_csrs

SSL:: list_keys

SSL:: list_ssl_items

SSL:: mail_sni_status

SSL:: rebuild_mail_sni_config

SSL:: rebuildssldb

SSL:: remove_autossl_excluded_domains

SSL:: set_autossl_excluded_domains

SSL:: set_cert_friendly_name

SSL:: set_csr_friendly_name

SSL:: set_key_friendly_name

SSL:: set_primary_ssl

SSL:: set_ssl_share

SSL:: show_cert

SSL:: show_csr

SSL:: show_key

SSL:: start_autossl_check

SSL:: upload_cert

SSL:: upload_key

StatsBar

StatsBar:: get_stats

Styles

Styles:: current

Styles:: list

Styles:: set_default

Styles:: update

SubDomain

SubDomain:: addsubdomain

Themes

Themes:: get_theme_base

Themes:: list

Themes:: update

TwoFactorAuth

TwoFactorAuth:: generate_user_configuration

TwoFactorAuth:: get_user_configuration

TwoFactorAuth:: remove_user_configuration

TwoFactorAuth:: set_user_configuration

UserManager

UserManager:: check_account_conflicts

UserManager:: create_user

UserManager:: delete_user

UserManager:: dismiss_user

UserManager:: edit_user

UserManager:: list_users

UserManager:: lookup_service_account

UserManager:: lookup_user

UserManager:: merge_service_account

UserManager:: unlink_service_account

UserTasks

UserTasks:: delete

UserTasks:: retrieve

VersionControl

VersionControl:: create

VersionControl:: delete

VersionControl:: retrieve

VersionControl:: update

VersionControlDeployment

VersionControlDeployment:: create

VersionControlDeployment:: delete

VersionControlDeployment:: retrieve

WebDisk

WebDisk:: delete_user

WebDisk:: set_homedir

WebDisk:: set_password

WebDisk:: set_permissions

WebmailApps

WebmailApps:: listwebmailapps

WebVhosts

WebVhost:: list_domains

WebVhost:: list_ssl_capable_domains

WordPressBackup

WordPressBackup:: any_running

WordPressBackup:: cancel

WordPressBackup:: cleanup

WordPressBackup:: get_available_backups

WordPressBackup:: is_running

WordPressBackup:: start

WordPressInstanceManager

WordPressInstanceManager:: cancel_scan

WordPressInstanceManager:: cleanup_scan

WordPressInstanceManager:: change_admin_password

WordPressInstanceManager:: configure_autoupdate

WordPressInstanceManager:: get_api_version

WordPressInstanceManager:: get_instance_by_id

WordPressInstanceManager:: get_instances

WordPressInstanceManager:: get_latest_wordpress_version_from_wordpress_org

WordPressInstanceManager:: get_scan_results

WordPressInstanceManager:: is_installable_addon_available

WordPressInstanceManager:: start_scan

WordPressRestore

WordPressRestore:: any_running

WordPressRestore:: cleanup

WordPressRestore:: start

Description

This function retrieves a list of available WordPress® site backups of a single site.

Note:

You must install the WordPress Manager cPanel plugin to access this API function.

Examples

cPanel or Webmail Session URL

https://hostname.example.com:2083/cpsess##########/execute/WordPressBackup/get_available_backups?site=example.com

Note:

This example calls the UAPI function via a cPanel session. For more information, read our Guide to UAPI documentation.

LiveAPI PHP Class

$cpanel = new CPANEL(); // Connect to cPanel - only do this once.
 
// Retrieve the list of available backups for WordPress site.
 $instances = $cpanel->uapi(
    'WordPressBackup', 'get_available_backups',
array( 
        'site' => 'example.com'
    )
);

Note:

For more information, read our Guide to the LiveAPI System.

LiveAPI Perl Module

my $cpliveapi = Cpanel::LiveAPI->new(); # Connect to cPanel - only do this once.
 
# Retrieve the list of available backups for WordPress site.
my $instances = $cpliveapi->uapi(
    'WordPressBackup', 'get_available_backups',
	{
		'site' => 'example.com'
	}
);

Note:

For more information, read our Guide to the LiveAPI System.

cPanel Template Toolkit

<!-- Retrieve the list of available backups for WordPress site. -->
[% data = execute( 'WordPressBackup', 'get_available_backups', { 'site' => 'example.com' } ); %]

Note:

For more information, read our Guide to Template Toolkit documentation.

Command Line

uapi --user=username WordPressBackup get_available_backups site=example.com

Notes:

You must URI-encode values.
username represents your account-level username.
For more information and additional output options, read our Guide to UAPI documentation or run the uapi --help command.
If you run CloudLinux™, you must use the full path of the uapi command:
```
/usr/local/cpanel/bin/uapi
```

Output (JSON)

{
	"metadata": {},
	"warnings": null,
	"errors": null,
	"status": 1,
	"messages": null,
	"data": {
		"dir": "/home/example/wordpress-backups",
		"available": [{
			"path": "/home/example/wordpress-backups/example.com__2018-10-10T10:53:31-0500.tar.gz",
			"file": "example.com__2018-10-10T10:53:31-0500.tar.gz",
			"site": "example.com",
			"date": "1539267197000"
		}]
	}
}

Note:

Use cPanel's API Shell interface (cPanel >> Home >> Advanced >> API Shell) to directly test cPanel API calls.

Parameters

Parameter	Type	Description	Possible values	Example
`site`	string	Required The WordPress site's URL.	A URL without the protocol prefix.	example.com example.com/wordpress

Returns

Return	Type	Description	Possible values	Example
`available`	array of hashes	A hash that contains a list of the WordPress site's backups.	This array of hash contains the `date`, `file`, `path`, and `site` returns.
`date`	string	The date and time the system created the backup. This function returns this value in the `available` array of hashes.	A valid timestamp, in milliseconds, in Unix Epoch time.	1539267197000
`file`	string	The backup's file name. This function returns this value in the `available` array of hashes.	A backup file with the `tar.zip` extension.	`example.com__2018-10-10T10:53:31-0500.tar.gz`
`path`	string	The path to the backup file. This function returns this value in the `available` array of hashes.	The absolute path to the file.	Click to expand... `/home/example/wordpress-backups/example.com__2018-10-10T10:53:31-0500.tar.gz`
`site`	string	The site's URL. This function returns this value in the `available` array of hashes.	A URL without the protocol prefix.	`example.com`
`dir`	string	The path to the backup directory.	The absolute path to the directory.	Click to expand... `/home/example/wordpress-backups`

Function information

Module:

WordPressBackup

API Version:

UAPI

Available in:

WordPress Manager 3.0

Methods:

GET, POST

Required Parameters:

site

Return Formats:

JSON

Legacy Equivalents:

(none)

About this module

The WordPressbackup module manages cPanel's WordPress® instance backups. The system installs this module with the WordPress Manager cPAddon.

About UAPI

UAPI accesses and modifies data for cPanel accounts.

Notes:

These functions may require specific features. To enable or disable features, use WHM's Feature Manager interface.
Unless you call this API via the WHM API, you must use the appropriate cPanel ports (2082 or 2083). You can also call some functions via cPanel's Webmail ports (2095 or 2096).

Find a function

Related functions

Page:

UAPI Modules - cPAddons — The cPaddons module accesses cPanel's cPAddon system.
Page:

UAPI Functions - cPAddons::get_available_addons — This function lists an account's available cPAddons.
Page:

UAPI Functions - cPAddons::list_addon_instances — This function lists an account's deployed cPAddons instances.
Page:

UAPI Functions - cPAddons::get_instance_settings — This function lists a cPAddons instance's settings.
Page:

UAPI Functions - cPAddons::get_available_addons — This function lists an account's available cPAddons.

Child pages

UAPI Functions - WordPressBackup::get_available_backups

Description

Examples

Parameters

Returns

Function information

About this module

About UAPI

Find a function

Search

Related functions