MajorVersionUpgrade#

Description#

Запрос на смену мажорной версии PostgreSQL.

Мажорная версия повышается на одну ступень относительно текущей, например с 15 до 16. Текущая версия задаётся параметром version сервиса (см. Параметры PaaS).

Внимание

Операция доступна только для сервисов PostgreSQL с версией окружения paas_v4_4 и выше. Текущую версию окружения можно узнать с помощью метода DescribeService.

Внимание

Смена мажорной версии — необратимая операция: вернуть предыдущую версию невозможно. На время обновления сервис будет недоступен. Перед сменой версии рекомендуется создать резервную копию баз данных.

Операция выполняется асинхронно: после запуска обновления сервис перейдёт в состояние Обновление, а по завершении — в состояние Запущен.

Запрос можно выполнять, когда сервис находится в состоянии Запущен. Максимальная доступная версия — PostgreSQL 18. Если текущая версия уже является максимальной, запрос завершится ошибкой MaximumMajorVersionIsReached.

Request Parameters#

  • serviceId — Идентификатор сервиса.

    • Тип: String

    • Необходимо: Да

Response Elements#

  • return — В случае успешного выполнения запроса возвращается True, в противном случае возвращается ошибка.

    • Тип: Boolean

Examples#

Для управления сервисами PaaS в К2 Облаке с помощью API необходима кастомизированная версия библиотеки boto3:

import boto3

session = boto3.Session(
   aws_access_key_id="<AWS_ACCESS_KEY_ID>",
   aws_secret_access_key="<AWS_SECRET_ACCESS_KEY>",
   region_name="",
)

paas_client = session.client(
   "paas",
   endpoint_url="https://paas.ru-msk.k2.cloud/",
)

paas_client.major_version_upgrade(
   serviceId="fm-cluster-9EE731A6",
)

Или утилита c2-paas из пакета K2 Cloud API Client:

c2-paas MajorVersionUpgrade serviceId fm-cluster-7867D61F