Управление резервными копиями в Yandex Managed Service for Sharded PostgreSQL

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

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

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

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

   yc managed-sharded-postgresql cluster restore --help
   

2. Создайте кластер из резервной копии (в примере приведены не все доступные флаги):

   yc managed-sharded-postgresql cluster restore \
     --backup-id <идентификатор_резервной_копии> \
     --time <момент_времени_для_восстановления> \
     --name <имя_кластера> \
     --description <описание_кластера> \
     --environment <окружение> \
     --network-id <идентификатор_сети> \
     --host zone-id=<зона_доступности>,`
           `subnet-id=<идентификатор_подсети>,`
           `assign-public-ip=<публичный_доступ_к_хосту>,`
           `type=<тип_хоста> \
     --router-resource-preset <класс_хостов_роутера> \
     --router-disk-size <размер_хранилища_ГБ> \
     --router-disk-type <тип_диска> \
     --coordinator-resource-preset <класс_хостов_координатора> \
     --coordinator-disk-size <размер_хранилища_ГБ> \
     --coordinator-disk-type <тип_диска> \
     --infra-resource-preset <класс_хостов_INFRA> \
     --infra-disk-size <размер_хранилища_ГБ> \
     --infra-disk-type <тип_диска> \
     --backup-window-start <время_начала_резервного_копирования> \
     --backup-retain-period-days <срок_хранения_резервных_копий> \
     --security-group-ids <идентификаторы_групп_безопасности> \
     --deletion-protection
   

   Где:

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

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

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

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

   • --description — описание кластера.

   • --environment — окружение кластера: PRODUCTION или PRESTABLE.

   • --network-id — идентификатор сети, в которой будет размещен кластер.

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

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

     • subnet-id — идентификатор подсети.

     • assign-public-ip — разрешить подключение к хосту из интернета: true или false.

     • type — тип хоста. Возможные значения:

       • ROUTER — роутер в кластере с расширенным шардированием;
       • COORDINATOR — координатор в кластере с расширенным шардированием;
       • INFRA — хост INFRA в кластере со стандартным шардированием.

   • --router-resource-preset — класс хостов роутера.

   • --router-disk-size — размер хранилища для хостов роутера в гигабайтах.

   • --router-disk-type — тип диска для хостов роутера.

   • --coordinator-resource-preset — класс хостов координатора.

   • --coordinator-disk-size — размер хранилища для хостов координатора в гигабайтах.

   • --coordinator-disk-type — тип диска для хостов координатора.

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

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

   • --infra-disk-type — тип диска для хостов INFRA.

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

   • --backup-retain-period-days — срок хранения автоматических резервных копий кластера. Возможные значения: от 7 до 60 дней. По умолчанию — 7.

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

     Важно

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

   • --deletion-protection — включает защиту кластера от удаления.

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

   export IAM_TOKEN="<IAM-токен>"
   

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

   {
     "backupId": "<идентификатор_резервной_копии>",
     "name": "<имя_кластера>",
     "description": "<описание_кластера>",
     "environment": "<окружение>",
     "configSpec": {
       "spqrSpec": {
         "router": {
           "resources": {
             "resourcePresetId": "<класс_хостов_роутера>",
             "diskSize": "<размер_хранилища_в_байтах>",
             "diskTypeId": "<тип_диска>"
           }
         },
         "coordinator": {
           "resources": {
             "resourcePresetId": "<класс_хостов_координатора>",
             "diskSize": "<размер_хранилища_в_байтах>",
             "diskTypeId": "<тип_диска>"
           }
         },
         "infra": {
           "resources": {
             "resourcePresetId": "<класс_хостов_INFRA>",
             "diskSize": "<размер_хранилища_в_байтах>",
             "diskTypeId": "<тип_диска>"
           }
         },
         "consolePassword": "<пароль_консоли_Sharded_PostgreSQL>",
         "logLevel": "<уровень_логирования>"
       },
       "backupWindowStart": {
         "hours": <часы>,
         "minutes": <минуты>,
         "seconds": <секунды>,
         "nanos": <наносекунды>
       },
       "backupRetainPeriodDays": "<количество_дней>"
     },
     "hostSpecs": [
       {
         "zoneId": "<зона_доступности>",
         "subnetId": "<идентификатор_подсети>",
         "assignPublicIp": <разрешить_публичный_доступ_к_хосту>,
         "type": "<тип_хоста>",
         "shardName": "<имя_шарда>",
         "mdbPostgresql": {
           "clusterId": "<идентификатор_кластера_PostgreSQL>"
         }
       },
       { <аналогичный_набор_настроек_для_хоста_2> },
       { ... },
       { <аналогичный_набор_настроек_для_хоста_N> }
     ],
     "networkId": "<идентификатор_сети>",
     "folderId": "<идентификатор_каталога>",
     "securityGroupIds": [
       "<идентификатор_группы_безопасности_1>",
       "<идентификатор_группы_безопасности_2>",
       ...
       "<идентификатор_группы_безопасности_N>"
     ],
     "deletionProtection": <защитить_кластер_от_удаления>,
     "time": "<момент_времени_для_восстановления>",
     "timeInclusive": <восстановить_после_указанного_времени>
   }
   

   Где:

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

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

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

   • description — описание кластера.

   • environment — окружение кластера: PRODUCTION или PRESTABLE.

   • configSpec.spqrSpec.router.resources — параметры ресурсов хостов роутера:

     • resourcePresetId — класс хостов;
     • diskSize — размер диска в байтах;
     • diskTypeId — тип диска.

   • configSpec.spqrSpec.coordinator.resources — параметры ресурсов хостов координатора:

     • resourcePresetId — класс хостов;
     • diskSize — размер диска в байтах;
     • diskTypeId — тип диска.

   • configSpec.spqrSpec.infra.resources — параметры ресурсов хостов INFRA:

     • resourcePresetId — класс хостов;
     • diskSize — размер диска в байтах;
     • diskTypeId — тип диска.

   • configSpec.spqrSpec.consolePassword — пароль консоли Sharded PostgreSQL.

   • configSpec.spqrSpec.logLevel — уровень логирования запросов: DEBUG, INFO, WARNING, ERROR, FATAL.

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

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

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

   • configSpec.backupRetainPeriodDays — срок хранения автоматических резервных копий кластера. Возможные значения: от 7 до 60 дней. По умолчанию — 7.

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

     • zoneId — зона доступности;

     • subnetId — идентификатор подсети;

     • assignPublicIp — разрешить подключение к хосту из интернета: true или false;

     • type — тип хоста. Возможные значения:

       • ROUTER — роутер в кластере с расширенным шардированием;
       • COORDINATOR — координатор в кластере с расширенным шардированием;
       • INFRA — хост INFRA в кластере со стандартным шардированием.

     • shardName — имя шарда.

     • mdbPostgresql.clusterId — идентификатор кластера Managed Service for PostgreSQL.

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

   • networkId — идентификатор сети, в которой будет размещен кластер.

   • folderId — идентификатор каталога.

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

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

     Важно

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

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

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

   • timeInclusive — восстановить кластер после указанного времени: true или false.

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

   curl \
     --request POST \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-spqr/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": "<идентификатор_резервной_копии>",
     "name": "<имя_кластера>",
     "description": "<описание_кластера>",
     "environment": "<окружение>",
     "config_spec": {
       "spqr_spec": {
         "router": {
           "resources": {
             "resource_preset_id": "<класс_хостов_роутера>",
             "disk_size": <размер_хранилища_в_байтах>,
             "disk_type_id": "<тип_диска>"
           }
         },
         "coordinator": {
           "resources": {
             "resource_preset_id": "<класс_хостов_координатора>",
             "disk_size": <размер_хранилища_в_байтах>,
             "disk_type_id": "<тип_диска>"
           }
         },
         "infra": {
           "resources": {
             "resource_preset_id": "<класс_хостов_INFRA>",
             "disk_size": <размер_хранилища_в_байтах>,
             "disk_type_id": "<тип_диска>"
           }
         },
         "console_password": "<пароль_консоли_Sharded_PostgreSQL>",
         "log_level": "<уровень_логирования>"
       },
       "backup_window_start": {
         "hours": <часы>,
         "minutes": <минуты>,
         "seconds": <секунды>,
         "nanos": <наносекунды>
       },
       "backup_retain_period_days": <количество_дней>
     },
     "host_specs": [
       {
         "zone_id": "<зона_доступности>",
         "subnet_id": "<идентификатор_подсети>",
         "assign_public_ip": <разрешить_публичный_доступ_к_хосту>,
         "type": "<тип_хоста>",
         "shard_name": "<имя_шарда>",
         "mdb_postgresql": {
           "cluster_id": "<идентификатор_кластера_PostgreSQL>"
         }
       },
       { <аналогичный_набор_настроек_для_хоста_2> },
       { ... },
       { <аналогичный_набор_настроек_для_хоста_N> }
     ],
     "network_id": "<идентификатор_сети>",
     "folder_id": "<идентификатор_каталога>",
     "security_group_ids": [
       "<идентификатор_группы_безопасности_1>",
       "<идентификатор_группы_безопасности_2>",
       ...
       "<идентификатор_группы_безопасности_N>"
     ],
     "deletion_protection": <защитить_кластер_от_удаления>,
     "time": "<момент_времени_для_восстановления>",
     "time_inclusive": <восстановить_после_указанного_времени>
   }
   

   Где:

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

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

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

   • description — описание кластера.

   • environment — окружение кластера: PRODUCTION или PRESTABLE.

   • config_spec.spqr_spec.router.resources — параметры ресурсов хостов роутера:

     • resource_preset_id — класс хостов;
     • disk_size — размер диска в байтах;
     • disk_type_id — тип диска.

   • config_spec.spqr_spec.coordinator.resources — параметры ресурсов хостов координатора:

     • resource_preset_id — класс хостов;
     • disk_size — размер диска в байтах;
     • disk_type_id — тип диска.

   • config_spec.spqr_spec.infra.resources — параметры ресурсов хостов INFRA:

     • resource_preset_id — класс хостов;
     • disk_size — размер диска в байтах;
     • disk_type_id — тип диска.

   • config_spec.spqr_spec.console_password — пароль консоли Sharded PostgreSQL.

   • config_spec.spqr_spec.log_level — уровень логирования запросов: DEBUG, INFO, WARNING, ERROR, FATAL.

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

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

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

   • config_spec.backup_retain_period_days — срок хранения автоматических резервных копий кластера. Возможные значения: от 7 до 60 дней.

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

     • zone_id — зона доступности;

     • subnet_id — идентификатор подсети;

     • assign_public_ip — разрешить подключение к хосту из интернета: true или false;

     • type — тип хоста. Возможные значения:

       • ROUTER — роутер в кластере с расширенным шардированием;
       • COORDINATOR — координатор в кластере с расширенным шардированием;
       • INFRA — хост INFRA в кластере со стандартным шардированием.

     • shard_name — имя шарда.

     • mdb_postgresql.cluster_id — идентификатор кластера Managed Service for PostgreSQL.

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

   • network_id — идентификатор сети, в которой будет размещен кластер.

   • folder_id — идентификатор каталога.

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

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

     Важно

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

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

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

   • time_inclusive — восстановить кластер после указанного времени: true или false.

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

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d @ \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.spqr.v1.ClusterService.Restore \
     < body.json
   

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

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

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

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

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

   yc managed-sharded-postgresql cluster backup --help
   

