Actualizar la configuración de copias de seguridad del servicio
Actualiza la configuración de copia de seguridad del servicio. Requiere el rol de clave de autenticación Admin. Si se establecen propiedades con valor NULL, se restablecerán a sus valores predeterminados.
PATCH
/
v1
/
organizations
/
{organizationId}
/
services
/
{serviceId}
/
backupConfiguration
Actualizar la configuración de copias de seguridad del servicio
curl --request PATCH \
--url https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"backupPeriodInHours": 123,
"backupRetentionPeriodInHours": 123,
"backupStartTime": "<string>"
}
'import requests
url = "https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration"
payload = {
"backupPeriodInHours": 123,
"backupRetentionPeriodInHours": 123,
"backupStartTime": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
backupPeriodInHours: 123,
backupRetentionPeriodInHours: 123,
backupStartTime: '<string>'
})
};
fetch('https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'backupPeriodInHours' => 123,
'backupRetentionPeriodInHours' => 123,
'backupStartTime' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration"
payload := strings.NewReader("{\n \"backupPeriodInHours\": 123,\n \"backupRetentionPeriodInHours\": 123,\n \"backupStartTime\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"backupPeriodInHours\": 123,\n \"backupRetentionPeriodInHours\": 123,\n \"backupStartTime\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"backupPeriodInHours\": 123,\n \"backupRetentionPeriodInHours\": 123,\n \"backupStartTime\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"result": {
"backupPeriodInHours": 123,
"backupRetentionPeriodInHours": 123,
"backupStartTime": "<string>"
},
"status": 200
}{
"error": "<string>",
"status": 400
}Autorizaciones
Usa el ID y el secreto de la clave obtenidos en la consola de ClickHouse Cloud: https://clickhouse.com/docs/cloud/manage/openapi
Parámetros de ruta
ID de la organización propietaria del servicio.
ID del servicio.
Cuerpo
application/json
El intervalo en horas entre cada backup.
La duración mínima en horas durante la cual los backups están disponibles.
La hora en formato HH:MM a la que deben realizarse los backups (evaluada en la zona horaria UTC). Cuando se define, el período de backup se restablece a cada 24 horas.
Última modificación el 12 de junio de 2026
¿Esta página le ayudó?
⌘I
Actualizar la configuración de copias de seguridad del servicio
curl --request PATCH \
--url https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"backupPeriodInHours": 123,
"backupRetentionPeriodInHours": 123,
"backupStartTime": "<string>"
}
'import requests
url = "https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration"
payload = {
"backupPeriodInHours": 123,
"backupRetentionPeriodInHours": 123,
"backupStartTime": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
backupPeriodInHours: 123,
backupRetentionPeriodInHours: 123,
backupStartTime: '<string>'
})
};
fetch('https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'backupPeriodInHours' => 123,
'backupRetentionPeriodInHours' => 123,
'backupStartTime' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration"
payload := strings.NewReader("{\n \"backupPeriodInHours\": 123,\n \"backupRetentionPeriodInHours\": 123,\n \"backupStartTime\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"backupPeriodInHours\": 123,\n \"backupRetentionPeriodInHours\": 123,\n \"backupStartTime\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.clickhouse.cloud/v1/organizations/{organizationId}/services/{serviceId}/backupConfiguration")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"backupPeriodInHours\": 123,\n \"backupRetentionPeriodInHours\": 123,\n \"backupStartTime\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"result": {
"backupPeriodInHours": 123,
"backupRetentionPeriodInHours": 123,
"backupStartTime": "<string>"
},
"status": 200
}{
"error": "<string>",
"status": 400
}