Yandex Cloud
Поиск
Связаться с экспертомПопробовать бесплатно
  • Кейсы
  • Документация
  • Блог
  • Все сервисы
    • Cloud Interconnect
    • Cloud Backup
    • Cloud Registry
    • Yandex AI Studio
    • Compute Cloud
    • Object Storage
    • Managed Service for Kubernetes®
    • Yandex BareMetal
    • Smart Web Security
    • Security Deck
    • Managed Service for PostgreSQL
    • Managed Service for ClickHouse®
    • Monium
    • Cloud CDN
    • Network Load Balancer
    • Virtual Private Cloud
    • Cloud DNS
    • Application Load Balancer
    • Yandex Cloud Video
    • Stackland
    • Yandex Cloud Router
    • Yandex Managed Service for Trino
    • Managed Service for MySQL®
    • Managed Service for Valkey™
    • Managed Service for Apache Spark™
    • Yandex StoreDoc
    • Managed Service for OpenSearch
    • Managed Service for Apache Kafka®
    • Data Transfer
    • Yandex MPP Analytics Engine for PostgreSQL
    • Yandex Managed Service for Apache Airflow®
    • Data Processing
    • Yandex MetaData Hub
    • Managed Service for YDB
    • Managed Service for Sharded PostgreSQL
    • Managed Service for YTsaurus
    • Yandex WebSQL
    • DataLens
    • Yandex Search API
    • SpeechSense
    • SpeechKit
    • DataSphere
    • Vision OCR
    • Translate
    • VibeCraft
    • Yandex Cloud Detection and Response
    • Yandex Identity Hub
    • Key Management Service
    • Certificate Manager
    • Yandex Lockbox
    • Audit Trails
    • SmartCaptcha
    • Cloud Desktop
    • GOST Gateway
    • Yandex SIEM
    • SourceCraft Code Assistant
    • Container Registry
    • Managed Service for GitLab
    • SourceCraft
    • Managed Service for Prometheus®
    • Cloud Functions
    • API Gateway
    • Yandex Cloud Postbox
    • Message Queue
    • IoT Core
    • Data Streams
    • Serverless Containers
    • Cloud Notification Service
    • Yandex Query
    • Identity and Access Management
    • Yandex Cloud Console
    • Resource Manager
    • Yandex Cloud Billing
    • Yandex Cloud Quota Manager
    • Cloud Apps
  • Статус работы сервисов
  • Marketplace
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Искусственный интеллект
    • Безопасность
    • Инструменты DevOps
    • Бессерверные вычисления
    • Управление ресурсами
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Yandex Cloud Trust
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
  • Кейсы
  • Документация
  • Блог
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Managed Service for Sharded PostgreSQL
  • Начало работы
    • Все инструкции
    • Получение информации об имеющихся кластерах
    • Создание кластера
    • Изменение кластера
    • Управление хостами кластера
    • Управление шардами
    • Подключение к базе данных
    • Управление доступом к кластеру
    • Управление резервными копиями
    • Техническое обслуживание
    • Просмотр логов кластера
    • Мониторинг состояния кластера и хостов
    • Управление пользователями
    • Управление базами данных
    • Удаление кластера
    • Обновление цепочки TLS-сертификатов
  • Управление доступом
  • Инспекции и рекомендации
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  1. Пошаговые инструкции
  2. Изменение кластера

Изменение кластера Sharded PostgreSQL

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 8 октября 2026 г.
Открыть в Markdown

После создания кластера вы можете изменить его основные и дополнительные настройки.

