Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Managed Service for MySQL®
  • Начало работы
    • Все инструкции
      • Информация об имеющихся кластерах
      • Создание кластера
      • Изменение кластера
      • Остановка и запуск кластера
      • Управление хостами кластера
      • Миграция хостов в другую зону доступности
      • Управление резервными копиями
      • Обновление версии MySQL®
      • Удаление кластера
  • Управление доступом
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Обучающие курсы

В этой статье:

  • Получить список резервных копий
  • Получить информацию о резервной копии
  • Создать резервную копию
  • Восстановить кластер из резервной копии
  • Задать время начала резервного копирования
  • Задать срок хранения автоматических резервных копий
  • Задать приоритет использования хостов при создании резервных копий
  1. Пошаговые инструкции
  2. Кластеры
  3. Управление резервными копиями

Управление резервными копиями в Managed Service for MySQL®

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 21 апреля 2025 г.
  • Получить список резервных копий
  • Получить информацию о резервной копии
  • Создать резервную копию
  • Восстановить кластер из резервной копии
  • Задать время начала резервного копирования
  • Задать срок хранения автоматических резервных копий
  • Задать приоритет использования хостов при создании резервных копий

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

Также Managed Service for MySQL® ежедневно создает автоматическую резервную копию. Вы можете задать время начала резервного копирования и срок хранения для нее.

Получить список резервных копийПолучить список резервных копий

Консоль управления
CLI
REST API
gRPC API

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

  1. Перейдите на страницу каталога и выберите сервис Managed Service for MySQL.
  2. Нажмите на имя нужного кластера и выберите вкладку  Резервные копии.

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

  1. Перейдите на страницу каталога и выберите сервис Managed Service for MySQL.
  2. На панели слева выберите  Резервные копии.

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

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

Чтобы получить список резервных копий кластеров MySQL®, доступных в каталоге по умолчанию, выполните команду:

yc managed-mysql backup list

Результат:

+--------------------------+---------------------+----------------------+---------------------+
|            ID            |     CREATED AT      |  SOURCE CLUSTER ID   |     STARTED AT      |
+--------------------------+---------------------+----------------------+---------------------+
| c9qgo11pud7kb3c********  | 2020-08-10 12:00:00 | c9qgo11pud7k******** | 2020-08-10 11:55:17 |
| ...                                                                                         |
+--------------------------+---------------------+----------------------+---------------------+
  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"
    
  2. Чтобы получить список резервных копий кластера:

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

      curl \
          --request GET \
          --header "Authorization: Bearer $IAM_TOKEN" \
          --url 'https://mdb.api.cloud.yandex.net/managed-mysql/v1/clusters/<идентификатор_кластера>/backups'
      

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

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

  3. Чтобы получить список резервных копий всех кластеров в каталоге:

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

      curl \
          --request GET \
          --header "Authorization: Bearer $IAM_TOKEN" \
          --url 'https://mdb.api.cloud.yandex.net/managed-mysql/v1/backups' \
          --url-query folderId=<идентификатор_каталога>
      

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

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

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

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

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

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

  3. Чтобы получить список резервных копий кластера:

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

      grpcurl \
          -format json \
          -import-path ~/cloudapi/ \
          -import-path ~/cloudapi/third_party/googleapis/ \
          -proto ~/cloudapi/yandex/cloud/mdb/mysql/v1/cluster_service.proto \
          -rpc-header "Authorization: Bearer $IAM_TOKEN" \
          -d '{
                "cluster_id": "<идентификатор_кластера>"
              }' \
          mdb.api.cloud.yandex.net:443 \
          yandex.cloud.mdb.mysql.v1.ClusterService.ListBackups
      

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

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

  4. Чтобы получить список резервных копий всех кластеров в каталоге:

    1. Воспользуйтесь вызовом BackupService/List и выполните запрос, например, с помощью gRPCurl:

      grpcurl \
          -format json \
          -import-path ~/cloudapi/ \
          -import-path ~/cloudapi/third_party/googleapis/ \
          -proto ~/cloudapi/yandex/cloud/mdb/mysql/v1/backup_service.proto \
          -rpc-header "Authorization: Bearer $IAM_TOKEN" \
          -d '{
                "folder_id": "<идентификатор_каталога>"
              }' \
          mdb.api.cloud.yandex.net:443 \
          yandex.cloud.mdb.mysql.v1.BackupService.List
      

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

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

