Управление политиками резервного копирования в Managed Service for PostgreSQL

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

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

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

curl \
  --request POST \
  --header "Authorization: Bearer $IAM_TOKEN" \
  --header "Content-Type: application/json" \
  --url 'https://mdb.api.yandexcloud.kz/managed-postgresql/v1/clusters/<идентификатор_кластера>/retention_policies' \
  --data '{
             "cron": {
               "dayOfMonth": "<день_месяца>",
               "month": "<месяц>",
               "dayOfWeek": "<день_недели>"
             },
             "retainForDays": "<срок_хранения_в_днях>",
             "description": "<описание_политики>",
             "policyName": "<название_политики>"
         }'

Где:

• dayOfMonth — день месяца. Возможные значения: 1-31.

• month — месяц. Возможные значения: 1-12 или JAN-DEC.

• dayOfWeek — день недели. Возможные значения: 0-6 или SUN-SAT.

• retainForDays — срок хранения копии в днях. Минимальное значение — 7.

  Параметры dayOfMonth, month и dayOfWeek составляют расписание, по которому создаются резервные копии. Расписание задается в виде cron-выражения, но часы и минуты не указываются.

  Сron-выражение также поддерживает специальные символы:

  • * — выбор всех возможных значений. Копия будет создаваться каждый раз (день или месяц), когда это возможно и не противоречит остальным параметрам. Используется по умолчанию, если значение параметра не указано.
  • , — перечисление нескольких значений.
  • – — указание диапазона значений.
  • / — указание шага диапазона. Например, */3 для параметра dayOfMonth означает, что копия будет создаваться раз в три дня.

  Если ни один параметр расписания не задан, резервные копии создаются по cron-выражению * * *, то есть каждый день.

  Примеры cron-выражений:

  • 1 */6 * — копия создается в первый день месяца раз в полгода.
  • 31 jan SUN — копия создается в январе по воскресеньям и тридцать первого января.
  • * * WED — копия создается каждую среду.

  Вы можете протестировать cron-выражение в редакторе.

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

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

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

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

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

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

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

Чтобы создать политику:

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

   grpcurl \
       -format json \
       -import-path ~/cloudapi/ \
       -import-path ~/cloudapi/third_party/googleapis/ \
       -proto ~/cloudapi/yandex/cloud/mdb/postgresql/v1/backup_retention_policy_service.proto \
       -rpc-header "Authorization: Bearer $IAM_TOKEN" \
       -d '{
             "cluster_id": "<идентификатор_кластера>",
             "cron": {
                "day_of_month": "<день_месяца>",
                "month": "<месяц>",
                "day_of_week": "<день_недели>"
             },
             "retain_for_days": "<срок_хранения_копии_в_днях>",
             "description": "<описание_политики>",
             "policy_name": "<название_политики>"
           }' \
       mdb.api.yandexcloud.kz:443 \
       yandex.cloud.mdb.postgresql.v1.BackupRetentionPolicyService.Create
   

   Где:

   • day_of_month — день месяца. Возможные значения: 1–31.

   • month — месяц. Возможные значения: 1–12 или JAN–DEC.

   • day_of_week — день недели. Возможные значения: 0–6 или SUN–SAT.

   • retain_for_days — срок хранения копии в днях. Минимальное значение — 7.

     Параметры day_of_month, month и day_of_week составляют расписание, по которому создаются резервные копии. Расписание задается в виде cron-выражения, но часы и минуты не указываются.

     Сron-выражение также поддерживает специальные символы:

     • * — выбор всех возможных значений. Копия будет создаваться каждый раз (день или месяц), когда это возможно и не противоречит остальным параметрам. Используется по умолчанию, если значение параметра не указано.
     • , — перечисление нескольких значений.
     • – — указание диапазона значений.
     • / — указание шага диапазона. Например, */3 для параметра day_of_month означает, что копия будет создаваться раз в три дня.

     Если ни один параметр расписания не задан, резервные копии создаются по cron-выражению * * *, то есть каждый день.

     Примеры cron-выражений:

     • 1 */6 * — копия создается в первый день месяца раз в полгода.
     • 31 jan SUN — копия создается в январе по воскресеньям и тридцать первого января.
     • * * WED — копия создается каждую среду.

     Вы можете протестировать cron-выражение в редакторе.

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

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

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

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

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

curl \
  --request GET \
  --header "Authorization: Bearer $IAM_TOKEN" \
  --url 'https://mdb.api.yandexcloud.kz/managed-postgresql/v1/clusters/<идентификатор_кластера>/retention_policies?pageSize=<количество_результатов>'

Где pageSize — количество результатов запроса, которые возвращаются на одной странице. Укажите число больше нуля.

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

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

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

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

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

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

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

Чтобы получить список политик для кластера:

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

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/postgresql/v1/backup_retention_policy_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>",
           "page_size": "<количество_результатов>"
         }' \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.postgresql.v1.BackupRetentionPolicyService.List
   

   Где page_size — количество результатов запроса, которые возвращаются на одной странице. Укажите число больше нуля.

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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы удалить политику:

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

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/postgresql/v1/backup_retention_policy_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "policy_id": "<идентификатор_политики>",
           "cluster_id": "<идентификатор_кластера>"
         }' \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.postgresql.v1.BackupRetentionPolicyService.Delete
   

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

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