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

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

Посмотрите описание команды CLI для изменения кластера:
```
yc managed-redis cluster update --help
```

Укажите новые имя и описание в команде изменения кластера:

yc managed-redis cluster update <имя_или_идентификатор_кластера> \
  --new-name <новое_имя_кластера> \
  --description <новое_описание_кластера>

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

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

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

Измените в описании кластера Yandex Managed Service for Valkey™ значение параметра description:

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  description = "<новое_описание_кластера>"
}

Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "name,description",
              "name": "<новое_имя_кластера>",
              "description": "<новое_описание_кластера>"
            }'
```
Где updateMask — перечень изменяемых параметров в одну строку через запятую.

Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ "name", "description" ]
          },
          "name": "<новое_имя_кластера>",
          "description": "<новое_описание_кластера>" 
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где update_mask — перечень изменяемых параметров в виде массива строк paths[].

Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Настроить использование FQDN вместо IP-адресов

Если соответствующая настройка отключена (по умолчанию), то Valkey™ использует IP-адреса в качестве адресов хостов. Если эта настройка включена, то IP-адрес хоста будет подменяться на его FQDN. Подробнее об этой настройке и сферах ее применения см. в разделе Использование FQDN вместо IP-адресов.

Примечание

Некоторые клиенты несовместимы с этой настройкой и не смогут подключиться к хостам кластера. Такие клиенты ожидают именно IP-адрес и некорректно обрабатывают ситуацию, когда IP-адрес подменяется на FQDN.

Консоль управления

CLI

Terraform

REST API

gRPC API

Чтобы включить или выключить использование FQDN вместо IP-адресов:

В консоли управления перейдите в каталог с нужным кластером.
Перейдите в сервис Yandex Managed Service for Valkey™.
Выберите нужный кластер.
В верхней части страницы нажмите кнопку Редактировать.
В блоке Базовые параметры включите или выключите опцию Использовать FQDN вместо IP-адресов.
Нажмите кнопку Сохранить изменения.

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

Чтобы включить или выключить использование FQDN вместо IP-адресов:

Посмотрите описание команды CLI для изменения кластера:
```
yc managed-redis cluster update --help
```
Укажите нужное значение настройки в команде изменения кластера:
```
yc managed-redis cluster update <имя_или_идентификатор_кластера> \
  --announce-hostnames <использование_FQDN_вместо_IP-адресов>
```
Где --announce-hostnames — настройка, определяющая, использовать ли FQDN вместо IP-адресов: true или false.

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

Чтобы включить или выключить использование FQDN вместо IP-адресов:

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание кластера.
Измените в описании кластера Yandex Managed Service for Valkey™ значение параметра announce_hostnames:
```
resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  announce_hostnames = <использование_FQDN_вместо_IP-адресов>
}
```
Где announce_hostnames — настройка, определяющая, использовать ли FQDN вместо IP-адресов: true или false.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "announceHostnames",
              "announceHostnames": <использование_FQDN_вместо_IP-адресов>
            }'
```
Где:
- updateMask — перечень изменяемых параметров в одну строку через запятую.
  
  В данном случае передается только один параметр.
- announceHostnames — использование FQDN вместо IP-адресов: true или false.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ "announce_hostnames" ]
          },
          "announce_hostnames": <использование_FQDN_вместо_IP-адресов>
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где:
- update_mask — перечень изменяемых параметров в виде массива строк paths[].
  
  В данном случае передается только один параметр.
- announce_hostnames — использование FQDN вместо IP-адресов: true или false.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Изменить режим персистентности данных

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

Консоль управления

CLI

Terraform

REST API

gRPC API

Чтобы изменить режим персистентности:

В консоли управления перейдите в каталог с нужным кластером.
Перейдите в сервис Yandex Managed Service for Valkey™.
Выберите нужный кластер.
В верхней части страницы нажмите кнопку Редактировать.
В блоке Базовые параметры выберите режим персистентности.
Нажмите кнопку Сохранить изменения.

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

Чтобы изменить режим персистентности:

Посмотрите описание команды CLI для изменения кластера:
```
yc managed-redis cluster update --help
```
Укажите нужное значение настройки в команде изменения кластера:
```
yc managed-redis cluster update <имя_или_идентификатор_кластера> \
  --persistence-mode <режим_персистентности>
```
Возможные значения:
- ON — включить персистентность.
- OFF — выключить персистентность.
- ON_REPLICAS — включить персистентность только на репликах.
Имя и идентификатор кластера можно получить со списком кластеров в каталоге.