Получить информацию о резервной копииПолучить информацию о резервной копии

Консоль управления
CLI
REST API
gRPC API

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

  1. Перейдите на страницу каталога и выберите сервис Managed Service for MySQL.
  2. Нажмите на имя нужного кластера и выберите вкладку  Резервные копии.

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

  1. Перейдите на страницу каталога и выберите сервис Managed Service for MySQL.
  2. На панели слева выберите Резервные копии.

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

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

Чтобы получить данные о резервной копии кластера MySQL®, выполните команду:

yc managed-mysql backup get <идентификатор_резервной_копии>

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

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

    export IAM_TOKEN="<IAM-токен>"
    
  2. Воспользуйтесь методом Backup.get и выполните запрос, например, с помощью cURL:

    curl \
        --request GET \
        --header "Authorization: Bearer $IAM_TOKEN" \
        --url 'https://mdb.api.cloud.yandex.net/managed-mysql/v1/backups/<идентификатор_резервной_копии>'
    

    Идентификатор резервной копии можно запросить со списком резервных копий.

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

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

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

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

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

  3. Воспользуйтесь вызовом BackupService/Get и выполните запрос, например, с помощью gRPCurl:

    grpcurl \
        -format json \
        -import-path ~/cloudapi/ \
        -import-path ~/cloudapi/third_party/googleapis/ \
        -proto ~/cloudapi/yandex/cloud/mdb/mysql/v1/backup_service.proto \
        -rpc-header "Authorization: Bearer $IAM_TOKEN" \
        -d '{
              "backup_id": "<идентификатор_резервной_копии>"
            }' \
        mdb.api.cloud.yandex.net:443 \
        yandex.cloud.mdb.mysql.v1.BackupService.Get
    

    Идентификатор резервной копии можно запросить со списком резервных копий.

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

Создать резервную копиюСоздать резервную копию

Консоль управления
CLI
REST API
gRPC API
  1. Перейдите на страницу каталога и выберите сервис Managed Service for MySQL.
  2. Нажмите на имя нужного кластера и выберите вкладку  Резервные копии.
  3. Нажмите кнопку Создать резервную копию.

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

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

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

Чтобы создать резервную копию кластера:

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

    yc managed-mysql cluster backup --help
    
  2. Запросите создание резервной копии, указав идентификатор или имя кластера:

    yc managed-mysql cluster backup <имя_или_идентификатор_кластера>
    

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

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

    export IAM_TOKEN="<IAM-токен>"
    
  2. Воспользуйтесь методом Cluster.backup и выполните запрос, например, с помощью cURL:

    curl \
        --request POST \
        --header "Authorization: Bearer $IAM_TOKEN" \
        --header "Content-Type: application/json" \
        --url 'https://mdb.api.cloud.yandex.net/managed-mysql/v1/clusters/<идентификатор_кластера>:backup'
    

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

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

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

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

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

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

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

    grpcurl \
        -format json \
        -import-path ~/cloudapi/ \
        -import-path ~/cloudapi/third_party/googleapis/ \
        -proto ~/cloudapi/yandex/cloud/mdb/mysql/v1/cluster_service.proto \
        -rpc-header "Authorization: Bearer $IAM_TOKEN" \
        -d '{
              "cluster_id": "<идентификатор_кластера>"
            }' \
        mdb.api.cloud.yandex.net:443 \
        yandex.cloud.mdb.mysql.v1.ClusterService.Backup
    

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

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

Важно

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

В кластерах из одного хоста резервная копия создается чтением данных с хоста-мастера, а в многохостовых кластерах — с одной из реплик. При этом можно задать приоритет использования хостов при создании резервных копий.

Восстановить кластер из резервной копииВосстановить кластер из резервной копии

Для нового кластера необходимо задать все параметры, обязательные при создании, кроме типа кластера.

