Управление кластером

Получить список кластеров

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.

Откроется список кластеров проекта.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.

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

1
mws mpostgres cluster list

1
+----------------+-----------------------------+---------------------+----------+--------------+------------------+----------------------+
2
|      NAME      |        DISPLAY NAME         |       VERSION       |  STATUS  |     STATE    | PRIMARY ENDPOINT |     DATE CREATED     |
3
+----------------+-----------------------------+---------------------+----------+--------------+------------------+----------------------+
4
| <имя кластера> | <отображаемое имя кластера> | <версия PostgreSQL> |  ALIVE   |   RUNNING    | 192.168.0.19     | 2025-09-29T05:12:01Z |
5
+----------------+-----------------------------+---------------------+----------+--------------+------------------+----------------------+

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Выполните запрос:
bash
```
1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будет выведен список доступных кластеров проекта с детализацией параметров.

Получить информацию о конкретном кластере

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера.

Откроется страница кластера.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

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

1
mws mpostgres cluster get <имя кластера>

1
metadata:
2
    displayName:
3
    createTime: "2025-09-29T05:12:01Z"
4
    updateTime: "2025-09-30T02:10:41Z"
5
    description: ""
6
    id: mpostgres/projects/<имя проекта>/clusters/<имя кластера>
7
spec:
8
    version: "<версия PostgreSQL>"
9
    active: false
10
    endpoints:
11
        - name: <имя эндпоинта>
12
          network: projects/<имя проекта>/networks/<имя сети>
13
          primaryAddresses:
14
            - spec:
15
                subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
16
          readOnlyAddresses: []
17
    network:
18
        primaryAddresses:
19
            - spec:
20
                subnet: projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>
21
        readOnlyAddresses: []
22
    instanceTemplate:
23
        vmType: vmTypes/gen-2-8
24
        disk:
25
            size: <размер диска в гигабайтах>
26
            type: <тип диска>
27
    instances:
28
        - count: 2
29
          zone: <зона доступности>
30
status:
31
    ready:
32
        state: OK
33
    state: RUNNING
34
    health: ALIVE
35
    network:
36
        primaryAddresses: []
37
        readOnlyAddresses: []
38
    instances:
39
        - name: <имя узла кластера>
40
          role: <роль узла кластера>
41
          health: ALIVE
42
    maintenanceWindow:
43
        weekly:
44
            day: SUNDAY
45
            days:
46
                - SUNDAY
47
            hour: 0
48
    backup:
49
        daily:
50
            hour: 0
51
        retainPeriodDays: 7

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:
bash
```
1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>"
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будут выведены параметры кластера с детализацией.

Остановить кластер

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на значок ... для нужного кластера и выберите Остановить.
Подтвердите остановку.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```
Выполните команду:
bash
```
1
mws mpostgres cluster stop <имя кластера>
```
Если кластер был остановлен успешно, в ответе будут выведены обновленные параметры кластера.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:
bash
```
1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>:stop \
2
  -H "Authorization: Bearer <IAM-токен>"
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. Если кластер был остановлен успешно, в ответе будут выведены обновленные параметры кластера.

После остановки статусе кластера изменится на Stopped.

Запустить кластер

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на значок ... для нужного кластера и выберите Запустить.
Подтвердите запуск.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```
Выполните команду:
bash
```
1
mws mpostgres cluster start <имя кластера>
```
Если кластер был запущен успешно, в ответе будут выведены обновленные параметры кластера.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:
bash
```
1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>:start \
2
  -H "Authorization: Bearer <IAM-токен>"
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. Если кластер был запущен успешно, в ответе будут выведены обновленные параметры кластера.

После запуска статус кластера изменится на Running.

Сделать реплику первичным узлом

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL. Откроется список кластеров.
Выберите нужный кластер и перейдите в раздел Узлы.
Нажмите на значок ... для нужной реплики и выберите Сделать primary-узлом.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```
Определите имя узла, который нужно сделать первичным:
bash
```
1
mws mpostgres cluster get <имя кластера>
```
Имена узлов кластера указаны в значениях параметра status:instances:name, их роли — в значениях status:instances:role.
Выполните команду:
bash
```
1
mws mpostgres cluster switchover <имя кластера> --candidate <имя узла>
```
Если узел был назначен основным успешно, в ответе будут выведены обновленные параметры кластера.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Получите имя узла, который нужно сделать первичным:
bash
```
1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/instances \
2
  -H "Authorization: Bearer <IAM-токен>"