Чтобы изменить режим персистентности:

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание кластера.
Измените в описании кластера Yandex Managed Service for Valkey™ значение параметра persistence_mode:
```
resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  persistence_mode = "<режим_персистентности>"
}
```
Возможные значения:
- ON — включить персистентность.
- OFF — выключить персистентность.
- ON_REPLICAS — включить персистентность только на репликах.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "persistenceMode",
              "persistenceMode": "<режим_персистентности>"
            }'
```
Где:
- updateMask — перечень изменяемых параметров в одну строку через запятую.
  
  В данном случае передается только один параметр.
- persistenceMode — режим персистентности.
  
  Возможные значения:
  - ON — включить персистентность.
  - OFF — выключить персистентность.
  - ON_REPLICAS — включить персистентность только на репликах.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ "persistence_mode" ]
          },
          "persistence_mode": "<режим_персистентности>"
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где:
- update_mask — перечень изменяемых параметров в виде массива строк paths[].
  
  В данном случае передается только один параметр.
- persistence_mode — режим персистентности.
  
  Возможные значения:
  - ON — включить персистентность.
  - OFF — выключить персистентность.
  - ON_REPLICAS — включить персистентность только на репликах.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Изменить класс хостов

При смене класса хостов:

Кластер из одного хоста будет недоступен несколько минут, соединения с БД будут прерваны.
В нешардированном кластере из нескольких хостов:
- Сменится мастер. Каждый хост по очереди будет остановлен и обновлен, остановленный хост будет недоступен несколько минут.
- Подключение по особому FQDN не гарантирует стабильность соединения с БД: пользовательские сессии могут быть прерваны.
В шардированном кластере:
- В каждом шарде из нескольких хостов сменится мастер.
- Хосты в каждом шарде по очереди будут остановлены и обновлены, остановленный хост-мастер шарда будет недоступен несколько минут.
- Разрешение имени хоста-мастера может быть недоступно. Если включен публичный доступ к хосту, то подключение будет возможно только по IP-адресу хоста.
Кластер с хранилищем на локальных SSD-дисках может быть недоступен длительное время, если потребуется миграция данных на другой физический сервер.

Рекомендуется изменять класс хостов только во время отсутствия рабочей нагрузки на кластер.

Консоль управления

CLI

Terraform

REST API

gRPC API

В консоли управления перейдите в каталог с нужным кластером.
Перейдите в сервис Yandex Managed Service for Valkey™.
Выберите нужный кластер.
В верхней части страницы нажмите кнопку Редактировать.
В блоке Класс хоста:
- В поле Платформа выберите платформу.
- Выберите Тип виртуальной машины, на которой разворачиваются хосты:
  - high-memory — с увеличенным объемом RAM на 1 vCPU;
  - burstable — с неполной гарантированной долей vCPU. ВМ с гарантированной долей меньше 100% обеспечивают указанный уровень производительности с вероятностью временного повышения вплоть до 100%. Кластеры с такими хостами подходят для задач, которые не требуют постоянной гарантии производительности (например, тестирование).
- Измените конфигурацию хостов.
Нажмите кнопку Сохранить изменения.

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

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

Посмотрите описание команды CLI для изменения кластера:
```
yc managed-redis cluster update --help
```

Запросите список доступных классов хостов (в колонке ZONE IDS указаны зоны доступности, в которых можно выбрать соответствующий класс):

yc managed-redis resource-preset list

Результат:

+-------------+--------------------------------+----------+
|     ID      |            ZONE IDS            |  MEMORY  |
+-------------+--------------------------------+----------+
| b1.nano     | ru-central1-a, ru-central1-b,  | 2.0 GB   |
|             | ru-central1-d                  |          |
| b1.small    | ru-central1-a, ru-central1-b,  | 4.0 GB   |
|             | ru-central1-d                  |          |
| hm1.nano    | ru-central1-a, ru-central1-b,  | 8.0 GB   |
|             | ru-central1-d                  |          |
| hm1.micro   | ru-central1-a, ru-central1-b,  | 12.0 GB  |
| ...                                                     |
+-----------+----------------------------------+----------+

Укажите нужный класс в команде изменения кластера:
```
yc managed-redis cluster update <имя_или_идентификатор_кластера> \
  --resource-preset <идентификатор_класса_хостов>
