# Operations: nubes_postgres

| Operation | Kind | Action | Subresource | ID | Params | Description |
|---|---|---|---|---|---|---|
| `create` | `instance` | `create` | `` | `19` | s3Uid, resourceInstances, resourceMemory, resourceCPU, resourceDisk, resourceRealm, needExternalAddressMaster, needExternalAddressSlave, ext_BACKUP_SCHEDULE, ext_BACKUP_NUM_TO_RETAIN, appVersion, jsonParameters, enablePgPoolerMaster, enablePgPoolerSlave, allowNoSSL, autoScale, autoScalePercentage, autoScaleTechWindow, ipSpaceNameMaster, ipSpaceNameSlave, autoScaleQuotaGb | руководство |
| `delete` | `instance` | `delete` | `` | `20` | deleteS3Bucket |  |
| `modify` | `instance` | `modify` | `` | `48` | resourceInstances, resourceMemory, resourceCPU, resourceDisk, needExternalAddressMaster, needExternalAddressSlave, ext_BACKUP_SCHEDULE, ext_BACKUP_NUM_TO_RETAIN, appVersion, jsonParameters, enablePgPoolerMaster, enablePgPoolerSlave, allowNoSSL, ipSpaceNameMaster, ipSpaceNameSlave |  |
| `recovery` | `action` | `recovery` | `` | `47` | resourceInstances, resourceMemory, resourceCPU, resourceDisk, resourceRealm |  |
| `restart` | `action` | `restart` | `` | `54` |  | ВНИМАНИЕ - Рестарт предполагает УДАЛЕНИЕ подов.<br/>Может быть полная поломка. Крайне осторожно запускать при работе |
| `resume` | `instance` | `resume` | `` | `114` |  |  |
| `suspend` | `instance` | `suspend` | `` | `115` |  |  |

## Operation: create

