[Документация Yandex Cloud](../../index.md) > [Yandex Managed Service for Sharded PostgreSQL](../index.md) > [Пошаговые инструкции](index.md) > Изменение кластера # Изменение кластера Sharded PostgreSQL После создания кластера вы можете изменить его основные и дополнительные настройки. {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://console.yandex.cloud) выберите каталог, в котором нужно изменить кластер Sharded PostgreSQL. 1. Перейдите в сервис **Yandex Managed Service for Sharded PostgreSQL**. 1. Выберите кластер и нажмите кнопку **Редактировать** на панели сверху. 1. В блоке **Базовые параметры**: * Измените имя и описание кластера. * Удалите или добавьте новые [метки](../../resource-manager/concepts/labels.md). 1. В блоке **Сетевые настройки** выберите [группы безопасности](../../vpc/concepts/security-groups.md) для кластера. {% note warning %} Чтобы роутер мог подключаться к хостам шарда, кластер Managed Service for Sharded PostgreSQL и шарды должны находиться в одной [группе безопасности](../../vpc/concepts/security-groups.md), разрешающей входящие и исходящие TCP-подключения на порт `6432`. {% endnote %} 1. Измените конфигурацию вычислительных ресурсов: * Для стандартного шардирования измените в блоке **Инфраструктура** конфигурацию инфраструктурных хостов. * Для расширенного шардирования измените в блоке **Роутер** конфигурацию хостов-роутеров и конфигурацию хостов-координаторов в блоке **Координатор**. Чтобы изменить конфигурацию вычислительных ресурсов: 1. В поле **Платформа** измените платформу. 1. Измените **Тип** виртуальной машины, на которой развернуты хосты. 1. Измените **Класс хоста**. 1. В блоке **Хранилище** измените тип диска и размер хранилища. 1. Измените дополнительные настройки кластера: * **Минимальный уровень логирования** — в журнал выполнения будут записываться логи указанного уровня и выше. Доступные уровни — `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL` и `PANIC`. Уровень по умолчанию — `INFO`. * **Начало резервного копирования (UTC)** — промежуток времени, в течение которого начинается резервное копирование кластера. Время указывается по UTC в 24-часовом формате. По умолчанию — `22:00 - 23:00` UTC. * **Срок хранения автоматических резервных копий, дней** — автоматические резервные копии будут храниться указанное количество дней. По умолчанию — 7 дней. * **Обслуживание** — настройки времени технического обслуживания: * Чтобы разрешить проведение технического обслуживания в любое время, выберите пункт **В любое время** (по умолчанию). * Чтобы указать предпочтительное время начала обслуживания, выберите пункт **По расписанию** и укажите день недели и интервал времени по UTC. Например, можно выбрать время, когда кластер наименее загружен. Операции по техническому обслуживанию проводятся для включенных и выключенных кластеров. Они могут включать в себя: обновление СУБД, применение патчей и так далее. * **Защита от удаления** — управляет защитой кластера от непреднамеренного удаления. Включенная защита кластера от удаления не помешает удалить пользователя или базу данных, а также подключиться вручную и удалить содержимое базы данных. 1. В блоке **Настройки СУБД** нажмите кнопку **Настроить** и измените [настройки СУБД уровня кластера](../concepts/settings-list.md). 1. Нажмите кнопку **Сохранить изменения**. - REST API {#api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Создайте файл `body.json` и добавьте в него следующее содержимое: ```json { "updateMask": "<список_изменяемых_параметров>", "name": "<имя_кластера>", "description": "<описание>", "environment": "<окружение>", "securityGroupIds": [ "<идентификатор_группы_безопасности_1>", "<идентификатор_группы_безопасности_2>", ... "<идентификатор_группы_безопасности_N>" ], "deletionProtection": <защитить_кластер_от_удаления>, "configSpec": { "spqrSpec": { "router": { "config": { "showNoticeMessages": <показывать_информационные_уведомления>, "timeQuantiles": [ <список_квантилей_времени_для_отображения_статистики> ], "defaultRouteBehavior": "<разрешать_мультишардовые_запросы>", "preferSameAvailabilityZone": <приоритет_маршрутизации_в_зону_доступности_роутера> }, "resources": { "resourcePresetId": "<класс_хостов_роутера>", "diskSize": "<размер_хранилища_в_байтах>", "diskTypeId": "<тип_диска>" } }, "coordinator": { "resources": { "resourcePresetId": "<класс_хостов_координатора>", "diskSize": "<размер_хранилища_в_байтах>", "diskTypeId": "<тип_диска>" } }, "infra": { "resources": { "resourcePresetId": "класс_хостов_INFRA", "diskSize": "<размер_хранилища_в_байтах>", "diskTypeId": "<тип_диска>" }, "router": { "showNoticeMessages": <показывать_информационные_уведомления>, "timeQuantiles": [ <список_квантилей_времени_для_отображения_статистики> ], "defaultRouteBehavior": "<разрешать_мультишардовые_запросы>", "preferSameAvailabilityZone": <приоритет_маршрутизации_в_зону_доступности_роутера> } }, "consolePassword": "<пароль_консоли_Sharded_PostgreSQL>", "logLevel": "<уровень_логирования>" }, "backupWindowStart": { "hours": "<часы>", "minutes": "<минуты>", "seconds": "<секунды>", "nanos": "<наносекунды>" }, "backupRetainPeriodDays": "<количество_дней>", "maintenanceWindow": { "weeklyMaintenanceWindow": { "day": "<день_недели>", "hour": "<час_дня>" } } } } ``` Где: * `updateMask` — перечень изменяемых параметров в строку через запятую. {% note warning %} При изменении кластера все параметры изменяемого объекта, которые не были явно переданы в запросе, будут переопределены на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре `updateMask`. {% endnote %} * `name` — новое имя кластера. * `securityGroupIds` — идентификаторы [групп безопасности](../../vpc/concepts/security-groups.md). {% note warning %} Чтобы роутер мог подключаться к хостам шарда, кластер Managed Service for Sharded PostgreSQL и шарды должны находиться в одной [группе безопасности](../../vpc/concepts/security-groups.md), разрешающей входящие и исходящие TCP-подключения на порт `6432`. {% endnote %} * `deletionProtection` — защита кластера от удаления: `true` или `false`. Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные. * `configSpec` — настройки кластера: * `spqrSpec` — настройки сервиса Sharded PostgreSQL: * `router` — при [расширенном шардировании](../concepts/index.md#router) задайте настройки роутера: * `config` — конфигурация роутера: * `showNoticeMessages` — показывать информационные уведомления: `true` или `false`. * `timeQuantiles` — массив строк временных квантилей для отображения статистики. По умолчанию используются значения `"0.5"`, `"0.75"`, `"0.9"`, `"0.95"`, `"0.99"`, `"0.999"`, `"0.9999"`. * `defaultRouteBehavior` — политика выполнения мультишардовых запросов роутером. Возможные значения: `BLOCK` — блокировать, `ALLOW` — разрешать. * `preferSameAvailabilityZone` — включить приоритет маршрутизации запросов на чтение в зону доступности роутера: `true` или `false`. * `resources` — параметры ресурсов хостов `ROUTER`: * `resourcePresetId` — [класс хостов](../concepts/instance-types.md); * `diskSize` — размер диска в байтах; * `diskTypeId` — [тип диска](../concepts/storage.md). * `coordinator` – при расширенном шардировании задайте настройки координатора: * `resources` — параметры ресурсов: * `resourcePresetId` — класс хостов; * `diskSize` — размер диска в байтах; * `diskTypeId` — тип диска. * `infra` – при стандартном шардировании задайте настройки хостов `INFRA`: * `resources` — параметры ресурсов: * `resourcePresetId` — класс хостов; * `diskSize` — размер диска в байтах; * `diskTypeId` — тип диска. * `router` — конфигурация роутера: * `showNoticeMessages` — показывать информационные уведомления: `true` или `false`. * `timeQuantiles` — массив строк временных квантилей для отображения статистики. По умолчанию используются значения `"0.5"`, `"0.75"`, `"0.9"`, `"0.95"`, `"0.99"`, `"0.999"`, `"0.9999"`. * `defaultRouteBehavior` — политика выполнения мультишардовых запросов роутером. Возможные значения: `BLOCK` — блокировать, `ALLOW` — разрешать. * `preferSameAvailabilityZone` — включить приоритет маршрутизации запросов на чтение в зону доступности роутера: `true` или `false`. * `consolePassword` — пароль консоли Sharded PostgreSQL. * `logLevel` — уровень логирования запросов: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `FATAL`, `PANIC`. * `backupWindowStart` — настройки окна резервного копирования. В параметре укажите время, когда начинать резервное копирование. Возможные значения параметров: * `hours` — от `0` до `23` часов; * `minutes` — от `0` до `59` минут; * `seconds` — от `0` до `59` секунд; * `nanos` — от `0` до `999999999` наносекунд. * `backupRetainPeriodDays` — сколько дней хранить резервную копию кластера. Возможные значения: от `7` до `60` дней. * `maintenanceWindow` — настройки расписания окна технического обслуживания: * `day` — день недели в формате `DDD`, когда должно проходить обслуживание. * `hour` — час дня в формате `HH`, когда должно проходить обслуживание. Допустимые значения: от `1` до `24`. 1. Воспользуйтесь методом [Cluster.Update](../api-ref/Cluster/update.md) и выполните запрос, например с помощью [cURL](https://curl.se/): ```bash curl \ --request PATCH \ --header "Authorization: Bearer $IAM_TOKEN" \ --header "Content-Type: application/json" \ --url 'https://mdb.api.cloud.yandex.net/managed-spqr/v1/clusters/<идентификатор_кластера>' \ --data "@body.json" ``` Идентификатор кластера можно получить со [списком кластеров](cluster-list.md#list-clusters) в каталоге. 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/Cluster/update.md#yandex.cloud.operation.Operation). - gRPC API {#grpc-api} 1. [Получите IAM-токен для аутентификации в API](../api-ref/authentication.md) и поместите токен в переменную среды окружения: ```bash export IAM_TOKEN="" ``` 1. Клонируйте репозиторий [cloudapi](https://github.com/yandex-cloud/cloudapi): ```bash cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi ``` Далее предполагается, что содержимое репозитория находится в директории `~/cloudapi/`. 1. Создайте файл `body.json` и добавьте в него следующее содержимое: ```json { "cluster_id": "<идентификатор_кластера>", "update_mask": { "paths": [ <список_изменяемых_параметров> ] }, "name": "<имя_кластера>", "description": "<описание>", "security_group_ids": [ "<идентификатор_группы_безопасности_1>", "<идентификатор_группы_безопасности_2>", ... "<идентификатор_группы_безопасности_N>" ], "deletion_protection": <защитить_кластер_от_удаления>, "config_spec": { "spqr_spec": { "router": { "config": { "show_notice_messages": { "value": <показывать_информационные_уведомления> }, "time_quantiles": [ <список_квантилей_времени_для_отображения_статистики> ], "default_route_behavior": "<разрешать_мультишардовые_запросы>", "prefer_same_availability_zone": { "value": <приоритет_маршрутизации_в_зону_доступности_роутера> } }, "resources": { "resource_preset_id": "<класс_хостов_роутера>", "disk_size": "<размер_хранилища_в_байтах>", "disk_type_id": "<тип_диска>" } }, "coordinator": { "resources": { "resource_preset_id": "<класс_хостов_координатора>", "disk_size": "<размер_хранилища_в_байтах>", "disk_type_id": "<тип_диска>" } }, "infra": { "resources": { "resource_preset_id": "класс_хостов_INFRA", "disk_size": "<размер_хранилища_в_байтах>", "disk_type_id": "<тип_диска>" }, "router": { "show_notice_messages": { "value": <показывать_информационные_уведомления> }, "time_quantiles": [ <список_квантилей_времени_для_отображения_статистики> ], "default_route_behavior": "<разрешать_мультишардовые_запросы>", "prefer_same_availability_zone": { "value": <приоритет_маршрутизации_в_зону_доступности_роутера> } } }, "console_password": "<пароль_консоли_Sharded_PostgreSQL>", "log_level": "<уровень_логирования>" }, "backup_window_start": { "hours": "<часы>", "minutes": "<минуты>", "seconds": "<секунды>", "nanos": "<наносекунды>" }, "backup_retain_period_days": "<количество_дней>" }, "maintenance_window": { "weekly_maintenance_window": { "day": "<день_недели>", "hour": "<час_дня>" } } } ``` Где: * `cluster_id` — идентификатор кластера, который можно получить со [списком кластеров](cluster-list.md#list-clusters) в каталоге. * `update_mask` — перечень изменяемых параметров в виде массива строк `paths[]`. {% cut "Формат перечисления настроек" %} ```yaml "update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] } ``` {% endcut %} {% note warning %} При изменении кластера все параметры изменяемого объекта, которые не были явно переданы в запросе, будут переопределены на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре `update_mask`. {% endnote %} * `name` — новое имя кластера. * `security_group_ids` — идентификаторы [групп безопасности](../../vpc/concepts/security-groups.md). {% note warning %} Чтобы роутер мог подключаться к хостам шарда, кластер Managed Service for Sharded PostgreSQL и шарды должны находиться в одной [группе безопасности](../../vpc/concepts/security-groups.md), разрешающей входящие и исходящие TCP-подключения на порт `6432`. {% endnote %} * `deletion_protection` — защита кластера от удаления: `true` или `false`. Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные. * `config_spec` — настройки кластера: * `spqr_spec` — настройки сервиса Sharded PostgreSQL: * `router` — при [расширенном шардировании](../concepts/index.md#router) задайте настройки роутера: * `config` — конфигурация роутера: * `show_notice_messages` — показывать информационные уведомления: `true` или `false`. * `time_quantiles` — массив временных квантилей для отображения статистики. По умолчанию используются значения `0.5`, `0.75`, `0.9`, `0.95`, `0.99`, `0.999`, `0.9999`. * `default_route_behavior` — политика выполнения мультишардовых запросов роутером. Возможные значения: `BLOCK` — блокировать, `ALLOW` — разрешать. * `prefer_same_availability_zone` — включить приоритет маршрутизации запросов на чтение в зону доступности роутера: `true` или `false`. * `resources` — параметры ресурсов хостов `ROUTER`: * `resource_preset_id` — [класс хостов](../concepts/instance-types.md); * `disk_size` — размер диска в байтах; * `disk_type_id` — [тип диска](../concepts/storage.md). * `coordinator` – при расширенном шардировании задайте настройки координатора: * `resources` — параметры ресурсов: * `resource_preset_id` — класс хостов; * `disk_size` — размер диска в байтах; * `disk_type_id` — тип диска. * `infra` – при стандартном шардировании задайте настройки хостов `INFRA`: * `resources` — параметры ресурсов: * `resource_preset_id` — класс хостов; * `disk_size` — размер диска в байтах; * `disk_type_id` — тип диска. * `router` — конфигурация роутера: * `show_notice_messages` — показывать информационные уведомления: `true` или `false`. * `time_quantiles` — массив временных квантилей для отображения статистики. По умолчанию используются значения `0.5`, `0.75`, `0.9`, `0.95`, `0.99`, `0.999`, `0.9999`. * `default_route_behavior` — политика выполнения мультишардовых запросов роутером. Возможные значения: `BLOCK` — блокировать, `ALLOW` — разрешать. * `prefer_same_availability_zone` — включить приоритет маршрутизации запросов на чтение в зону доступности роутера: `true` или `false`. * `console_password` — пароль консоли Sharded PostgreSQL. * `log_level` — уровень логирования запросов: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `FATAL`, `PANIC`. * `backup_window_start` — настройки окна резервного копирования. В параметре укажите время, когда начинать резервное копирование. Возможные значения параметров: * `hours` — от `0` до `23` часов; * `minutes` — от `0` до `59` минут; * `seconds` — от `0` до `59` секунд; * `nanos` — от `0` до `999999999` наносекунд. * `backup_retain_period_days` — сколько дней хранить резервную копию кластера. Возможные значения: от `7` до `60` дней. * `maintenance_window` — настройки расписания окна технического обслуживания: * `day` — день недели в формате `DDD`, когда должно проходить обслуживание. * `hour` — час дня в формате `HH`, когда должно проходить обслуживание. Допустимые значения: от `1` до `24`. 1. Воспользуйтесь вызовом [ClusterService.Update](../api-ref/grpc/Cluster/update.md) и выполните запрос, например с помощью [gRPCurl](https://github.com/fullstorydev/grpcurl): ```bash grpcurl \ -format json \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \ -rpc-header "Authorization: Bearer $IAM_TOKEN" \ -d @ \ mdb.api.cloud.yandex.net:443 \ yandex.cloud.mdb.spqr.v1.ClusterService.Update \ < body.json ``` 1. Убедитесь, что запрос был выполнен успешно, изучив [ответ сервера](../api-ref/grpc/Cluster/update.md#yandex.cloud.operation.Operation). {% endlist %}