Консоль управления
CLI
Terraform
REST API
gRPC API
  1. В консоли управления выберите каталог, в котором нужно изменить кластер Sharded PostgreSQL.

  2. Перейдите в сервис Yandex Managed Service for Sharded PostgreSQL.

  3. Выберите кластер и нажмите кнопку Редактировать на панели сверху.

  4. В блоке Базовые параметры:

    • Измените имя и описание кластера.
    • Удалите или добавьте новые метки.
  5. В блоке Сетевые настройки выберите группы безопасности для кластера.

    Важно

    Чтобы роутер мог подключаться к хостам шарда, кластер Managed Service for Sharded PostgreSQL и шарды должны находиться в одной группе безопасности, разрешающей входящие и исходящие TCP-подключения на порт 6432.

  6. Измените конфигурацию вычислительных ресурсов:

    • Для стандартного шардирования измените в блоке Инфраструктура конфигурацию инфраструктурных хостов.
    • Для расширенного шардирования измените в блоке Роутер конфигурацию хостов-роутеров и конфигурацию хостов-координаторов в блоке Координатор.

    Чтобы изменить конфигурацию вычислительных ресурсов:

    1. В поле Платформа измените платформу.
    2. Измените Тип виртуальной машины, на которой развернуты хосты.
    3. Измените Класс хоста.
    4. В блоке Хранилище измените размер хранилища.
  7. Измените дополнительные настройки кластера:

    • Минимальный уровень логирования — в журнал выполнения будут записываться логи указанного уровня и выше. Доступные уровни — DEBUG, INFO, WARN, ERROR, FATAL и PANIC. Уровень по умолчанию — INFO.

    • Начало резервного копирования (UTC) — промежуток времени, в течение которого начинается резервное копирование кластера. Время указывается по UTC в 24-часовом формате. По умолчанию — 22:00 - 23:00 UTC.

    • Срок хранения автоматических резервных копий, дней — автоматические резервные копии будут храниться указанное количество дней. По умолчанию — 7 дней.

    • Обслуживание — настройки времени технического обслуживания:

      • Чтобы разрешить проведение технического обслуживания в любое время, выберите пункт В любое время (по умолчанию).
      • Чтобы указать предпочтительное время начала обслуживания, выберите пункт По расписанию и укажите день недели и интервал времени по UTC. Например, можно выбрать время, когда кластер наименее загружен.

      Операции по техническому обслуживанию проводятся для включенных и выключенных кластеров. Они могут включать обновление СУБД, применение патчей и т. д.

    • Защита от удаления — управляет защитой кластера от непреднамеренного удаления.

      После включения защиты от удаления кластера она также применяется ко всем новым и существующим базам данных и пользователям, для которых защита от удаления не задана явно. Если для базы данных или пользователя задано собственное значение настройки защиты от удаления, оно имеет приоритет над значением настройки кластера.

      Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

  8. В блоке Настройки СУБД нажмите кнопку Настроить и измените настройки СУБД уровня кластера.

  9. Нажмите кнопку Сохранить изменения.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Чтобы изменить параметры кластера и хостов:

  1. Посмотрите описание команды CLI для изменения кластера:

    yc managed-sharded-postgresql cluster update --help
    
  2. Укажите новые параметры кластера в команде изменения (в примере приведены не все параметры):

    • Для кластера со стандартным шардированием:

      yc managed-sharded-postgresql cluster update <имя_или_идентификатор_кластера>  \
       --new-name <имя_кластера> \
       --security-group-ids <идентификаторы_групп_безопасности> \      
       --infra-resource-preset <класс_хоста> \
       --infra-disk-size <размер_хранилища_ГБ> \
       --deletion-protection \
       --maintenance-window type=<тип_технического_обслуживания>,`
                            `day=<день_недели>,`
                            `hour=<порядковый_номер_часового_интервала> \
       --websql-access=<true_или_false> \
       --backup-window-start <время_начала_резервного_копирования> \
       --backup-retain-period-days <срок_хранения_автоматических_резервных_копий>
      
    • Для кластера с расширенным шардированием:

      yc managed-sharded-postgresql cluster update <имя_или_идентификатор_кластера>  \
        --new-name <имя_кластера> \
        --security-group-ids <идентификаторы_групп_безопасности> \      
        --router-resource-preset <класс_хоста> \
        --router-disk-size <размер_хранилища_ГБ> \
        --coordinator-resource-preset <класс_хоста> \
        --coordinator-disk-size <размер_хранилища_ГБ> \
        --deletion-protection \
        --maintenance-window type=<тип_технического_обслуживания>,`
                               `day=<день_недели>,`
                               `hour=<порядковый_номер_часового_интервала> \
        --websql-access=<true_или_false> \
        --backup-window-start <время_начала_резервного_копирования> \
        --backup-retain-period-days <срок_хранения_автоматических_резервных_копий>
      

      Где:

      • <имя_или_идентификатор_кластера> — имя или идентификатор кластера, которые можно получить со списком кластеров в каталоге.

      • --new-name — новое имя кластера.

      • --security-group-ids — список идентификаторов групп безопасности.

        Важно

        Чтобы роутер мог подключаться к хостам шарда, кластер Managed Service for Sharded PostgreSQL и шарды должны находиться в одной группе безопасности, разрешающей входящие и исходящие TCP-подключения на порт 6432.

      • --infra-resource-preset, --router-resource-preset, --coordinator-resource-preset — классы хостов INFRA, ROUTER, COORDINATOR соответственно.

      • --infra-disk-size, --router-disk-size, --coordinator-disk-size — размеры хранилища хостов INFRA, ROUTER, COORDINATOR соответственно.

      • --deletion-protection — защита кластера от непреднамеренного удаления: true или false.

        Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

      • --maintenance-window — настройки времени технического обслуживания (в т. ч. для выключенных кластеров), где type — тип технического обслуживания:

        • anytime (по умолчанию) — в любое время.

        • weekly — по расписанию. Для этого значения дополнительно укажите:

          • day — день недели: MON, TUE, WED, THU, FRI, SAT или SUN.

          • hour — порядковый номер часового интервала по UTC: от 1 до 24.

            Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

      • --backup-retain-period — срок хранения автоматических резервных копий (в днях).

      • --backup-window-start — время начала резервного копирования кластера, задается по UTC в формате HH:MM:SS. Если время не задано, резервное копирование начнется в 22:00 UTC.