```
В ответе значение параметра name для нужного узла — его имя.
Выполните запрос:
bash
```
1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>:switchover \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "candidate": "<имя узла>"
6
    }'
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. Если узел был назначен основным успешно, в ответе будут выведены обновленные параметры кластера.

Реплика станет первичным узлом. На него перенаправятся все подключения. Предыдущий первичный узел автоматически станет репликой.

Переименовать кластер

Вы можете изменить только отображаемое имя кластера. Идентификатор кластера при этом не изменится.

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на значок ... для нужного кластера и выберите Переименовать.
Укажите новое отображаемое имя кластера и нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```
Выполните команду:
bash
```
1
mws mpostgres cluster update <имя кластера> --display-name <новое отображаемое имя кластера>
```
Если кластер был переименован успешно, в ответе будут выведены обновленные параметры кластера.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "metadata": {
6
    "displayName": "<новое отображаемое имя кластера>"
7
      }
8
    }'

Если запрос был успешно принят, вы получите ответ с кодом 200 OK. Если кластер был переименован успешно, в ответе будут выведены обновленные параметры кластера.

Настроить внешний IP-адрес кластера

Назначить внешний IP-адрес

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера.
В блоке Подключение к кластеру нажмите на значок ... для нужного эндпоинта и выберите Назначить.
Выберите тип IP-адреса: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. Если IP-адрес еще не зарезервирован, зарезервируйте его.
Нажмите кнопку Назначить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя нужного эндпоинта и идентификаторы его сети и подсети:

1
mws mpostgres cluster get <имя кластера>

1
metadata:
2
  displayName:
3
  createTime: "2026-03-04T03:47:11Z"
4
  updateTime: "2026-03-27T10:15:44Z"
5
  description: ""
6
  id: <идентификатор кластера>
7
spec:
8
  version: "<версия PostgreSQL>"
9
  active: true
10
  endpoints:
11
    - name: <имя эндпоинта>
12
      network: <идентификатор сети>
13
      primaryAddresses:  # Группа primary-адресов
14
        - spec:
15
            subnet: <идентификатор подсети>
16
          externalAccess:
17
            allowed: false
18
      readOnlyAddresses:  # Группа readOnly-адресов
19
        - spec:
20
            subnet: <идентификатор подсети>
21
          externalAccess:
22
            allowed: true
23
  instanceTemplate:
24
    vmType: vmTypes/gen-2-8
25
    disk:
26
      size: <размер диска в гигабайтах>
27
      type: <тип диска>
28
  instances:
29
    - count: 4
30
status:
31
  ready:
32
    state: OK
33
  state: RUNNING
34
  health: ALIVE
35
  network:
36
    primaryAddresses:
37
      - address: <идентификатор внутреннего IP-адреса>
38
        ip: <внутренний IP-адрес>
39
    readOnlyAddresses:
40
      - address: <идентификатор внутреннего IP-адреса>
41
        ip: <внутренний IP-адрес>
42
        external:
43
          address: <идентификатор внешнего IP-адреса>
44
          ip: <внешний IP-адрес>
45
  instances:
46
    - name: <имя узла кластера>
47
      role: <роль узла кластера>
48
      health: ALIVE

(опционально) Если вы назначаете зарезервированный IP-адрес, узнайте его идентификатор:
bash
```
1
mws vpc external-address get <имя адреса>
```

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

1
mws mpostgres cluster update <имя кластера> --endpoints '
2
name: <имя эндпоинта>
3
network: <идентификатор сети>
4
<группа адресов>:
5
  - spec:
6
      subnet: <идентификатор подсети>
7
    externalAccess:
8
      allowed: true
9
      ref: <идентификатор зарезервированного IP-адреса>
10
'

Если в запросе нет параметра externalAccess:ref, эндпоинту будет назначен случайный временный IP-адрес.

Если IP-адрес назначен успешно, в ответе будут выведены обновленные параметры кластера.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя нужного эндпоинта и идентификаторы его сети и подсети:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>"

1
{
2
  "metadata": {
3
    "displayName": "",
4
    "createTime": "2026-03-04T03:47:11.916994Z",
5
    "updateTime": "2026-03-27T10:15:44.258432Z",
6
    "description": "",
7
    "id": "<идентификатор кластера>"
8
  },
9
  "spec": {
10
    "version": "<версия PostgreSQL>",
11
    "active": true,
12
    "endpoints": [
13
    {
14
      "name": "<имя эндпоинта>",
15
      "network": "<идентификатор сети>",
16
      "primaryAddresses": [  // Группа primary-адресов
17
      {
18
        "spec": {
19
          "subnet": "<идентификатор подсети>"
20
        },
21
        "externalAccess": {
22
          "allowed": false
23
        }
24
      }],
25
      "readOnlyAddresses": [  // Группа readOnly-адресов
26
      {
27
        "spec": {
28
          "subnet": "<идентификатор подсети>"
29
        },
30
        "externalAccess": {
31
          "allowed": true
32
        }
33
      }]
34
    }],
35
    "instanceTemplate": {
36
      "vmType": "vmTypes/gen-2-8",
37
      "disk": {
38
        "size": "<размер диска в гигабайтах>",
39
        "type": "<тип диска>"
40
      }
41
    },
42
    "maintenanceWindow": {
43
      "weekly": {
44
        "days": [
45
          "THURSDAY"
46
        ],
47
        "hour": 0
48
      }
49
    }
50
  },
51
  "status": {
52
    "ready": {
53
      "state": "OK"
54
    },
55
    "state": "RUNNING",
56
    "health": "ALIVE",
57
    "network": {
58
      "primaryAddresses": [
59
      {
60
        "address": "<идентификатор внутреннего IP-адреса>",
61
        "ip": "<внутренний IP-адрес>"
62
      }],
63
      "readOnlyAddresses": [
64
      {
65
        "address": "<идентификатор внутреннего IP-адреса>",
66
        "ip": "<внутренний IP-адрес>",
67
        "external": {
68
          "address": "<идентификатор внешнего IP-адреса>",
69
          "ip": "<внешний IP-адрес>"
70
        }
71
      }]
72
    },
73
    "instances": [
74
    {
75
      "name": "<имя узла кластера>",
76
      "role": "<роль узла кластера>",
77
      "health": "ALIVE"
78
    }]
79
  }
80
}

(опционально) Если вы назначаете зарезервированный IP-адрес, узнайте его идентификатор:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "spec": {
6
      "endpoints": [
7
      {
8
        "name": "<имя эндпоинта>",
9
        "network": "<идентификатор сети>",
10
        "<группа адресов>": [
11
        {
12
          "spec": {
13
            "subnet": "<идентификатор подсети>"
14
          },
15
          "externalAccess": {
16
            "allowed": true,
17
            "ref": "<идентификатор зарезервированного IP-адреса>"
18
          }
19
        }]
20
      }]
21
    }
22
  }'

Если в запросе нет параметра externalAccess:ref, эндпоинту будет назначен случайный временный IP-адрес.

Если запрос успешно принят, вы получите ответ с кодом 200 OK, а в ответе будут выведены обновленные параметры кластера.

Сменить внешний IP-адрес

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера.
В блоке Подключение к кластеру нажмите на значок ... для нужного эндпоинта и выберите Назначить другой.
Выберите тип IP-адреса: временный, который выбирается автоматически из диапазона подсети, или зарезервированный. Если IP-адрес еще не зарезервирован, зарезервируйте его.
Нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя нужного эндпоинта и идентификаторы его сети и подсети:

1
mws mpostgres cluster get <имя кластера>

1
metadata:
2
  displayName:
3
  createTime: "2026-03-04T03:47:11Z"
4
  updateTime: "2026-03-27T10:15:44Z"
5
  description: ""
6
  id: <идентификатор кластера>
7
spec:
8
  version: "<версия PostgreSQL>"
9
  active: true
10
  endpoints:
11
    - name: <имя эндпоинта>
12
      network: <идентификатор сети>
13
      primaryAddresses:  # Группа primary-адресов
14
        - spec:
15
            subnet: <идентификатор подсети>
16
          externalAccess:
17
            allowed: false
18
      readOnlyAddresses:  # Группа readOnly-адресов
19
        - spec:
20
            subnet: <идентификатор подсети>
21
          externalAccess:
22
            allowed: true
23
  instanceTemplate:
24
    vmType: vmTypes/gen-2-8
25
    disk:
26
      size: <размер диска в гигабайтах>
27
      type: <тип диска>
28
  instances:
29
    - count: 4
30
status:
31
  ready:
32
    state: OK
33
  state: RUNNING
34
  health: ALIVE
35
  network:
36
    primaryAddresses:
37
      - address: <идентификатор внутреннего IP-адреса>
38
        ip: <внутренний IP-адрес>
39
    readOnlyAddresses:
40
      - address: <идентификатор внутреннего IP-адреса>
41
        ip: <внутренний IP-адрес>
42
        external:
43
          address: <идентификатор внешнего IP-адреса>
44
          ip: <внешний IP-адрес>
45
  instances:
46
    - name: <имя узла кластера>
47
      role: <роль узла кластера>
48
      health: ALIVE

(опционально) Если вы назначаете зарезервированный IP-адрес, узнайте его идентификатор:
bash
```
1
mws vpc external-address get <имя адреса>
```

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

1
mws mpostgres cluster update <имя кластера> --endpoints '
2
name: <имя эндпоинта>
3
network: <идентификатор сети>
4
<группа адресов>:
5
  - spec:
6
      subnet: <идентификатор подсети>
7
    externalAccess:
8
      allowed: true
9
      ref: <идентификатор зарезервированного IP-адреса>
10
'

Если в запросе нет параметра externalAccess:ref, эндпоинту будет назначен случайный временный IP-адрес.

Если IP-адрес изменен успешно, в ответе будут выведены обновленные параметры кластера.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя нужного эндпоинта и идентификаторы его сети и подсети:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>"

1
{
2
  "metadata": {
3
    "displayName": "",
4
    "createTime": "2026-03-04T03:47:11.916994Z",
5
    "updateTime": "2026-03-27T10:15:44.258432Z",
6
    "description": "",
7
    "id": "<идентификатор кластера>"
8
  },
9
  "spec": {
10
    "version": "<версия PostgreSQL>",
11
    "active": true,
12
    "endpoints": [
13
    {
14
      "name": "<имя эндпоинта>",
15
      "network": "<идентификатор сети>",
16
      "primaryAddresses": [  // Группа primary-адресов
17
      {
18
        "spec": {
19
          "subnet": "<идентификатор подсети>"
20
        },
21
        "externalAccess": {
22
          "allowed": false
23
        }
24
      }],
25
      "readOnlyAddresses": [  // Группа readOnly-адресов
26
      {
27
        "spec": {
28
          "subnet": "<идентификатор подсети>"
29
        },
30
        "externalAccess": {
31
          "allowed": true
32
        }
33
      }]
34
    }],
35
    "instanceTemplate": {
36
      "vmType": "vmTypes/gen-2-8",
37
      "disk": {
38
        "size": "<размер диска в гигабайтах>",
39
        "type": "<тип диска>"
40
      }
41
    },
42
    "maintenanceWindow": {
43
      "weekly": {
44
        "days": [
45
          "THURSDAY"
46
        ],
47
        "hour": 0
48
      }
49
    }
50
  },
51
  "status": {
52
    "ready": {
53
      "state": "OK"
54
    },
55
    "state": "RUNNING",
56
    "health": "ALIVE",
57
    "network": {
58
      "primaryAddresses": [
59
      {
60
        "address": "<идентификатор внутреннего IP-адреса>",
61
        "ip": "<внутренний IP-адрес>"
62
      }],
63
      "readOnlyAddresses": [
64
      {
65
        "address": "<идентификатор внутреннего IP-адреса>",
66
        "ip": "<внутренний IP-адрес>",
67
        "external": {
68
          "address": "<идентификатор внешнего IP-адреса>",
69
          "ip": "<внешний IP-адрес>"
70
        }
71
      }]
72
    },
73
    "instances": [
74
    {
75
      "name": "<имя узла кластера>",
76
      "role": "<роль узла кластера>",
77
      "health": "ALIVE"
78
    }]
79
  }
80
}

(опционально) Если вы назначаете зарезервированный IP-адрес, узнайте его идентификатор:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "spec": {
6
      "endpoints": [
7
      {
8
        "name": "<имя эндпоинта>",
9
        "network": "<идентификатор сети>",
10
        "<группа адресов>": [
11
        {
12
          "spec": {
13
            "subnet": "<идентификатор подсети>"
14
          },
15
          "externalAccess": {
16
            "allowed": true,
17
            "ref": "<идентификатор зарезервированного IP-адреса>"
18
          }
19
        }]
20
      }]
21
    }
22
  }'

Если в запросе нет параметра externalAccess:ref, эндпоинту будет назначен случайный временный IP-адрес.

После замены временный IP-адрес вернется в пул провайдера. Зарезервированный IP-адрес останется в проекте, за его хранение продолжит взиматься плата.

Отвязать внешний IP-адрес

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера.
В блоке Подключение к кластеру нажмите на значок ... для нужного эндпоинта и выберите Отвязать.
Нажмите кнопку Подтвердить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

Узнайте имя нужного эндпоинта и идентификаторы его сети и подсети:

1
mws mpostgres cluster get <имя кластера>

1
metadata:
2
  displayName:
3
  createTime: "2026-03-04T03:47:11Z"
4
  updateTime: "2026-03-27T10:15:44Z"
5
  description: ""
6
  id: <идентификатор кластера>
7
spec:
8
  version: "<версия PostgreSQL>"
9
  active: true
10
  endpoints:
11
    - name: <имя эндпоинта>
12
      network: <идентификатор сети>
13
      primaryAddresses:  # Группа primary-адресов
14
        - spec:
15
            subnet: <идентификатор подсети>
16
          externalAccess:
17
            allowed: false
18
      readOnlyAddresses:  # Группа readOnly-адресов
19
        - spec:
20
            subnet: <идентификатор подсети>
21
          externalAccess:
22
            allowed: true
23
  instanceTemplate:
24
    vmType: vmTypes/gen-2-8
25
    disk:
26
      size: <размер диска в гигабайтах>
27
      type: <тип диска>
28
  instances:
29
    - count: 4
30
status:
31
  ready:
32
    state: OK
33
  state: RUNNING
34
  health: ALIVE
35
  network:
36
    primaryAddresses:
37
      - address: <идентификатор внутреннего IP-адреса>
38
        ip: <внутренний IP-адрес>
39
    readOnlyAddresses:
40
      - address: <идентификатор внутреннего IP-адреса>
41
        ip: <внутренний IP-адрес>
42
        external:
43
          address: <идентификатор внешнего IP-адреса>
44
          ip: <внешний IP-адрес>
45
  instances:
46
    - name: <имя узла кластера>
47
      role: <роль узла кластера>
48
      health: ALIVE

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

1
mws mpostgres cluster update <имя кластера> --endpoints '
2
name: <имя эндпоинта>
3
network: <идентификатор сети>
4
<группа адресов>:
5
  - spec:
6
      subnet: <идентификатор подсети>
7
    externalAccess:
8
      allowed: false
9
'

Если внешний IP отвязан успешно, в ответе будут выведены обновленные параметры кластера.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Узнайте имя нужного эндпоинта и идентификаторы его сети и подсети:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>"

1
{
2
  "metadata": {
3
    "displayName": "",
4
    "createTime": "2026-03-04T03:47:11.916994Z",
5
    "updateTime": "2026-03-27T10:15:44.258432Z",
6
    "description": "",
7
    "id": "<идентификатор кластера>"
8
  },
9
  "spec": {
10
    "version": "<версия PostgreSQL>",
11
    "active": true,
12
    "endpoints": [
13
    {
14
      "name": "<имя эндпоинта>",
15
      "network": "<идентификатор сети>",
16
      "primaryAddresses": [  // Группа primary-адресов
17
      {
18
        "spec": {
19
          "subnet": "<идентификатор подсети>"
20
        },
21
        "externalAccess": {
22
          "allowed": false
23
        }
24
      }],
25
      "readOnlyAddresses": [  // Группа readOnly-адресов
26
      {
27
        "spec": {
28
          "subnet": "<идентификатор подсети>"
29
        },
30
        "externalAccess": {
31
          "allowed": true
32
        }
33
      }]
34
    }],
35
    "instanceTemplate": {
36
      "vmType": "vmTypes/gen-2-8",
37
      "disk": {
38
        "size": "<размер диска в гигабайтах>",
39
        "type": "<тип диска>"
40
      }
41
    },
42
    "maintenanceWindow": {
43
      "weekly": {
44
        "days": [
45
          "THURSDAY"
46
        ],
47
        "hour": 0
48
      }
49
    }
50
  },
51
  "status": {
52
    "ready": {
53
      "state": "OK"
54
    },
55
    "state": "RUNNING",
56
    "health": "ALIVE",
57
    "network": {
58
      "primaryAddresses": [
59
      {
60
        "address": "<идентификатор внутреннего IP-адреса>",
61
        "ip": "<внутренний IP-адрес>"
62
      }],
63
      "readOnlyAddresses": [
64
      {
65
        "address": "<идентификатор внутреннего IP-адреса>",
66
        "ip": "<внутренний IP-адрес>",
67
        "external": {
68
          "address": "<идентификатор внешнего IP-адреса>",
69
          "ip": "<внешний IP-адрес>"
70
        }
71
      }]
72
    },
73
    "instances": [
74
    {
75
      "name": "<имя узла кластера>",
76
      "role": "<роль узла кластера>",
77
      "health": "ALIVE"
78
    }]
79
  }
80
}

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "spec": {
6
      "endpoints": [
7
      {
8
        "name": "<имя эндпоинта>",
9
        "network": "<идентификатор сети>",
10
        "<группа адресов>": [
11
        {
12
          "spec": {
13
            "subnet": "<идентификатор подсети>"
14
          },
15
          "externalAccess": {
16
            "allowed": false
17
          }
18
        }]
19
      }]
20
    }
21
  }'

Если запрос успешно принят, вы получите ответ с кодом 200 OK. Если внешний IP отвязан успешно, в ответе будут выведены обновленные параметры кластера.

Временный IP-адрес вернется в пул провайдера. Зарезервированный IP-адрес останется в проекте, за его хранение продолжит взиматься плата.

Изменить конфигурацию узла

Изменить конфигурацию узла можно только в кластере с сетевым диском.

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на имя нужного кластера.
Нажмите на значок редактирования для блока Конфигурация узла и измените конфигурацию.
Нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```

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

