Skip to main content

clickhouse_backups

Creates, updates, deletes, gets or lists a clickhouse_backups resource.

Overview​

Nameclickhouse_backups
TypeResource
Idovh.cloud_database.clickhouse_backups

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idstring (uuid)Backup ID
created_atstring (date-time)Date of the creation of the backup (wire: createdAt)
descriptionstringDescription of the backup
regionstringRegion where the backup is stored. DEPRECATED: use regions
regionsarrayRegions where the backup are stored
sizeobjectSize of the backup
statusstringCurrent status of the backup (CREATING, DELETING, DRAINED, ERROR, LOCKED, LOCKED_PENDING, LOCKED_UPDATING, PENDING, READY, SHELVED, TO_DRAIN, UPDATING)
typestringType of backup (automatic, manual, none, pitr, snapshot)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectbackup_id, cluster_id, service_nameGet clickhouse backups
listselectcluster_id, service_namex_pagination_modeList backups of the clickhouse

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
api_hoststringThe OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}})
backup_idstring (uuid)Backup ID (wire: backupId)
cluster_idstring (uuid)Cluster ID (wire: clusterId)
service_namestringThe Public Cloud project ID. Resolved from OVH_CLOUD_PROJECT_SERVICE when set.
x_pagination_modestringSent as CachedObjectList-Pages by default so the list returns the full objects rather than their identifiers. (wire: X-Pagination-Mode)

SELECT examples​

Get clickhouse backups

SELECT
id,
created_at,
description,
region,
regions,
size,
status,
type
FROM ovh.cloud_database.clickhouse_backups
WHERE backup_id = '{{ backup_id }}' -- required
AND cluster_id = '{{ cluster_id }}' -- required
AND service_name = '{{ service_name }}' -- required unless OVH_CLOUD_PROJECT_SERVICE is set
;