Files
tf_provider/docs/20_discovery/edge-service.md
T
2026-06-30 15:45:24 +04:00

132 lines
4.3 KiB
Markdown

# Edge Gateway Service
## Обнаружено из HAR: edge.har
Дата: 2026-01-23
## Основная информация
- **Service ID**: 22
- **Service Name**: "Сетевой шлюз периметра (Edge Gateway)"
- **Operation create ID**: 10
## Параметры операции create
### Параметр 8: VDC UUID
- **svcOperationCfsParamId**: 8
- **Описание**: UUID виртуального датацентра
- **Пример значения**: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
- **Тип**: UUID String
- **Обязательный**: Да
### Параметр 340: Unknown boolean
- **svcOperationCfsParamId**: 340
- **Пример значения**: "false"
- **Тип**: Boolean (as string)
### Параметр 341: Edge Count
- **svcOperationCfsParamId**: 341
- **Описание**: Количество Edge Gateway (возможно)
- **Пример значения**: "1"
- **Тип**: Integer (as string)
### Параметр 367: External Network (optional)
- **svcOperationCfsParamId**: 367
- **Пример значения**: "" (пустая строка)
- **Тип**: String
### Параметр 621: Edge Type
- **svcOperationCfsParamId**: 621
- **Пример значения**: "vdc"
- **Тип**: String
### Параметр 622: Unknown (optional)
- **svcOperationCfsParamId**: 622
- **Пример значения**: "" (пустая строка)
- **Тип**: String
## Пример из HAR
```json
// POST /instances
{
"serviceId": 22,
"displayName": "f12vc_nsxt-2",
"descr": ""
}
// POST /instanceOperations
{
"instanceUid": "<instance-uuid>",
"operation": "create"
}
// POST /instanceOperationCfsParams (для каждого параметра)
{
"svcOperationCfsParamId": 8,
"paramValue": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"instanceOperationUid": "<operation-uuid>"
}
{
"svcOperationCfsParamId": 340,
"paramValue": "false",
"instanceOperationUid": "<operation-uuid>"
}
{
"svcOperationCfsParamId": 341,
"paramValue": "1",
"instanceOperationUid": "<operation-uuid>"
}
{
"svcOperationCfsParamId": 367,
"paramValue": "",
"instanceOperationUid": "<operation-uuid>"
}
{
"svcOperationCfsParamId": 621,
"paramValue": "vdc",
"instanceOperationUid": "<operation-uuid>"
}
{
"svcOperationCfsParamId": 622,
"paramValue": "",
"instanceOperationUid": "<operation-uuid>"
}
```
## Связи
## Discovery Recipe (Live API)
Получено из живого API (`/instances/{id}`) 2026-01-26.
### Маппинг имен полей в ID параметров (для Create/Modify)
На основе сопоставления `state.params` (чтение) и `instanceOperationCfsParams` (запись):
| Ключ в API (Read) | ID Параметра (Write) | Описание | Пример |
|-------------------|----------------------|----------|--------|
| `vdcUid` | **8** | UUID родительского VDC | `9b9d79a...` |
| `vdcType` | **621** | Тип родителя (`vdc` / `groupvdc`) | `vdc` |
| `needEnableAVI` | **- (TBD)** | Флаг включения ALB AVI | `true` |
| `virtualServicesCount`| **341 (?)** | Количество виртуальных сервисов | `"2"` |
| `vIPCount` | **-** | Кол-во внешних IP (Public IPs) | `"6"` |
| `ipSpaceName` | **-** | Название IP Space | `internet-v1` |
| `accessIpList` | **-** | Список разрешенных IP (JSON) | `["0.0.0.0/0"]`|
### Выходные атрибуты (Computed)
Объект `state.out`:
- `nsxName`: Название в инфраструктуре NSX-T.
- `vdcName`: Название VDC.
- `routedNet`: Имя созданной routed-сети.
### Жизненный цикл (Live Status)
- `explainedStatus`: "running" (ресурс активен).
- `operationIsInProgress`: `false` (нет активных задач).
- `man`: Содержит разметку Markdown с инструкцией по использованию (можно парсить для документации).
## Примечания
- Параметр 621 со значением "vdc" может указывать на тип Edge Gateway
- Параметры 367 и 622 пустые в этом примере - возможно опциональные
- Параметр 341 = "1" может означать количество Edge Gateway