2. Создайте резервную копию кластера:

   yc managed-sharded-postgresql 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.yandexcloud.kz/managed-spqr/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/spqr/v1/cluster_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>"
         }' \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.spqr.v1.ClusterService.Backup
   

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

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

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

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

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

   yc managed-sharded-postgresql cluster list-backups --help
   

2. Получите список резервных копий кластера:

   yc managed-sharded-postgresql cluster list-backups <имя_или_идентификатор_кластера>
   

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

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

   yc managed-sharded-postgresql backup list --help
   

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

   yc managed-sharded-postgresql backup list
   

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

   export IAM_TOKEN="<IAM-токен>"
   

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

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

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

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

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

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

      curl \
        --request GET \
        --header "Authorization: Bearer $IAM_TOKEN" \
        --url 'https://mdb.api.yandexcloud.kz/managed-spqr/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/spqr/v1/cluster_service.proto \
        -rpc-header "Authorization: Bearer $IAM_TOKEN" \
        -d '{
              "cluster_id": "<идентификатор_кластера>"
            }' \
        mdb.api.yandexcloud.kz:443 \
        yandex.cloud.mdb.spqr.v1.ClusterService.ListBackups
      

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

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

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

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

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

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

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

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

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

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

   yc managed-sharded-postgresql backup get --help
   

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

   yc managed-sharded-postgresql 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.yandexcloud.kz/managed-spqr/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/spqr/v1/backup_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "backup_id": "<идентификатор_резервной_копии>"
         }' \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.spqr.v1.BackupService.Get
   

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

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

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

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

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

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

   yc managed-sharded-postgresql cluster update --help
   