```
Yandex Managed Service for Valkey™ запустит операцию изменения класса хостов для кластера.

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание кластера.
Измените в описании кластера Yandex Managed Service for Valkey™ значение параметра resource_preset_id в блоке resources:
```
resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  resources = {
    resource_preset_id = "<класс_хоста>"
    ...
    }
}
```
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "configSpec.resources.resourcePresetId",
              "configSpec": {
                "resources": {
                  "resourcePresetId": "<класс_хостов>"
                }
              }
            }'
```
Где:
- updateMask — перечень изменяемых параметров в одну строку через запятую.
  
  В данном случае передается только один параметр.
- configSpec.resources.resourcePresetId — новый класс хостов. Чтобы получить список поддерживаемых значений, воспользуйтесь методом ResourcePreset.List.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ "config_spec.resources.resource_preset_id" ]
          },
          "config_spec": {
            "resources": {
              "resource_preset_id": "<класс_хостов>"
            }
          }
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где:
- update_mask — перечень изменяемых параметров в виде массива строк paths[].
  
  В данном случае передается только один параметр.
- config_spec.resources.resource_preset_id — новый класс хостов. Чтобы получить список поддерживаемых значений, воспользуйтесь методом ResourcePreset.List.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Изменить тип диска и увеличить размер хранилища

Проверьте, что в облаке достаточно квот для увеличения хранилища. Откройте страницу Квоты для облака и убедитесь, что в секции Managed Databases в строке Объём HDD-хранилищ или Объём SSD-хранилищ есть квота на объем хранилищ.

Консоль управления

CLI

Terraform

REST API

gRPC API

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

В консоли управления перейдите в каталог с нужным кластером.
Перейдите в сервис Yandex Managed Service for Valkey™.
Выберите нужный кластер.
В верхней части страницы нажмите кнопку Редактировать.
В блоке Размер хранилища:
- Выберите тип диска.
- Укажите нужный размер диска.
Нажмите кнопку Сохранить изменения.

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

Чтобы увеличить размер хранилища хостов Valkey™:

Посмотрите описание команды CLI для изменения кластера:
```
yc managed-redis cluster update --help
```
Укажите нужный размер хранилища в команде изменения кластера. Новый размер должен быть не меньше, чем текущее значение disk_size в свойствах кластера.
```
yc managed-redis cluster update <имя_или_идентификатор_кластера> \
  --disk-size <размер_хранилища_ГБ>
```
Если все условия выполнены, Yandex Managed Service for Valkey™ запустит операцию по увеличению размера дисков хостов Valkey™.

Чтобы увеличить размер хранилища для кластера:

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

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

Измените в описании кластера Yandex Managed Service for Valkey™ значение параметра disk_size в блоке resources:

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  resources = {
    disk_size = <размер_хранилища_ГБ>
    ...
    }
}

Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "configSpec.resources.diskTypeId,configSpec.resources.diskSize",
              "configSpec": {
                "resources": {
                  "diskTypeId": "<тип_диска>",
                  "diskSize": "<размер_хранилища_в_байтах>"
                }
              }
            }'
```
Где:
- updateMask — перечень изменяемых параметров в одну строку через запятую.
- configSpec.resources — параметры хранилища:
  - diskTypeId — тип диска.
  - diskSize — новый размер хранилища в байтах.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ 
              "config_spec.resources.disk_type_id",
              "config_spec.resources.disk_size"
            ]
          },
          "config_spec": {
            "resources": {
              "disk_type_id": "<тип_диска>",
              "disk_size": "<размер_хранилища_в_байтах>"
            }
          }
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где:
- update_mask — перечень изменяемых параметров в виде массива строк paths[].
- config_spec.resources — параметры хранилища:
  - disk_type_id — тип диска.
  - disk_size — новый размер хранилища в байтах.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Настроить автоматическое увеличение размера хранилища

Подробнее о хранилище и автоматическом увеличении см. в разделе Хранилище в Yandex Managed Service for Valkey™.

Консоль управления

CLI

Terraform

REST API

gRPC API

Перейдите в сервис Yandex Managed Service for Valkey™.
В строке с нужным кластером нажмите на значок , затем выберите Изменить.
В блоке Ресурсы настройте автоматическое увеличение размера диска:
- В поле Увеличивать размер задайте соответствующие условия, чтобы:
  - Размер хранилища увеличился в следующее окно обслуживания, когда хранилище окажется заполнено более чем на указанную долю (%). Если вы задали этот параметр, настройте расписание технического обслуживания.
  - Размер хранилища увеличился незамедлительно, когда хранилище окажется заполнено более чем на указанную долю (%).
    
    Важно
    
    Если заданы оба условия, порог для незамедлительного увеличения должен быть выше, чем для планового.
- В поле Максимальный размер хранилища укажите максимальный размер хранилища, который может быть установлен при автоматическом увеличении размера хранилища.
Важно
- Размер хранилища не может быть уменьшен после автоматического увеличения.
- Во время изменения размера хранилища хосты кластера будут по очереди остановлены и обновлены.
Сохраните изменения.

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

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

Посмотрите описание команды CLI для изменения кластера:
```
yc managed-redis cluster update --help
```
Укажите максимальный размер хранилища и условия для его увеличения в команде изменения кластера.
```
yc managed-redis cluster update <идентификатор_или_имя_кластера> \
    --disk-size-autoscaling planned-usage-threshold=<процент_для_планового_увеличения>,`
                            `emergency-usage-threshold=<процент_для_незамедлительного_увеличения>,`
                            `disk-size-limit=<максимальный_размер_хранилища_в_гигабайтах> \