Консоль управления
CLI
Terraform
REST API
gRPC API

Чтобы восстановить из резервной копии существующий кластер:

  1. Перейдите на страницу каталога и выберите сервис Managed Service for MySQL.

  2. Нажмите на имя нужного кластера и выберите вкладку  Резервные копии.

  3. Нажмите на значок для нужной резервной копии, затем нажмите Восстановить кластер.

  4. Задайте настройки нового кластера. В списке Каталог можно выбрать каталог для нового кластера.

  5. Чтобы восстановить состояние кластера на требуемый момент времени после создания этой резервной копии (Point-in-Time-Recovery), задайте нужное значение настройки Дата и время восстановления (UTC).

    Если оставить настройку без изменений, кластер будет восстановлен в состояние на момент завершения создания резервной копии.

  6. Нажмите кнопку Восстановить кластер.

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

  1. Перейдите на страницу каталога и выберите сервис Managed Service for MySQL.

  2. На панели слева выберите  Резервные копии.

  3. Найдите нужную резервную копию по времени создания и идентификатору кластера. В колонке Идентификатор содержатся идентификаторы в формате <идентификатор_кластера>:<идентификатор_резервной_копии>.

  4. Нажмите на значок для нужной резервной копии, затем нажмите Восстановить кластер.

  5. Задайте настройки нового кластера. В списке Каталог можно выбрать каталог для нового кластера.

  6. Чтобы восстановить состояние кластера на требуемый момент времени после создания этой резервной копии, задайте нужное значение настройки Дата и время восстановления (UTC). Значение можно ввести вручную или выбрать из выпадающего календаря.

    Если оставить настройку без изменений, кластер будет восстановлен в состояние на момент завершения создания резервной копии.

  7. Нажмите кнопку Восстановить кластер.

Managed Service for MySQL® запустит операцию создания кластера из резервной копии.

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

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

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

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

    yc managed-mysql cluster restore --help
    
  2. Получите список доступных резервных копий кластеров MySQL®:

    yc managed-mysql backup list
    

    Результат:

    +--------------------------+---------------------+----------------------+---------------------+
    |            ID            |     CREATED AT      |  SOURCE CLUSTER ID   |     STARTED AT      |
    +--------------------------+---------------------+----------------------+---------------------+
    | c9qgo11pud7kb3c********  | 2020-08-10 12:00:00 | c9qgo11pud7k******** | 2020-08-10 11:55:17 |
    | ...                                                                                         |
    +--------------------------+---------------------+----------------------+---------------------+
    

    Время завершения создания резервной копии указано в столбце CREATED AT списка доступных резервных копий в формате yyyy-mm-dd hh:mm:ss (2020-08-10 12:00:00 в примере выше). Вы можете восстановить состояние кластера на любой момент времени, начиная от создания резервной копии.

  3. Запросите создание кластера из резервной копии:

    yc managed-mysql cluster restore \
       --backup-id=<идентификатор_резервной_копии> \
       --time=<время> \
       --name=<имя_кластера> \
       --environment=<окружение> \
       --network-name=<имя_сети> \
       --host zone-id=<зона_доступности>,`
             `subnet-name=<имя_подсети>,`
             `assign-public-ip=<публичный_доступ_к_хосту> \
       --resource-preset=<класс_хоста> \
       --disk-size=<размер_хранилища_ГБ> \
       --disk-type=<тип_диска>
    

    Где:

    • --backup-id — идентификатор резервной копии.

    • --time — момент времени, на который нужно восстановить состояние кластера MySQL®, в формате yyyy-mm-ddThh:mm:ssZ.

    • --name — имя кластера.

    • --environment — окружение:

      • PRESTABLE — для тестирования. Prestable-окружение аналогично Production-окружению и на него также распространяется SLA, но при этом на нем раньше появляются новые функциональные возможности, улучшения и исправления ошибок. В Prestable-окружении вы можете протестировать совместимость новых версий с вашим приложением.
      • PRODUCTION — для стабильных версий ваших приложений.
    • --network-name — имя сети.

    • --host — параметры хоста:

      • zone-id — зона доступности.

      • subnet-name — имя подсети. Необходимо указывать, если в выбранной зоне доступности создано две или больше подсетей.

      • assign-public-ip — флаг, который указывается, если для хоста нужен публичный доступ: true или false.

    • --resource-preset — класс хоста.

    • --disk-size — размер хранилища в гигабайтах.

    • --disk-type — тип диска:

      • network-hdd;
      • network-ssd;
      • local-ssd;
      • network-ssd-nonreplicated;
      • network-ssd-io-m3.

