Техническое обслуживание кластера Yandex MPP Analytics for PostgreSQL

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

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

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

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

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

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

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

   О том, как получить идентификатор облака, в соответствующей инструкции.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/greenplum/v1/maintenance_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "maintenance_id": "<идентификатор_обслуживания>"
         }' \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.greenplum.v1.MaintenanceService.Get
   

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

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

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

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

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Чтобы перенести запланированное обслуживание:

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

   yc managed-greenplum cluster reschedule-maintenance --help
   

2. Перенесите обслуживание:

   yc managed-greenplum cluster reschedule-maintenance <имя_или_идентификатор_кластера> \
     --reschedule-type <тип_переноса>
   

   Где --reschedule-type — тип переноса:

   • next-available-window — ближайшее доступное окно обслуживания.

   • specific-time — конкретная дата и время по UTC.

     Для этого значения дополнительно передайте параметр --delayed-until — временная метка в одном из следующих форматов:

     • RFC 3339;
     • ЧЧ:ММ:СС;
     • относительное время, на которое нужно перенести обслуживание.

     Примеры: 2006-01-02T15:04:05Z, 15:04:05, 2h, 3h30m ago.

     От первоначально запланированной даты обслуживание можно перенести:

     • Не более чем на два с половиной месяца — для мажорных обновлений версии Greenplum®, например с 6.28.20 до 6.29.8.
     • Не более чем на один месяц — для обновлений между минорными версиями Greenplum®, например с 6.29.1 до 6.29.2.
     • Не более чем на две недели — для всех остальных видов обслуживания.

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

Перенести запланированное обслуживание можно с помощью одного из методов:

• Cluster.RescheduleMaintenance
• Maintenance.Reschedule

Чтобы перенести запланированное обслуживание с помощью метода Cluster.RescheduleMaintenance:

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

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

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

   curl \
     --request POST \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-greenplum/v1/clusters/<идентификатор_кластера>:rescheduleMaintenance' \
     --data '{
               "rescheduleType": "<тип_переноса>"
             }'
   

   Где rescheduleType — тип переноса:

   • NEXT_AVAILABLE_WINDOW — ближайшее доступное окно обслуживания.

   • SPECIFIC_TIME — конкретная дата и время по UTC.

     Для этого значения дополнительно передайте параметр delayedUntil — временная метка в формате RFC 3339, например 2006-01-02T15:04:05Z.

     От первоначально запланированной даты обслуживание можно перенести:

     • Не более чем на два с половиной месяца — для мажорных обновлений версии Greenplum®, например с 6.28.20 до 6.29.8.
     • Не более чем на один месяц — для обновлений между минорными версиями Greenplum®, например с 6.29.1 до 6.29.2.
     • Не более чем на две недели — для всех остальных видов обслуживания.

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

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

Чтобы перенести запланированное обслуживание с помощью метода Maintenance.Reschedule:

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

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

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

   curl \
     --request POST \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-greenplum/v1/maintenances/<идентификатор_обслуживания>:reschedule' \
     --data '{
               "rescheduleType": "<тип_переноса>"
             }'
   

   Где:

   • <идентификатор_обслуживания> — идентификатор обслуживания, который можно получить со списком обслуживаний.

   • rescheduleType — тип переноса:

     • NEXT_AVAILABLE_WINDOW — ближайшее доступное окно обслуживания.

     • SPECIFIC_TIME — конкретная дата и время по UTC.

       Для этого значения дополнительно передайте параметр scheduledAt — временная метка в формате RFC 3339, например 2006-01-02T15:04:05Z.

       От первоначально запланированной даты обслуживание можно перенести:

       • Не более чем на два с половиной месяца — для мажорных обновлений версии Greenplum®, например с 6.28.20 до 6.29.8.
       • Не более чем на один месяц — для обновлений между минорными версиями Greenplum®, например с 6.29.1 до 6.29.2.
       • Не более чем на две недели — для всех остальных видов обслуживания.

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

Перенести запланированное обслуживание можно с помощью одного из вызовов:

• ClusterService.RescheduleMaintenance
• MaintenanceService.Reschedule

