Обновить конфигурацию резервного копирования сервиса
Обновляет конфигурацию резервного копирования сервиса. Требуется ключ авторизации с ролью Admin. Если для свойств указать значение null, они будут сброшены к значениям по умолчанию.
PATCH
/
v1
/
organizations
/
{organizationId}
/
services
/
{serviceId}
/
backupConfiguration
Обновить конфигурацию резервного копирования сервиса
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
}Авторизации
Используйте идентификатор ключа и секрет ключа, полученные в консоли ClickHouse Cloud: https://clickhouse.com/docs/cloud/manage/openapi
Параметры пути
Идентификатор организации, которой принадлежит сервис.
Идентификатор сервиса.
Тело
application/json
Интервал в часах между резервными копиями.
Минимальная длительность в часах, в течение которой доступны резервные копии.
Время в формате HH:MM, в которое должны выполняться резервные копии (рассчитывается по часовому поясу UTC). Если задано, период резервного копирования сбрасывается до каждых 24 часов.
Последнее изменение 12 июня 2026 г.
Была ли эта страница полезной?
⌘I
Обновить конфигурацию резервного копирования сервиса
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
}