Используйте Terraform для восстановления:

  • Существующего кластера из резервной копии.
  • Кластера, созданного и удаленного через Консоль управления, CLI или API.

Для восстановления потребуется ID резервной копии. Получите список доступных резервных копий кластеров MySQL® с помощью CLI:

yc managed-mysql backup list

Результат:

+--------------------------+---------------------+----------------------+---------------------+
|            ID            |     CREATED AT      |  SOURCE CLUSTER ID   |     STARTED AT      |
+--------------------------+---------------------+----------------------+---------------------+
| c9qgo11pud7kb3c********  | 2020-08-10 12:00:00 | c9qgo11pud7k******** | 2020-08-10 11:55:17 |
| ...                                                                                         |
+--------------------------+---------------------+----------------------+---------------------+

Чтобы восстановить из резервной копии существующий кластер:

  1. Создайте конфигурационный файл Terraform для нового кластера.

    При этом не используйте ресурсы баз данных (yandex_mdb_mysql_database) и пользователей (yandex_mdb_mysql_user) — они будут восстановлены из резервной копии.

  2. Добавьте в этот конфигурационный файл блок restore:

    resource "yandex_mdb_mysql_cluster" "<имя_кластера>" {
      ...
      restore {
        backup_id = "<идентификатор_резервной_копии>"
        time      = "<время>"
      }
    }
    

    В параметре time укажите момент времени в формате yyyy-mm-ddThh:mm:ss, на который нужно восстановить состояние кластера MySQL®, начиная со времени создания выбранной резервной копии.

    Примечание

    Параметр time не является обязательным. Если его не указывать, кластер будет восстановлен на момент запуска процесса восстановления.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

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

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