1
mws mpostgres cluster update <имя кластера> \
2
  --instance-template-vm-type <тип ВМ — количество vCPU и RAM нельзя уменьшить> \
3
  --instance-template-disk-size <размер диска в гигабайтах — его нельзя уменьшить> \
4
  --instance-template-disk-type <тип диска — например, сетевой NETWORK_STANDARD_SSD или локальный LOCAL>

Если конфигурация была изменена успешно, в ответе будут выведены обновленные параметры кластера.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "spec": {
6
      "instanceTemplate": {
7
        "vmType": "<тип ВМ — количество vCPU и RAM нельзя уменьшить>",
8
        "disk": {
9
          "size": "<размер диска в гигабайтах — его нельзя уменьшить>",
10
          "type": "<тип диска>"
11
        }
12
      }
13
    }
14
  }'

Если запрос был успешно принят, вы получите ответ с кодом 200 OK. Если конфигурация была успешно изменена, в ответе будут выведены обновленные параметры кластера.

Удалить кластер

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Managed PostgreSQL.
Нажмите на значок ... для удаляемого кластера и выберите Удалить.
Подтвердите удаление.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя кластера:
bash
```
1
mws mpostgres cluster list
```
Выполните команду:
bash
```
1
mws mpostgres cluster delete <имя кластера>
```
В случае успешного удаления на экран будет выведен ответ success.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя кластера:

1
curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X DELETE https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
2
  -H "Authorization: Bearer <IAM-токен>"

Если кластер был успешно удален, вы получите ответ с кодом 204 No Content.