```
Где:
- planned-usage-threshold — процент заполнения хранилища, при котором хранилище будет увеличено в следующее окно обслуживания.
  
  Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено).
  
  Если вы задали этот параметр, настройте расписание технического обслуживания.
- emergency-usage-threshold — процент заполнения хранилища, при котором хранилище будет увеличено немедленно.
  
  Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено).
  
  Важно
  
  Если заданы оба порога, значение emergency-usage-threshold должно быть не меньше planned-usage-threshold.
- disk-size-limit — максимальный размер хранилища в гигабайтах после увеличения.
Важно
- Размер хранилища не может быть уменьшен после автоматического увеличения.
- Во время изменения размера хранилища хосты кластера будут по очереди остановлены и обновлены.

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

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание кластера.
Добавьте в описание кластера блок:
```
disk_size_autoscaling = {
  planned_usage_threshold   = "<процент_для_планового_увеличения>"
  emergency_usage_threshold = "<процент_для_незамедлительного_увеличения>"
  disk_size_limit           = "<максимальный_размер_хранилища_в_гибибайтах>"
}
```
Где:
- planned_usage_threshold — процент заполнения хранилища, при котором хранилище будет увеличено в следующее окно обслуживания.
  
  Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено).
  
  Если вы задали этот параметр, настройте расписание технического обслуживания в блоке maintenance_window.
- emergency_usage_threshold — процент заполнения хранилища, при котором хранилище будет увеличено немедленно.
  
  Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено).
  
  Важно
  
  Если заданы оба порога, значение emergency_usage_threshold должно быть не меньше planned_usage_threshold.
- disk_size_limit — максимальный размер хранилища в гибибайтах после увеличения.
Важно
- Размер хранилища не может быть уменьшен после автоматического увеличения.
- Во время изменения размера хранилища хосты кластера будут по очереди остановлены и обновлены.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "configSpec.diskSizeAutoscaling",
              "configSpec": {
                "diskSizeAutoscaling": {
                  "plannedUsageThreshold": "<процент_для_планового_увеличения>",
                  "emergencyUsageThreshold": "<процент_для_незамедлительного_увеличения>",
                  "diskSizeLimit": "<максимальный_размер_хранилища_в_байтах>"
                }
              }
            }'
```
Где:
- updateMask — перечень изменяемых параметров в одну строку через запятую.
- diskSizeAutoscaling — настройки автоматического увеличения размера хранилища:
  - plannedUsageThreshold — процент заполнения хранилища, при котором хранилище будет увеличено в следующее окно обслуживания.
    
    Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено).
    
    Если вы задали этот параметр, настройте расписание технического обслуживания с помощью maintenanceWindow.
  - emergencyUsageThreshold — процент заполнения хранилища, при котором хранилище будет увеличено немедленно.
    
    Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено).
    
    Важно
    
    Если заданы оба порога, значение emergencyUsageThreshold должно быть не меньше plannedUsageThreshold.
  - diskSizeLimit — максимальный размер хранилища в байтах после увеличения.
  Важно
  - Размер хранилища не может быть уменьшен после автоматического увеличения.
  - Во время изменения размера хранилища хосты кластера будут по очереди остановлены и обновлены.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ "config_spec.disk_size_autoscaling" ]
          },
          "config_spec": {
            "disk_size_autoscaling": {
              "planned_usage_threshold": "<процент_для_планового_увеличения>",
              "emergency_usage_threshold": "<процент_для_незамедлительного_увеличения>",
              "disk_size_limit": "<максимальный_размер_хранилища_в_байтах>"
            }
          }
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где:
- update_mask — перечень изменяемых параметров в виде массива строк paths[].
- disk_size_autoscaling — настройки автоматического увеличения размера хранилища:
  - planned_usage_threshold — процент заполнения хранилища, при котором хранилище будет увеличено в следующее окно обслуживания.
    
    Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено).
    
    Если вы задали этот параметр, настройте расписание технического обслуживания с помощью maintenance_window.
  - emergency_usage_threshold — процент заполнения хранилища, при котором хранилище будет увеличено немедленно.
    
    Значение задается в процентах от 0 до 100. По умолчанию — 0 (автоматическое расширение отключено).
    
    Важно
    
    Если заданы оба порога, значение emergency_usage_threshold должно быть не меньше planned_usage_threshold.
  - disk_size_limit — максимальный размер хранилища в байтах после увеличения.
  Важно
  - Размер хранилища не может быть уменьшен после автоматического увеличения.
  - Во время изменения размера хранилища хосты кластера будут по очереди остановлены и обновлены.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Изменить настройки Valkey™