Terraform создаст копию существующего кластера. Базы данных и пользователи будут развернуты из выбранной резервной копии.

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

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

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

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

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

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

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

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

  1. Создайте конфигурационный файл Terraform для нового кластера.

    При этом не используйте ресурсы баз данных (yandex_mdb_mysql_database) и пользователей (yandex_mdb_mysql_user) — они будут восстановлены из резервной копии.

  2. Добавьте в этот конфигурационный файл блок restore с именем резервной копии, из которой нужно восстановиться:

    resource "yandex_mdb_mysql_cluster" "<имя_кластера>" {
      ...
      restore {
          backup_id = "<идентификатор_резервной_копии>"
      }
    }
    
  3. Проверьте корректность настроек.

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    {
        "backupId": "<идентификатор_резервной_копии>",
        "time": "<время>",
        "folderId": "<идентификатор_каталога>",
        "name": "<имя_кластера>",
        "environment": "<окружение>",
        "networkId": "<идентификатор_сети>",
        "configSpec": {
            "version": "<версия_MySQL®>",
            "resources": {
                "resourcePresetId": "<класс_хостов>",
                "diskSize": "<размер_хранилища_в_байтах>",
                "diskTypeId": "<тип_диска>"
            }
        },
        "hostSpecs": [
            {
                "zoneId": "<зона_доступности>",
                "subnetId": "<идентификатор_подсети>",
                "assignPublicIp": <публичный_адрес_хоста:_true_или_false>
            }
        ]
    }
    

    Где:

    • backupId — идентификатор резервной копии. Его можно запросить со списком резервных копий.

    • time — момент времени, на который нужно восстановить состояние кластера MySQL®, в формате yyyy-mm-ddThh:mm:ssZ.

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

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

    • environment — окружение:

      • PRESTABLE — для тестирования. Prestable-окружение аналогично Production-окружению и на него также распространяется SLA, но при этом на нем раньше появляются новые функциональные возможности, улучшения и исправления ошибок. В Prestable-окружении вы можете протестировать совместимость новых версий с вашим приложением.
      • PRODUCTION — для стабильных версий ваших приложений.
    • networkId — идентификатор сети.

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

      • version — версия MySQL®.

      • resources — ресурсы кластера:

        • resourcePresetId — класс хостов;
        • diskSize — размер диска в байтах;
        • diskTypeId — тип диска.
    • hostSpecs — настройки хостов кластера в виде массива элементов. Каждый элемент соответствует отдельному хосту и имеет следующую структуру:

      • zoneId — зона доступности;
      • subnetId — идентификатор подсети;
      • assignPublicIp — разрешение на подключение к хосту из интернета.
  3. Воспользуйтесь методом Cluster.restore и выполните запрос, например, с помощью cURL:

    curl \
        --request POST \
        --header "Authorization: Bearer $IAM_TOKEN" \
        --header "Content-Type: application/json" \
        --url 'https://mdb.api.cloud.yandex.net/managed-mysql/v1/clusters:restore' \
        --data "@body.json"
    
  4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

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

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

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

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

  3. Создайте файл body.json и добавьте в него следующее содержимое:

    {
        "backup_id": "<идентификатор_резервной_копии>",
        "time": "<время>",
        "folder_id": "<идентификатор_каталога>",
        "name": "<имя_кластера>",
        "environment": "<окружение>",
        "network_id": "<идентификатор_сети>",
        "config_spec": {
            "version": "<версия_MySQL®>",
            "resources": {
                "resource_preset_id": "<класс_хостов>",
                "disk_size": "<размер_хранилища_в_байтах>",
                "disk_type_id": "<тип_диска>"
            }
        },
        "host_specs": [
            {
                "zone_id": "<зона_доступности>",
                "subnet_id": "<идентификатор_подсети>",
                "assign_public_ip": <публичный_адрес_хоста:_true_или_false>
            }
        ]
    }
    

    Где:

    • backup_id — идентификатор резервной копии. Его можно запросить со списком резервных копий.

    • time — момент времени, на который нужно восстановить состояние кластера MySQL®, в формате yyyy-mm-ddThh:mm:ssZ.

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

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

    • environment — окружение:

      • PRESTABLE — для тестирования. Prestable-окружение аналогично Production-окружению и на него также распространяется SLA, но при этом на нем раньше появляются новые функциональные возможности, улучшения и исправления ошибок. В Prestable-окружении вы можете протестировать совместимость новых версий с вашим приложением.
      • PRODUCTION — для стабильных версий ваших приложений.
    • network_id — идентификатор сети.

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

      • version — версия MySQL®.

      • resources — ресурсы кластера:

        • resource_preset_id — класс хостов;
        • disk_size — размер диска в байтах;
        • disk_type_id — тип диска.
    • host_specs — настройки хостов кластера в виде массива элементов. Каждый элемент соответствует отдельному хосту и имеет следующую структуру:

      • zone_id — зона доступности;
      • subnet_id — идентификатор подсети;
      • assign_public_ip — разрешение на подключение к хосту из интернета.
  4. Воспользуйтесь вызовом ClusterService/Restore и выполните запрос, например, с помощью gRPCurl:

    grpcurl \
        -format json \
        -import-path ~/cloudapi/ \
        -import-path ~/cloudapi/third_party/googleapis/ \
        -proto ~/cloudapi/yandex/cloud/mdb/mysql/v1/cluster_service.proto \
        -rpc-header "Authorization: Bearer $IAM_TOKEN" \
        -d @ \
        mdb.api.cloud.yandex.net:443 \
        yandex.cloud.mdb.mysql.v1.ClusterService.Restore \
        < body.json
    
  5. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Задать время начала резервного копированияЗадать время начала резервного копирования

Консоль управления
CLI
Terraform
REST API
gRPC API

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

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

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

Задать время начала резервного копирования в существующем кластере можно с помощью команды update:

yc managed-mysql cluster update <имя_или_идентификатор_кластера> \
   --backup-window-start=<время>

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

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

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

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

  2. Добавьте к описанию кластера Managed Service for MySQL® блок backup_window_start:

    resource "yandex_mdb_mysql_cluster" "<имя_кластера>" {
      ...
      backup_window_start {
        hours   = <час>
        minutes = <минута>
      }
    }
    

    Где:

    • hours — час начала резервного копирования (UTC).
    • minutes — минута начала резервного копирования (UTC).
  3. Проверьте корректность настроек.

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

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

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

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

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

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

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

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

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

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

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

    export IAM_TOKEN="<IAM-токен>"
    
  2. Воспользуйтесь методом 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-mysql/v1/clusters/<идентификатор_кластера>' \
        --data '{
                  "updateMask": "configSpec.backupWindowStart",
                  "configSpec": {
                    "backupWindowStart": {
                      "hours": "<часы>",
                      "minutes": "<минуты>",
                      "seconds": "<секунды>",
                      "nanos": "<наносекунды>"
                    }
                  }
                }'
    

    Где:

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

      В данном случае передается только один параметр.

    • configSpec.backupWindowStart — настройки окна резервного копирования.

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

      • hours — от 0 до 23 часов;
      • minutes — от 0 до 59 минут;
      • seconds — от 0 до 59 секунд;
      • nanos — от 0 до 999999999 наносекунд.

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

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

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

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

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

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

  3. Воспользуйтесь вызовом 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/mysql/v1/cluster_service.proto \
        -rpc-header "Authorization: Bearer $IAM_TOKEN" \
        -d '{
              "cluster_id": "<идентификатор_кластера>",
              "update_mask": {
                "paths": [
                  "config_spec.backup_window_start"
                ]
              },
              "config_spec": {
                "backup_window_start": {
                  "hours": "<часы>",
                  "minutes": "<минуты>",
                  "seconds": "<секунды>",
                  "nanos": "<наносекунды>"
                }
              }
            }' \
        mdb.api.cloud.yandex.net:443 \
        yandex.cloud.mdb.mysql.v1.ClusterService.Update
    

    Где:

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

      В данном случае передается только один параметр.

    • config_spec.backup_window_start — настройки окна резервного копирования.

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

      • hours — от 0 до 23 часов;
      • minutes — от 0 до 59 минут;
      • seconds — от 0 до 59 секунд;
      • nanos — от 0 до 999999999 наносекунд.

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

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

Задать срок хранения автоматических резервных копийЗадать срок хранения автоматических резервных копий

Консоль управления
CLI
Terraform
REST API
gRPC API

В консоли управления задать срок хранения автоматических резервных копий можно при создании или изменении кластера.

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

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

Чтобы задать срок хранения автоматических резервных копий, передайте нужное значение в аргументе --backup-retain-period-days команды изменения кластера:

yc managed-mysql cluster update <имя_или_идентификатор_кластера> \
   --backup-retain-period-days=<срок_хранения_в_днях>

Допустимые значения: от 7 до 60. Значение по умолчанию — 7.

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

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

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

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

  2. Чтобы задать срок хранения автоматических резервных копий, добавьте к описанию кластера Managed Service for MySQL® блок backup_retain_period_days:

    resource "yandex_mdb_mysql_cluster" "<имя_кластера>" {
      ...
      backup_window_start: <срок_хранения_в_днях>
    }
    
  3. Проверьте корректность настроек.

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

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

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

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

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

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

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

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

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

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

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

    export IAM_TOKEN="<IAM-токен>"
    
  2. Воспользуйтесь методом 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-mysql/v1/clusters/<идентификатор_кластера>' \
        --data '{
                  "updateMask": "configSpec.backupRetainPeriodDays",
                  "configSpec": {
                    "backupRetainPeriodDays": <срок_хранения_в_днях>
                  }
                }'
    

    Где:

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

      В данном случае передается только один параметр.

    • configSpec.backupRetainPeriodDays — срок хранения автоматических резервных копий.

      Допустимые значения — от 7 до 60. Значение по умолчанию — 7.

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

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

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

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

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

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

  3. Воспользуйтесь вызовом 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/mysql/v1/cluster_service.proto \
        -rpc-header "Authorization: Bearer $IAM_TOKEN" \
        -d '{
              "cluster_id": "<идентификатор_кластера>",
              "update_mask": {
                "paths": [
                  "config_spec.backup_retain_period_days"
                ]
              },
              "config_spec": {
                "backup_retain_period_days": <число_дней>
              }
            }' \
        mdb.api.cloud.yandex.net:443 \
        yandex.cloud.mdb.mysql.v1.ClusterService.Update
    

    Где:

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

      В данном случае передается только один параметр.

    • config_spec.backup_retain_period_days — срок хранения автоматических резервных копий.

      Допустимые значения — от 7 до 60. Значение по умолчанию — 7.

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

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

