По умолчанию используется каталог, указанный при создании профиля 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. Это приведет к удалению существующего кластера и созданию нового.

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

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

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

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

resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
  name        = "<имя_кластера>"
  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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
  name        = "<имя_кластера>"
  ...
  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" "<имя_кластера>" {
  ...
  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.
  
  Примечание
  
  Некоторые клиенты несовместимы с этой настройкой и не смогут подключиться к хостам кластера. Такие клиенты ожидают именно IP-адрес и некорректно обрабатывают ситуацию, когда IP-адрес подменяется на FQDN.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите 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.
  
  {% include fqdn-option-compatibility-note %}.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

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

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

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

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

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

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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
  ...
  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.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Кластер Yandex Managed Service for Valkey™ недоступен около пяти — семи минут после изменения класса хостов.

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

Проверьте, что в облаке достаточно квот для увеличения хранилища. Откройте страницу Квоты для облака и убедитесь, что в секции 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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
  ...
  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 — новый размер хранилища в байтах.
Идентификатор кластера можно запросить со списком кластеров в каталоге.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Изменить настройки 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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
  ...
  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. Например, можно выбрать время, когда кластер наименее загружен.
  Операции по техническому обслуживанию проводятся для включенных и выключенных кластеров. Они могут включать в себя: обновление СУБД, применение патчей и так далее.
- Защита от удаления — управляет защитой кластера от непреднамеренного удаления.
  
  Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.
Нажмите кнопку Сохранить изменения.

Если у вас еще нет интерфейса командной строки 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 — день недели в формате DDD: MON, TUE, WED, THU, FRI, SAT или SUN.
  - hour — час дня по UTC в формате HH: от 1 до 24.
--websql-access — разрешает выполнять SQL-запросы к базам данных кластера из консоли управления Yandex Cloud с помощью сервиса Yandex WebSQL. Значение по умолчанию — false.
--deletion-protection — защита кластера от непреднамеренного удаления: true или false.

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

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

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

О том, как создать такой файл, см. в разделе Создание кластера.
Измените в описании кластера Yandex Managed Service for Valkey™ значения нужных вам параметров:
- Для настройки времени начала резервного копирования добавьте блок backup_window_start:
```
resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
    ...
    backup_window_start {
        hours   = <часы>
        minutes = <минуты>
    }
}
```
  Где:
  - hours — час начала резервного копирования по UTC в формате HH: от 0 до 23 часов.
  - minutes — минута начала резервного копирования по UTC в формате mm: от 0 до 59 минут.
- Чтобы настроить время технического обслуживания (в т. ч. для выключенных кластеров), добавьте к описанию кластера блок maintenance_window:
```
resource "yandex_mdb_redis_cluster" "<имя_кластера>" {
...
    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" "<имя_кластера>" {
...
        deletion_protection = 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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
    ...
    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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
  ...
  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" "<имя_кластера>" {
  ...
  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™

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

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

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

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