Вы можете изменить настройки СУБД для хостов вашего кластера. Все поддерживаемые настройки описаны в разделе Настройки Valkey™ и в справочнике API.

Консоль управления

Terraform

REST API

gRPC API

Чтобы изменить настройки СУБД для кластера:

В консоли управления перейдите в каталог с нужным кластером.
Перейдите в сервис Yandex Managed Service for Valkey™.
Выберите нужный кластер.
В верхней части страницы нажмите кнопку Редактировать.
В разделе Настройки СУБД нажмите кнопку Настроить.
Настройте доступные параметры в соответствии с документацией Valkey™.
Нажмите кнопку Сохранить.

Чтобы изменить настройки СУБД для кластера:

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание кластера.
Измените в описании кластера Yandex Managed Service for Valkey™ значения параметров в блоке config:
```
resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  config = {
    password         = "<пароль>"
    timeout          = <время>
    maxmemory_policy = "<политика>"
    ...
  }
}
```
Где:
- timeout — время в секундах перед отключением неактивных клиентов.
- maxmemory_policy — политика управления памятью при ее дефиците.
Допустимая длина пароля — от 8 до 128 символов. Пароль должен удовлетворять регулярному выражению [a-zA-Z0-9@=+?*.,!&#$^<>_-]*.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "configSpec.redisConfig_<версия_Valkey™>.<настройка_1>,configSpec.redisConfig_<версия_Valkey™>.<настройка_2>,...,configSpec.redisConfig_<версия_Valkey™>.<настройка_N>",
              "configSpec": {
                "redisConfig_<версия_Valkey™>": {
                  "<настройка_1>": "<значение_1>",
                  "<настройка_2>": "<значение_2>",
                  ...
                  "<настройка_N>": "<значение_N>"
                }
              }
            }'