2. Задайте время начала резервного копирования:

   yc managed-sharded-postgresql cluster update <имя_или_идентификатор_кластера> \
     --backup-window-start <время_начала_резервного_копирования>
   

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

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

   export IAM_TOKEN="<IAM-токен>"
   

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

   {
     "updateMask": "configSpec.backupWindowStart",
     "configSpec": {
       "backupWindowStart": {
         "hours": <часы>,
         "minutes": <минуты>,
         "seconds": <секунды>,
         "nanos": <наносекунды>
       }
     }
   }
   

   Где:

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

     В этом примере передается только один параметр configSpec.backupWindowStart.

     Важно

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

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

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

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

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

   curl \
     --request PATCH \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-spqr/v1/clusters/<идентификатор_кластера>' \
     --data "@body.json"
   

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

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

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

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

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

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

   {
     "update_mask": {
       "paths": [
         "config_spec.backup_window_start"
       ]
     },
     "config_spec": {
       "backup_window_start": {
         "hours": <часы>,
         "minutes": <минуты>,
         "seconds": <секунды>,
         "nanos": <наносекунды>
       }
     }
   }
   

   Где:

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

     Формат перечисления настроек

     "update_mask": {
       "paths": [
         "<настройка_1>",
         "<настройка_2>",
         ...
         "<настройка_N>"
       ]
     }
     

     В этом примере передается только один параметр config_spec.backup_window_start.

     Важно

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

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

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

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

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

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d @ \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.spqr.v1.ClusterService.Update \
     < body.json
   

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

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

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

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

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

   yc managed-sharded-postgresql cluster update --help
   

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

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

   Где --backup-retain-period-days — срок хранения автоматических резервных копий кластера. Возможные значения: от 7 до 60 дней. По умолчанию — 7.

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

   export IAM_TOKEN="<IAM-токен>"
   

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

   {
     "updateMask": "configSpec.backupRetainPeriodDays",
     "configSpec": {
       "backupRetainPeriodDays": "<количество_дней>"
     }
   }
   

   Где:

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

     В этом примере передается только один параметр configSpec.backupRetainPeriodDays.

     Важно

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

   • backupRetainPeriodDays — срок хранения автоматических резервных копий кластера. Возможные значения: от 7 до 60 дней. По умолчанию — 7.

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

   curl \
     --request PATCH \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-spqr/v1/clusters/<идентификатор_кластера>' \
     --data "@body.json"
   

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

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

   export IAM_TOKEN="<IAM-токен>"
   

2. Клонируйте репозиторий cloudapi:

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

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

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

   {
     "update_mask": {
       "paths": [
         "config_spec.backup_retain_period_days"
       ]
     },
     "config_spec": {
       "backup_retain_period_days": <количество_дней>
     }
   }
   

   Где:

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

     Формат перечисления настроек

     "update_mask": {
       "paths": [
         "<настройка_1>",
         "<настройка_2>",
         ...
         "<настройка_N>"
       ]
     }
     

     В этом примере передается только один параметр config_spec.backup_retain_period_days.

     Важно

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

   • config_spec.backup_retain_period_days — срок хранения автоматических резервных копий кластера. Возможные значения: от 7 до 60 дней. По умолчанию — 7.

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

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d @ \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.spqr.v1.ClusterService.Update \
     < body.json
   

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

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

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

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

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

   yc managed-sharded-postgresql backup delete --help
   

2. Удалите резервную копию:

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

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

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

   export IAM_TOKEN="<IAM-токен>"
   

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

   curl \
     --request DELETE \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-spqr/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.Delete и выполните запрос, например с помощью gRPCurl:

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

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

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