Чтобы изменить конфигурацию сервисов кластера:

  1. Посмотрите описание команды CLI для изменения конфигурации:

    yc managed-sharded-postgresql cluster update-config --help
    
  2. Укажите новые параметры конфигурации в команде изменения (в примере приведены не все параметры):

    yc managed-sharded-postgresql cluster update-config <имя_или_идентификатор_кластера>  \
      --set router.show_notice_messages=<показывать_информационные_уведомления>,`
            router.prefer_same_availability_zone=<приоритет_маршрутизации_в_зону_доступности_роутера>,`
            router.default_route_behavior=<разрешать_мультишардовые_запросы>,`
            router.time_quantiles="<список_квантилей_времени_для_отображения_статистики>"
    

    Где:

    • <имя_или_идентификатор_кластера> — имя или идентификатор кластера, которые можно получить со списком кластеров в каталоге.
    • --set — новая конфигурация роутера:
      • router.show_notice_messages — показывать информационные уведомления: true или false.
      • router.prefer_same_availability_zone — включить приоритет маршрутизации запросов на чтение в зону доступности роутера: true или false.
      • router.default_route_behavior — политика выполнения мультишардовых запросов роутером. Возможные значения: BLOCK — блокировать, ALLOW — разрешать.
      • router.time_quantiles — список временных квантилей для отображения статистики. По умолчанию используется значение "0.5,0.75,0.9,0.95,0.99,0.999,0.9999".
  1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

    Как создать такой файл, описано в разделе Создание кластера.

    Полный список доступных для изменения полей конфигурации кластера Managed Service for Sharded PostgreSQL вы найдете в документации провайдера Terraform.

  2. Измените описание ресурсов:

    • Для кластера со стандартным шардированием:

      resource "yandex_mdb_sharded_postgresql_cluster" "<имя_кластера>" {
        ...
        security_group_ids = [ "<список_идентификаторов_групп_безопасности>" ]
        config = {
          sharded_postgresql_config = {
            infra = {
              resources = {
                resource_preset_id = "<класс_хоста>"
                disk_size          = <размер_хранилища_ГБ>
              }
              router = {
                show_notice_messages = <показывать_информационные_уведомления>
                prefer_same_availability_zone = <приоритет_маршрутизации_в_зону_доступности_роутера>
                default_route_behavior = <разрешать_мультишардовые_запросы>
                time_quantiles = [ <список_квантилей_времени_для_отображения_статистики> ]
              }
            }
          }
          deletion_protection = <защитить_кластер_от_удаления>
          maintenance_window = {
            type = "<тип_технического_обслуживания>"
            day  = "<день_недели>"
            hour = <порядковый_номер_часового_интервала>
          }
          backup_retain_period_days = <количество_дней>
          backup_window_start = {
            hours   = <час_начала_резервного_копирования>
            minutes = <минута_начала_резервного_копирования>
          }
        }
      }
      
    • Для кластера с расширенным шардированием:

      resource "yandex_mdb_sharded_postgresql_cluster" "<имя_кластера>" {
        ...
        security_group_ids = [ "<список_идентификаторов_групп_безопасности>" ]
        config = {
          sharded_postgresql_config = {
            router = {
              resources = {
                resource_preset_id = "<класс_хоста>"
                disk_size          = <размер_хранилища_ГБ>
              }
              config = {
                show_notice_messages = <показывать_информационные_уведомления>
                prefer_same_availability_zone = <приоритет_маршрутизации_в_зону_доступности_роутера>
                default_route_behavior = <разрешать_мультишардовые_запросы>
                time_quantiles = [ <список_квантилей_времени_для_отображения_статистики> ]
              }
            }
            coordinator = {
              resources = {
                resource_preset_id = "<класс_хоста>"
                disk_size          = <размер_хранилища_ГБ>
              }
            }
          }
          deletion_protection = <защитить_кластер_от_удаления>
          maintenance_window = {
            type = "<тип_технического_обслуживания>"
            day  = "<день_недели>"
            hour = <порядковый_номер_часового_интервала>
          }
          backup_retain_period_days = <количество_дней>
          backup_window_start = {
            hours   = <час_начала_резервного_копирования>
            minutes = <минута_начала_резервного_копирования>
          }
        }
      }
      

    Где:

    • security_group_ids — идентификаторы групп безопасности.

      Важно

      Чтобы роутер мог подключаться к хостам шарда, кластер Managed Service for Sharded PostgreSQL и шарды должны находиться в одной группе безопасности, разрешающей входящие и исходящие TCP-подключения на порт 6432.

    • deletion_protection — защита кластера от удаления: true или false.

      Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

    • config — настройки кластера:

      • sharded_postgresql_config — настройки сервиса Sharded PostgreSQL:

        • 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 — класс хостов;
            • disk_size — размер диска в ГБ.
        • coordinator – настройки координатора:

          • resources — параметры ресурсов:
            • resource_preset_id — класс хостов;
            • disk_size — размер диска в ГБ.
        • infra – настройки хостов INFRA:

          • resources — параметры ресурсов:

            • resource_preset_id — класс хостов;
            • disk_size — размер диска в ГБ.
          • 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.
    • backup_window_start — настройки окна резервного копирования.

      В параметре укажите время, когда начинать резервное копирование. Возможные значения параметров:

      • hours — от 0 до 23 часов;
      • minutes — от 0 до 59 минут;
    • backup_retain_period_days — сколько дней хранить резервную копию кластера. Возможные значения: от 7 до 60 дней.

    • maintenance_window — настройки расписания окна технического обслуживания:

      • type — тип технического обслуживания. Принимает значения:

        • ANYTIME — в любое время.
        • WEEKLY — по расписанию.
      • day — день недели для типа WEEKLY: MON, TUE, WED, THU, FRI, SAT или SUN.

      • hour — порядковый номер часового интервала по UTC для типа WEEKLY: от 1 до 24.

        Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

    2. Выполните команду:

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

  4. Подтвердите изменение ресурсов.

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

        terraform apply
        
      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

    Ограничения по времени

    Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for Sharded PostgreSQL:

    • создание, в том числе путем восстановления из резервной копии, — 30 минут;
    • изменение — 60 минут;
    • удаление — 15 минут.

    Операции, длящиеся дольше указанного времени, прерываются.

    Как изменить эти ограничения?

    Добавьте к описанию кластера блок timeouts, например:

    resource "yandex_mdb_sharded_postgresql_cluster" "<имя_кластера>" {
      ...
      timeouts {
        create = "1h30m" # Полтора часа
        update = "2h"    # 2 часа
        delete = "30m"   # 30 минут
      }
    }
    
  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"
    
  2. Создайте файл body.json и добавьте в него следующее содержимое:

    {
      "updateMask": "<список_изменяемых_параметров>",
      "name": "<имя_кластера>",
      "description": "<описание>",
      "environment": "<окружение>",
      "securityGroupIds": [
        "<идентификатор_группы_безопасности_1>",
        "<идентификатор_группы_безопасности_2>",
        ...
        "<идентификатор_группы_безопасности_N>"
      ],
      "deletionProtection": <защитить_кластер_от_удаления>,
      "configSpec": {
        "spqrSpec": {
          "router": {
            "config": {
              "showNoticeMessages": <показывать_информационные_уведомления>,
              "timeQuantiles": [
                <список_квантилей_времени_для_отображения_статистики>
              ],
              "defaultRouteBehavior": "<разрешать_мультишардовые_запросы>",
              "preferSameAvailabilityZone": <приоритет_маршрутизации_в_зону_доступности_роутера>
            },
            "resources": {
              "resourcePresetId": "<класс_хостов_роутера>",
              "diskSize": "<размер_хранилища_в_байтах>"
            }
          },
          "coordinator": {
            "resources": {
              "resourcePresetId": "<класс_хостов_координатора>",
              "diskSize": "<размер_хранилища_в_байтах>"
            }
          },
          "infra": {
            "resources": {
              "resourcePresetId": "класс_хостов_INFRA",
              "diskSize": "<размер_хранилища_в_байтах>"
            },
            "router": {
              "showNoticeMessages": <показывать_информационные_уведомления>,
              "timeQuantiles": [
                <список_квантилей_времени_для_отображения_статистики>
              ],
              "defaultRouteBehavior": "<разрешать_мультишардовые_запросы>",
              "preferSameAvailabilityZone": <приоритет_маршрутизации_в_зону_доступности_роутера>
            }
          },
          "consolePassword": "<пароль_консоли_Sharded_PostgreSQL>",
          "logLevel": "<уровень_логирования>"
        },
        "backupWindowStart": {
          "hours": "<часы>",
          "minutes": "<минуты>",
          "seconds": "<секунды>",
          "nanos": "<наносекунды>"
        },
        "backupRetainPeriodDays": "<количество_дней>",
        "maintenanceWindow": {
          "weeklyMaintenanceWindow": {
            "day": "<день_недели>",
            "hour": "<порядковый_номер_часового_интервала>"
          }
        }
      }
    }
    

    Где:

    • updateMask — перечень изменяемых параметров в строку через запятую.

      Важно

      При изменении кластера все параметры изменяемого объекта, которые не были явно переданы в запросе, будут переопределены на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask.

    • name — новое имя кластера.

    • securityGroupIds — идентификаторы групп безопасности.

      Важно

      Чтобы роутер мог подключаться к хостам шарда, кластер Managed Service for Sharded PostgreSQL и шарды должны находиться в одной группе безопасности, разрешающей входящие и исходящие TCP-подключения на порт 6432.

    • deletionProtection — защита кластера от удаления: true или false.

      Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

    • configSpec — настройки кластера:

      • spqrSpec — настройки сервиса Sharded PostgreSQL:

        • 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 — класс хостов;
            • diskSize — размер диска в байтах.
          • coordinator – при расширенном шардировании задайте настройки координатора:

            • resources — параметры ресурсов:
              • resourcePresetId — класс хостов;
              • diskSize — размер диска в байтах.
          • infra – при стандартном шардировании задайте настройки хостов INFRA:

            • resources — параметры ресурсов:

              • resourcePresetId — класс хостов;
              • diskSize — размер диска в байтах.
            • 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 — настройки расписания окна технического обслуживания:

      • anytime — техническое обслуживание проводится в любое время.

      • weeklyMaintenanceWindow — техническое обслуживание проводится раз в неделю в указанное время:

        • day — день недели: MON, TUE, WED, THU, FRI, SAT или SUN.

        • hour — порядковый номер часового интервала по UTC: от 1 до 24.

          Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

  3. Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

    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"
    

    Идентификатор кластера можно получить со списком кластеров в каталоге.

  4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"
    
  2. Клонируйте репозиторий cloudapi:

    cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
    

    Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

  3. Создайте файл body.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": "<размер_хранилища_в_байтах>"
            }
          },
          "coordinator": {
            "resources": {
              "resource_preset_id": "<класс_хостов_координатора>",
              "disk_size": "<размер_хранилища_в_байтах>"
            }
          },
          "infra": {
            "resources": {
              "resource_preset_id": "класс_хостов_INFRA",
              "disk_size": "<размер_хранилища_в_байтах>"
            },
            "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 — идентификатор кластера, который можно получить со списком кластеров в каталоге.

    • update_mask — перечень изменяемых параметров в виде массива строк paths[].

      Формат перечисления настроек
      "update_mask": {
        "paths": [
          "<настройка_1>",
          "<настройка_2>",
          ...
          "<настройка_N>"
        ]
      }
      

      Важно

      При изменении кластера все параметры изменяемого объекта, которые не были явно переданы в запросе, будут переопределены на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask.

    • name — новое имя кластера.

    • security_group_ids — идентификаторы групп безопасности.

      Важно

      Чтобы роутер мог подключаться к хостам шарда, кластер Managed Service for Sharded PostgreSQL и шарды должны находиться в одной группе безопасности, разрешающей входящие и исходящие TCP-подключения на порт 6432.

    • deletion_protection — защита кластера от удаления: true или false.

      Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

    • config_spec — настройки кластера:

      • spqr_spec — настройки сервиса Sharded PostgreSQL:

        • 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 — класс хостов;
            • disk_size — размер диска в байтах.
          • coordinator – при расширенном шардировании задайте настройки координатора:

            • resources — параметры ресурсов:
              • resource_preset_id — класс хостов;
              • disk_size — размер диска в байтах.
          • infra – при стандартном шардировании задайте настройки хостов INFRA:

            • resources — параметры ресурсов:

              • resource_preset_id — класс хостов;
              • disk_size — размер диска в байтах.
            • 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 — настройки расписания окна технического обслуживания:

      • anytime — техническое обслуживание проводится в любое время.

      • weekly_maintenance_window — техническое обслуживание проводится раз в неделю в указанное время:

        • day — день недели: MON, TUE, WED, THU, FRI, SAT или SUN.

        • hour — порядковый номер часового интервала по UTC: от 1 до 24.

          Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

  4. Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:

    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
    
  5. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Была ли статья полезна?

Предыдущая
Создание кластера
Следующая
Управление хостами кластера
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»