```
Где:
- updateMask — перечень изменяемых параметров в одну строку через запятую.
- configSpec.redisConfig_<версия_Valkey™> — набор настроек Valkey™. Укажите каждую настройку на отдельной строке через запятую.
  
  Список версий Valkey™, доступных для параметра, см. в описании метода. Описание и возможные значения настроек см. в разделе Настройки Valkey™.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ 
              "config_spec.redis_config_<версия_Valkey™>.<настройка_1>",
              "config_spec.redis_config_<версия_Valkey™>.<настройка_2>",
              ...
              "config_spec.redis_config_<версия_Valkey™>.<настройка_N>"
            ]
          },
          "config_spec": {
            "redis_config_<версия_Valkey™>": {
              "<настройка_1>": "<значение_1>",
              "<настройка_2>": "<значение_2>",
              ...
              "<настройка_N>": "<значение_N>"
            }
          }
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где:
- update_mask — перечень изменяемых параметров в виде массива строк paths[].
- config_spec.redis_config_<версия_Valkey™> — набор настроек Valkey™. Укажите каждую настройку на отдельной строке через запятую.
  
  Список версий Valkey™, доступных для параметра, см. в описании метода. Описание и возможные значения настроек см. в разделе Настройки Valkey™.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Изменить дополнительные настройки кластера

Консоль управления

CLI

Terraform

REST API

gRPC API

В консоли управления перейдите в каталог с нужным кластером.
Перейдите в сервис Yandex Managed Service for Valkey™.
Выберите нужный кластер.
В верхней части страницы нажмите кнопку Редактировать.
Измените дополнительные настройки кластера:
- Начало резервного копирования (UTC) — время по UTC, когда требуется начать резервное копирование кластера (в 24-часовом формате). Если время не задано, резервное копирование начнется в 22:00 UTC.
- Обслуживание — настройки времени технического обслуживания:
  - Чтобы разрешить проведение технического обслуживания в любое время, выберите пункт В любое время (по умолчанию).
  - Чтобы указать предпочтительное время начала обслуживания, выберите пункт По расписанию и укажите день недели и интервал времени по UTC. Например, можно выбрать время, когда кластер наименее загружен.
  Операции по техническому обслуживанию проводятся для включенных и выключенных кластеров. Они могут включать в себя: обновление СУБД, применение патчей и так далее.
- Защита от удаления — управляет защитой кластера от непреднамеренного удаления.
  
  Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.
- Доступ из WebSQL — опция разрешает выполнять SQL-запросы к базам данных кластера из консоли управления Yandex Cloud с помощью сервиса Yandex WebSQL.
Нажмите кнопку Сохранить изменения.

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

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

Посмотрите описание команды CLI для изменения кластера:
```
yc managed-redis cluster update --help
```

Выполните команду, передав список настроек, которые хотите изменить:

yc managed-redis cluster update <имя_или_идентификатор_кластера> \
    --backup-window-start <время> \
    --maintenance-window type=<тип_технического_обслуживания>,`
                        `day=<день_недели>,`
                        `hour=<час_дня> \
    --websql-access=<true_или_false> \
    --deletion-protection

Вы можете изменить следующие настройки:

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

--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.
--websql-access — разрешает выполнять SQL-запросы к базам данных кластера из консоли управления Yandex Cloud с помощью сервиса Yandex WebSQL. Значение по умолчанию — false.
--deletion-protection — защита кластера от непреднамеренного удаления: true или false.

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

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

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание кластера.
Измените в описании кластера Yandex Managed Service for Valkey™ значения нужных вам параметров:
- Для настройки времени начала резервного копирования добавьте в блок config параметр backup_window_start:
```
resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  config = {
    ...
    backup_window_start = {
      hours   = <часы>
      minutes = <минуты>
    }
}
```
  Где:
  - hours — час начала резервного копирования по UTC в формате HH: от 0 до 23 часов.
  - minutes — минута начала резервного копирования по UTC в формате mm: от 0 до 59 минут.
- Чтобы настроить время технического обслуживания (в т. ч. для выключенных кластеров), добавьте к описанию кластера блок maintenance_window:
```
resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  maintenance_window = {
    day  = "<день_недели>"
    hour = <час_начала>
    type = "ANYTIME"
  }
}
```
  Где type — тип технического обслуживания, который может иметь два значения:
  - ANYTIME — в любое время.
  - WEEKLY— по расписанию. При задании этого значения нужно также указать параметры:
    - day — день недели в формате DDD: MON, TUE, WED, THU, FRI, SAT или SUN.
    - hour — час дня по UTC в формате HH: от 1 до 24.
- Чтобы включить защиту кластера от непреднамеренного удаления пользователем вашего облака, добавьте к описанию кластера поле deletion_protection со значением true:
```
resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  deletion_protection = true
}
```
  Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "configSpec.backupWindowStart,maintenanceWindow,deletionProtection",
              "configSpec": {
                "backupWindowStart": {
                  "hours": "<часы>",
                  "minutes": "<минуты>",
                  "seconds": "<секунды>",
                  "nanos": "<наносекунды>"
                }
              },
              "maintenanceWindow": {
                "weeklyMaintenanceWindow": {
                  "day": "<день_недели>",
                  "hour": "<час>"
                }
              },
              "deletionProtection": <защита_кластера_от_удаления>
            }'
```
Где:
- updateMask — перечень изменяемых параметров в одну строку через запятую.
- configSpec.backupWindowStart — настройки окна резервного копирования.
  
  В параметре укажите время, когда начинать резервное копирование:
  - hours — от 0 до 23 часов;
  - minutes — от 0 до 59 минут;
  - seconds — от 0 до 59 секунд;
  - nanos — от 0 до 999999999 наносекунд.
- maintenanceWindow — настройки времени технического обслуживания (в т. ч. для выключенных кластеров). Передайте один из двух параметров:
  - anytime — техническое обслуживание происходит в любое время.
  - weeklyMaintenanceWindow — техническое обслуживание происходит раз в неделю, в указанное время:
    - day — день недели в формате DDD: MON, TUE, WED, THU, FRI, SAT или SUN.
    - hour — час дня по UTC в формате HH: от 1 до 24.
