MajorVersionUpgrade
In this article:
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