Чтобы перенести запланированное обслуживание с помощью вызова ClusterService.RescheduleMaintenance:

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

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

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

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

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

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

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

   Где reschedule_type — тип переноса:

   • NEXT_AVAILABLE_WINDOW — ближайшее доступное окно обслуживания.

   • SPECIFIC_TIME — конкретная дата и время по UTC.

     Для этого значения дополнительно передайте параметр delayed_until — временная метка в формате RFC 3339, например 2006-01-02T15:04:05Z.

     От первоначально запланированной даты обслуживание можно перенести:

     • Не более чем на два с половиной месяца — для мажорных обновлений версии Greenplum®, например с 6.28.20 до 6.29.8.
     • Не более чем на один месяц — для обновлений между минорными версиями Greenplum®, например с 6.29.1 до 6.29.2.
     • Не более чем на две недели — для всех остальных видов обслуживания.

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

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

Чтобы перенести запланированное обслуживание с помощью вызова MaintenanceService.Reschedule:

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

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

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

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

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

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

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/greenplum/v1/maintenance_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "maintenance_id": "<идентификатор_обслуживания>",
           "reschedule_type": "<тип_переноса>",
           "scheduled_at": "<временная_метка>"
         }' \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.greenplum.v1.MaintenanceService.Reschedule
   

   Где:

   • maintenance_id — идентификатор обслуживания, который можно получить со списком обслуживаний.

   • reschedule_type — тип переноса:

     • NEXT_AVAILABLE_WINDOW — ближайшее доступное окно обслуживания.

     • SPECIFIC_TIME — конкретная дата и время по UTC.

       Для этого значения дополнительно передайте параметр scheduled_at — временная метка в формате RFC 3339, например 2006-01-02T15:04:05Z.

       От первоначально запланированной даты обслуживание можно перенести:

       • Не более чем на два с половиной месяца — для мажорных обновлений версии Greenplum®, например с 6.28.20 до 6.29.8.
       • Не более чем на один месяц — для обновлений между минорными версиями Greenplum®, например с 6.29.1 до 6.29.2.
       • Не более чем на две недели — для всех остальных видов обслуживания.

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

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

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

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Чтобы провести запланированное обслуживание немедленно:

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

   yc managed-greenplum cluster reschedule-maintenance --help
   

2. Проведите запланированное обслуживание немедленно:

   yc managed-greenplum cluster reschedule-maintenance <имя_или_идентификатор_кластера> \
     --reschedule-type immediate
   

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

Провести запланированное обслуживание немедленно можно с помощью одного из методов:

• Cluster.RescheduleMaintenance
• Maintenance.Reschedule

Чтобы провести запланированное обслуживание немедленно с помощью метода Cluster.RescheduleMaintenance:

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

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

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

   curl \
     --request POST \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-greenplum/v1/clusters/<идентификатор_кластера>:rescheduleMaintenance' \
     --data '{
               "rescheduleType": "IMMEDIATE"
             }'
   

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

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

Чтобы провести запланированное обслуживание немедленно с помощью метода Maintenance.Reschedule:

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

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

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

   curl \
     --request POST \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-greenplum/v1/maintenances/<идентификатор_обслуживания>:reschedule' \
     --data '{
               "rescheduleType": "IMMEDIATE"
             }'
   

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

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

Провести запланированное обслуживание немедленно можно с помощью одного из вызовов:

• ClusterService.RescheduleMaintenance
• MaintenanceService.Reschedule

Чтобы провести запланированное обслуживание немедленно с помощью вызова ClusterService.RescheduleMaintenance:

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

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

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

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

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

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

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

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

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

Чтобы провести запланированное обслуживание немедленно с помощью вызова MaintenanceService.Reschedule:

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

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

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

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

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

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

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/greenplum/v1/maintenance_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "maintenance_id": "<идентификатор_обслуживания>",
           "reschedule_type": "IMMEDIATE"
         }' \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.greenplum.v1.MaintenanceService.Reschedule
   

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

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

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

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

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

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

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

   yc managed-greenplum cluster update --help
   