Задать приоритет использования хостов при создании резервных копийЗадать приоритет использования хостов при создании резервных копий

Минимальное значение приоритета использования хоста при создании резервных копий — 0, максимальное — 100, по умолчанию — 0. Источником резервного копирования выбирается хост-реплика с наибольшим приоритетом. Подробнее см. раздел Создание резервной копии.

Консоль управления
CLI
REST API
gRPC API

В консоли управления приоритет хоста задается при создании кластера, добавлении в него новых хостов или изменении настроек существующих.

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

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

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

yc managed-mysql host update <имя_хоста> \
   --cluster-name=<имя_кластера> \
   --backup-priority=<приоритет_хоста_при_резервном_копировании>

Где backup-priority — приоритет хоста при резервном копировании: от 0 до 100.

Имя хоста можно запросить со списком хостов в кластере, имя кластера — со списком кластеров в каталоге.

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

    export IAM_TOKEN="<IAM-токен>"
    
  2. Воспользуйтесь методом Cluster.updateHosts и выполните запрос, например, с помощью cURL:

    curl \
        --request POST \
        --header "Authorization: Bearer $IAM_TOKEN" \
        --header "Content-Type: application/json" \
        --url 'https://mdb.api.cloud.yandex.net/managed-mysql/v1/clusters/<идентификатор_кластера>/hosts:batchUpdate' \
        --data '{
                  "updateHostSpecs": [
                    {
                      "updateMask": "backupPriority",
                      "hostName": "<FQDN_хоста>",
                      "backupPriority": "<приоритет_хоста_при_резервном_копировании>"
                    }
                  ]
                }'
    

    Где updateHostSpecs — массив хостов, которым вы задаете приоритет. Один элемент массива содержит настройки для одного хоста и имеет следующую структуру:

    • updateMask — перечень изменяемых параметров в одну строку через запятую;
    • hostName — FQDN изменяемого хоста;
    • backupPriority — приоритет хоста при резервном копировании: от 0 до 100.

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

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

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

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

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

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

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

    grpcurl \
        -format json \
        -import-path ~/cloudapi/ \
        -import-path ~/cloudapi/third_party/googleapis/ \
        -proto ~/cloudapi/yandex/cloud/mdb/mysql/v1/cluster_service.proto \
        -rpc-header "Authorization: Bearer $IAM_TOKEN" \
        -d '{
              "cluster_id": "<идентификатор_кластера>",
              "update_host_specs": [
                {
                  "update_mask": {
                    "paths": [
                      "backup_priority"
                    ]
                  },
                  "host_name": "<FQDN_хоста>",
                  "backup_priority": "<приоритет_хоста_при_резервном_копировании>"
                }
              ]
            }' \
        mdb.api.cloud.yandex.net:443 \
        yandex.cloud.mdb.mysql.v1.ClusterService.UpdateHosts
    

    Где update_host_specs — массив хостов, которым вы задаете приоритет. Один элемент массива содержит настройки для одного хоста и имеет следующую структуру:

    • update_mask — перечень изменяемых параметров в виде массива строк paths[];
    • host_name — FQDN изменяемого хоста;
    • backup_priority — приоритет хоста при резервном копировании: от 0 до 100.

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

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

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

Предыдущая
Миграция хостов в другую зону доступности
Следующая
Обновление версии MySQL®
Проект Яндекса
© 2025 ООО «Яндекс.Облако»