- deletionProtection — защита кластера от непреднамеренного удаления: true или false.
  
  Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ 
              "config_spec.backup_window_start",
               "maintenance_window",
               "deletion_protection"
            ]
          },
          "config_spec": {
            "backup_window_start": {
              "hours": "<часы>",
              "minutes": "<минуты>",
              "seconds": "<секунды>",
              "nanos": "<наносекунды>"
            }
          },
          "maintenance_window": {
            "weekly_maintenance_window": {
              "day": "<день_недели>",
              "hour": "<час>"
            }
          },
          "deletion_protection": <защита_кластера_от_удаления>
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где:
- update_mask — перечень изменяемых параметров в виде массива строк paths[].
- config_spec.backup_window_start — настройки окна резервного копирования.
  
  В параметре укажите время, когда начинать резервное копирование:
  - hours — от 0 до 23 часов;
  - minutes — от 0 до 59 минут;
  - seconds — от 0 до 59 секунд;
  - nanos — от 0 до 999999999 наносекунд.
- maintenance_window — настройки времени технического обслуживания (в т. ч. для выключенных кластеров). Передайте один из двух параметров:
  - anytime — техническое обслуживание происходит в любое время.
  - weekly_maintenance_window — техническое обслуживание происходит раз в неделю, в указанное время:
    - day — день недели в формате DDD: MON, TUE, WED, THU, FRI, SAT или SUN.
    - hour — час дня по UTC в формате HH: от 1 до 24.
- deletion_protection — защита кластера от непреднамеренного удаления: true или false.
  
  Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Включить шардирование

В нешардированном кластере можно включить шардирование, чтобы кластер стал шардированным.

Важно

Отключить шардирование в кластере, для которого оно включено, невозможно.

Консоль управления

CLI

Terraform

REST API

gRPC API

В консоли управления перейдите в каталог с нужным кластером.
Перейдите в сервис Yandex Managed Service for Valkey™.
Выберите нужный кластер.
В верхней части страницы нажмите кнопку Редактировать.
В блоке Базовые параметры включите опцию Шардирование кластера.
Нажмите кнопку Сохранить изменения.

После включения шардирования все существующие хосты кластера будут добавлены в единственный шард shard1.

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

Чтобы включить шардирование:

Посмотрите описание команды CLI для включения шардирования:
```
yc managed-redis cluster enable-sharding --help
```
Выполните команду:
```
yc managed-redis cluster enable-sharding <идентификатор_кластера>
```
Идентификатор кластера можно получить со списком кластеров в каталоге.

После включения шардирования все существующие хосты кластера будут добавлены в единственный шард shard1.

Чтобы включить шардирование:

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание кластера.
Добавьте к описанию кластера Yandex Managed Service for Valkey™ параметр sharded со значением true:
```
resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  sharded = true
}
```
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

После включения шардирования все существующие хосты кластера будут добавлены в единственный шард shard1.

Также вы можете управлять шардами.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.EnableSharding и выполните запрос, например с помощью cURL:
```
curl \
    --request POST \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>:enable_sharding'
```
Идентификатор кластера можно запросить со списком кластеров в каталоге.

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

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.EnableSharding и выполните запрос, например с помощью gRPCurl:
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>"
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.EnableSharding
```
Идентификатор кластера можно запросить со списком кластеров в каталоге.

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

Переместить кластер

Консоль управления

CLI

Terraform

REST API

gRPC API

Перейдите в сервис Yandex Managed Service for Valkey™.
Нажмите на значок справа в строке кластера, который вы хотите переместить.
Выберите пункт Переместить.
Выберите каталог, в который вы хотите переместить кластер.
Нажмите кнопку Переместить.

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

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

Посмотрите описание команды CLI для перемещения кластера:
```
yc managed-redis cluster move --help
```
Укажите каталог назначения в команде перемещения кластера:
```
yc managed-redis cluster move <идентификатор_кластера> \
   --destination-folder-name=<имя_каталога_назначения>
```
Идентификатор кластера можно получить со списком кластеров в каталоге.

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

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

Измените или добавьте в описании кластера Yandex Managed Service for Valkey™ значение параметра folder_id:

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  folder_id = "<идентификатор_каталога_назначения>"
}

Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Move и выполните запрос, например с помощью cURL:
```
curl \
    --request POST \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>:move' \
    --data '{
              "destinationFolderId": "<идентификатор_каталога>"
            }'