2. Настройте окно технического обслуживания:

   yc managed-greenplum cluster update <имя_или_идентификатор_кластера> \
     --maintenance-window type=<тип_технического_обслуживания>,`
                         `day=<день_недели>,`
                         `hour=<порядковый_номер_часового_интервала>
   

   Где type — тип технического обслуживания:

   • anytime (по умолчанию) — в любое время.

   • weekly — по расписанию. Для этого значения дополнительно укажите:

     • day — день недели: MON, TUE, WED, THU, FRI, SAT или SUN.

     • hour — порядковый номер часового интервала по UTC: от 1 до 24.

       Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

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

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

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

   Полный список доступных для изменения полей конфигурации кластера Yandex MPP Analytics for PostgreSQL вы найдете в документации провайдера Terraform.

2. Чтобы настроить окно технического обслуживания, добавьте к описанию кластера блок maintenance_window:

   resource "yandex_mdb_greenplum_cluster" "<локальное_имя_кластера>" {
     ...
     maintenance_window {
       type = "<тип_технического_обслуживания>"
       day  = "<день_недели>"
       hour = <порядковый_номер_часового_интервала>
     }
     ...
   }
   

   Где:

   • type — тип технического обслуживания. Принимает значения:

     • ANYTIME (по умолчанию) — в любое время.
     • WEEKLY — по расписанию.

   • day — день недели для типа WEEKLY: MON, TUE, WED, THU, FRI, SAT или SUN.

   • hour — порядковый номер часового интервала по UTC для типа WEEKLY: от 1 до 24.

     Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

   Провайдер Terraform ограничивает время на выполнение всех операций с кластером Yandex MPP Analytics for PostgreSQL 120 минутами.

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

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

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

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

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

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

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

   curl \
     --request PATCH \
     --header "Authorization: Bearer $IAM_TOKEN" \
     --header "Content-Type: application/json" \
     --url 'https://mdb.api.yandexcloud.kz/managed-greenplum/v1/clusters/<идентификатор_кластера>' \
     --data '{
               "updateMask": "maintenanceWindow",
               "maintenanceWindow": {
                 "weeklyMaintenanceWindow": {
                   "day": "<день_недели>",
                   "hour": "<порядковый_номер_часового_интервала>"
                 }
               }
             }'
   

   Где:

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

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

     Важно

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

   • maintenanceWindow — настройки окна технического обслуживания. Передайте один из параметров:

     • anytime (по умолчанию) — разрешает проводить техническое обслуживание в любое время.

       Параметр передается как пустой объект: "anytime": {}.

     • weeklyMaintenanceWindow — техническое обслуживание проводится раз в неделю в указанное время:

       • day — день недели: MON, TUE, WED, THU, FRI, SAT или SUN.

       • hour — порядковый номер часового интервала по UTC: от 1 до 24.

         Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

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

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:

   grpcurl \
     -format json \
     -import-path ~/cloudapi/ \
     -import-path ~/cloudapi/third_party/googleapis/ \
     -proto ~/cloudapi/yandex/cloud/mdb/greenplum/v1/cluster_service.proto \
     -rpc-header "Authorization: Bearer $IAM_TOKEN" \
     -d '{
           "cluster_id": "<идентификатор_кластера>",
           "update_mask": {
             "paths": [
               "maintenance_window"
             ]
           },
           "maintenance_window": {
             "weekly_maintenance_window": {
               "day": "<день_недели>",
               "hour": "<порядковый_номер_часового_интервала>"
             }
           }
         }' \
     mdb.api.yandexcloud.kz:443 \
     yandex.cloud.mdb.greenplum.v1.ClusterService.Update
   

   Где:

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

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

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

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

     Важно

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

   • maintenance_window — настройки окна технического обслуживания. Передайте один из параметров:

     • anytime (по умолчанию) — разрешает проводить техническое обслуживание в любое время.

       Параметр передается как пустой объект: "anytime": {}.

     • weekly_maintenance_window — техническое обслуживание проводится раз в неделю в указанное время:

       • day — день недели: MON, TUE, WED, THU, FRI, SAT или SUN.

       • hour — порядковый номер часового интервала по UTC: от 1 до 24.

         Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

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

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