| Code | Type | Required | Default | Description | Man | Constraints | ID |
|---|---|---|---|---|---|---|---|
| `s3Uid` | `uuid` | `ДА` | `` | Экземпляр (учетная запись) S3 для резервного копирования. Резервное копирование обязательно | Экземпляр (учетная запись) S3 для резервного копирования. Резервное копирование обязательно | ref_svc_id=12 | `23` |
| `resourceInstances` | `integer &gt; 0` | `ДА` | `1` | Количество узлов | Количество узлов в кластере. 1,3,5,7 | minvalue=1; maxvalue=7; regex=^[1357]$ | `80` |
| `resourceMemory` | `integer &gt; 0` | `ДА` | `512` | Квота памяти пода (MBytes) | Квота памяти пода (MBytes) | minvalue=128; maxvalue=8192 | `81` |
| `resourceCPU` | `integer &gt; 0` | `ДА` | `500` | Квота ядра пода (milicores) | Квота ядра пода (milicores) | minvalue=100; maxvalue=4000 | `82` |
| `resourceDisk` | `` | `ДА` | `10` | Квота диска (Указывается в GIGAbytes) | Квота диска (Указывается в GIGAbytes) | minvalue=1; maxvalue=999 | `83` |
| `resourceRealm` | `string` | `ДА` | `` | Платформа для развертывания | Кластер Kubernetes, на котором будет развернут экземпляр | func=getAvailableResourceRealms | `102` |
| `needExternalAddressMaster` | `boolean` | `НЕТ` | `false` | Выделяет внешний (белый) IP для доступа к master | Выделяет внешний (белый) IP для доступа к master | value_list=false, true | `145` |
| `needExternalAddressSlave` | `boolean` | `НЕТ` | `false` | Выделяет внешний (белый) IP для доступа к slave. Будет работать, если slave в принципе есть | Выделяет внешний (белый) IP для доступа к slave. Будет работать, если slave в принципе есть | value_list=false, true | `146` |
| `ext_BACKUP_SCHEDULE` | `string` | `НЕТ` | `0 0 * * *` | Не обязательный. Время запуска бекапа | Не обязательный. Время запуска бекапа | regex=^((((\d+,)+\d+|(\d+(\/|-|#)\d+)|(\d+L?)|(\*(\/\d+)?)|(L(-\d+)?)|(\?)|([A-Z]{3}(-[A-Z]{3})?)) ?){5,7})|(@(annually|yearly|monthly|weekly|daily|hourly|reboot))|(@every (\d+(ns|us|µs|ms|s|m|h))+)$ | `265` |
| `ext_BACKUP_NUM_TO_RETAIN` | `integer &gt; 0` | `НЕТ` | `7` | Не обязательный. По умолчанию: &quot;24&quot;. Количество сохраняемых бекапов | Не обязательный. По умолчанию: &quot;24&quot;. Количество сохраняемых бекапов | minvalue=1; maxvalue=99 | `266` |
| `appVersion` | `string` | `ДА` | `17` | Версия PostgreSQL |  | value_list=17, 16, 15, 14, 13 | `310` |
| `jsonParameters` | `json` | `ДА` | `{ "log_connections": "off", "log_disconnections": "off" }` | Массив переменных, более подробнее про настройку можно посмотреть https://www.postgresql.org/docs/current/runtime-config.html |  | maxlength=2048 | `311` |
| `enablePgPoolerMaster` | `boolean` | `ДА` | `false` | Включает pgPooler (на запись). Будет создан новый под |  | value_list=false, true | `312` |
| `enablePgPoolerSlave` | `boolean` | `ДА` | `false` | Включает pgPooler (на чтение). Будет создан новый под |  | value_list=false, true | `313` |
| `allowNoSSL` | `boolean` | `ДА` | `false` | По умолчанию подключение обязательное (sslmode=require). Выставление в true отключит этот параметр |  | value_list=false, true | `314` |
| `autoScale` | `boolean` | `ДА` | `true` | Включает автоскейлинг PV. При включении параметра необходимо настроить autoScalePercentage и autoScaleTechWindow. Алерт при срабатывании вызывает modify у текущей услуги |  | value_list=false, true | `329` |
| `autoScalePercentage` | `integer &gt; 0` | `ДА` | `10` | Требует включения autoScale. Позволяет указать в процентах расширение от текущего макс объема |  | value_list=10, 15, 20 | `330` |
| `autoScaleTechWindow` | `integer &gt;= 0` | `ДА` | `0` | Требует включения autoScale. Окно обновления (пока не реализовано). Указывается час в виде Integer (0 / 5 / 12 / 23) |  | value_list=0, 5, 12, 23 | `331` |
| `ipSpaceNameMaster` | `string` | `НЕТ` | `` | Имя ipSpace для публикации VIP master. Не может быть пустым, если включен needExternalAddressMaster |  |  | `337` |
| `ipSpaceNameSlave` | `string` | `НЕТ` | `` | Имя ipSpace для публикации VIP slave. Не может быть пустым, если включен needExternalAddressSlave |  |  | `338` |
| `autoScaleQuotaGb` | `string` | `ДА` | `1` | Квота для autoScale |  |  | `339` |

## Operation: delete

| Code | Type | Required | Default | Description | Man | Constraints | ID |
|---|---|---|---|---|---|---|---|
| `deleteS3Bucket` | `boolean` | `ДА` | `true` | Также удалить технический S3 Bucket с бэкапами? |  | value_list=false, true | `457` |

## Operation: modify

| Code | Type | Required | Default | Description | Man | Constraints | ID |
|---|---|---|---|---|---|---|---|
| `resourceInstances` | `integer &gt; 0` | `НЕТ` | `` | Количество узлов | Количество узлов в сети | minvalue=1; maxvalue=7 | `91` |
| `resourceMemory` | `integer &gt; 0` | `НЕТ` | `` | Квота памяти пода (MBytes) | Квота памяти пода (MBytes) | minvalue=128; maxvalue=8192 | `92` |
| `resourceCPU` | `integer &gt; 0` | `НЕТ` | `` | Квота ядра пода (milicores) | Квота ядра пода (milicores) | minvalue=100; maxvalue=4000 | `93` |
| `resourceDisk` | `integer &gt; 0` | `НЕТ` | `` | Квота диска (Указывается в GIGAbytes) | Квота диска (Указывается в GIGAbytes) | minvalue=1; maxvalue=999 | `94` |
| `needExternalAddressMaster` | `boolean` | `ДА` | `` | Выделяет внешний IP для доступа к master | Выделяет внешний IP для доступа к master | value_list=false, true | `147` |
| `needExternalAddressSlave` | `boolean` | `ДА` | `` | Выделяет внешний IP для доступа к slave. Действует, если slave в принципе есть | Выделяет внешний IP для доступа к slave. Действует, если slave в принципе есть | value_list=false, true | `148` |
| `ext_BACKUP_SCHEDULE` | `string` | `НЕТ` | `` | Не обязательный. По умолчанию: &quot;0 * * * *&quot;. Время запуска бекапа | Не обязательный. По умолчанию: &quot;0 * * * *&quot;. Время запуска бекапа | regex=^((((\d+,)+\d+|(\d+(\/|-|#)\d+)|(\d+L?)|(\*(\/\d+)?)|(L(-\d+)?)|(\?)|([A-Z]{3}(-[A-Z]{3})?)) ?){5,7})|(@(annually|yearly|monthly|weekly|daily|hourly|reboot))|(@every (\d+(ns|us|µs|ms|s|m|h))+)$ | `267` |
| `ext_BACKUP_NUM_TO_RETAIN` | `integer &gt; 0` | `НЕТ` | `` | Не обязательный. По умолчанию: &quot;24&quot;. Количество сохраняемых бекапов |  | minvalue=1; maxvalue=99 | `268` |
| `appVersion` | `string` | `ДА` | `` | Версия PostgreSQL. Нельзя опускать вниз |  | value_list=17, 16, 15, 14, 13 | `315` |
| `jsonParameters` | `json` | `НЕТ` | `` | Массив переменных, более подробнее про настройку можно посмотреть https://www.postgresql.org/docs/current/runtime-config.html |  | maxlength=2048 | `316` |
| `enablePgPoolerMaster` | `boolean` | `ДА` | `false` | Включает pgPooler (на запись). Будет создан новый под |  | value_list=false, true | `317` |
| `enablePgPoolerSlave` | `boolean` | `ДА` | `false` | Включает pgPooler (на чтение). Будет создан новый под |  | value_list=false, true | `318` |
| `allowNoSSL` | `boolean` | `ДА` | `false` | По умолчанию подключение обязательное (sslmode=require). Выставление в true отключит этот параметр |  | value_list=false, true | `319` |
| `ipSpaceNameMaster` | `string` | `НЕТ` | `` | Имя ipSpace для публикации VIP master. Не может быть пустым, если включен needExternalAddressMaster |  |  | `541` |
| `ipSpaceNameSlave` | `string` | `НЕТ` | `` | Имя ipSpace для публикации VIP slave. Не может быть пустым, если включен needExternalAddressSlave |  |  | `542` |

## Operation: recovery

| Code | Type | Required | Default | Description | Man | Constraints | ID |
|---|---|---|---|---|---|---|---|
| `resourceInstances` | `integer &gt; 0` | `ДА` | `1` | Количество узлов | Количество узлов в сети<br/> | minvalue=1; maxvalue=7 | `86` |
| `resourceMemory` | `integer &gt; 0` | `ДА` | `512` | Квота памяти пода (Указывается в Megabytes)<br/> | Квота памяти пода (Указывается в Megabytes)<br/> | minvalue=128; maxvalue=8192 | `87` |
| `resourceCPU` | `integer &gt; 0` | `ДА` | `500` | Квота ядра пода (Указывается в mili)<br/> | Квота ядра пода (Указывается в mili)<br/> | minvalue=100; maxvalue=4000 | `88` |
| `resourceDisk` | `integer &gt; 0` | `ДА` | `1` | Квота диска (Указывается в GIGAbytes) | Квота диска (Указывается в GIGAbytes) | minvalue=1; maxvalue=999 | `89` |
| `resourceRealm` | `string` | `ДА` | `` | Платформа для развертывания | Наименование кластера Kubernetes для подключения | func=getAvailableResourceRealms | `131` |

## Operation: restart

None.

## Operation: resume

None.

## Operation: suspend

None.