```
Где destinationFolderId — идентификатор каталога, в который нужно переместить кластер.

Идентификатор кластера можно запросить со списком кластеров в каталоге, идентификатор каталога — со списком каталогов в облаке.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Move и выполните запрос, например с помощью gRPCurl:
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "destination_folder_id": "<идентификатор_каталога>"
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Move
```
Где destination_folder_id — идентификатор каталога, в который нужно переместить кластер.

Идентификатор кластера можно запросить со списком кластеров в каталоге, идентификатор каталога — со списком каталогов в облаке.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Изменить группы безопасности

Консоль управления

CLI

Terraform

REST API

gRPC API

В консоли управления перейдите в каталог с нужным кластером.
Перейдите в сервис Yandex Managed Service for Valkey™.
Выберите нужный кластер.
В верхней части страницы нажмите кнопку Редактировать.
В блоке Сетевые настройки выберите группы безопасности для сетевого трафика кластера.

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

Чтобы изменить список групп безопасности для кластера:

Посмотрите описание команды CLI для изменения кластера:
```
yc managed-redis cluster update --help
```

Укажите нужные группы безопасности в команде изменения кластера:

yc managed-redis cluster update <имя_или_идентификатор_кластера> \
  --security-group-ids <список_идентификаторов_групп_безопасности>

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

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

Измените в описании кластера Yandex Managed Service for Valkey™ значение параметра security_group_ids:

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  security_group_ids = [ "<список_идентификаторов_групп_безопасности>" ]
}

Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

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

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

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

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

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

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

resource "yandex_mdb_redis_cluster_v2" "<имя_кластера>" {
  ...
  timeouts = {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Cluster.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/<идентификатор_кластера>' \
    --data '{
              "updateMask": "securityGroupIds",
              "securityGroupIds": [
                "<идентификатор_группы_безопасности_1>",
                "<идентификатор_группы_безопасности_2>",
                ...
                "<идентификатор_группы_безопасности_N>"
              ]
            }'
```
Где:
- updateMask — перечень изменяемых параметров в одну строку через запятую.
  
  В данном случае передается только один параметр.
- securityGroupIds — идентификаторы групп безопасности.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.
Воспользуйтесь вызовом ClusterService.Update и выполните запрос, например с помощью gRPCurl:
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).
Формат перечисления настроек
"update_mask": { "paths": [ "<настройка_1>", "<настройка_2>", ... "<настройка_N>" ] }
```
grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/mdb/redis/v1/cluster_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "update_mask": {
            "paths": [ "security_group_ids" ]
          },
          "security_group_ids": [
            "<идентификатор_группы_безопасности_1>",
            "<идентификатор_группы_безопасности_2>",
            ...
            "<идентификатор_группы_безопасности_N>"
          ] 
        }' \
    mdb.api.cloud.yandex.net:443 \
    yandex.cloud.mdb.redis.v1.ClusterService.Update
```
Где:
- update_mask — перечень изменяемых параметров в виде массива строк paths[].
  
  В данном случае передается только один параметр.
- security_group_ids — идентификаторы групп безопасности.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Важно

Может потребоваться дополнительная настройка групп безопасности для подключения к кластеру.

Изменение настроек кластера Valkey™

Изменить имя и описание кластераИзменить имя и описание кластера

Настроить использование FQDN вместо IP-адресовНастроить использование FQDN вместо IP-адресов

Изменить режим персистентности данныхИзменить режим персистентности данных

Изменить класс хостовИзменить класс хостов

Изменить тип диска и увеличить размер хранилищаИзменить тип диска и увеличить размер хранилища

Настроить автоматическое увеличение размера хранилищаНастроить автоматическое увеличение размера хранилища

Изменить настройки Valkey™Изменить настройки Valkey™

Изменить дополнительные настройки кластераИзменить дополнительные настройки кластера

Включить шардированиеВключить шардирование

Переместить кластерПереместить кластер

Изменить группы безопасностиИзменить группы безопасности

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

Изменить имя и описание кластера

Настроить использование FQDN вместо IP-адресов

Изменить режим персистентности данных

Изменить класс хостов

Изменить тип диска и увеличить размер хранилища

Настроить автоматическое увеличение размера хранилища

Изменить настройки Valkey™

Изменить дополнительные настройки кластера

Включить шардирование

Переместить кластер

Изменить группы безопасности