<!-- ⛔ LEGACY: deck-api.ngcloud.ru ЗАКРЫВАЕТСЯ. Актуальный API: lk-api-gateway.ngcloud.ru/api/v1/svc -->
# СУПЕРглоссарий (словарь с ссылками)

Каждый термин содержит ссылки на места употребления в документации.

## Русские термины
- Семишаговый цикл создания ресурса — базовый жизненный цикл create/run.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L3)

- Параметры операции (CFS) — список параметров, получаемый из операции.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L18), [docs/40_analysis/har/discovery/service_parameters_fetch.md](docs/40_analysis/har/discovery/service_parameters_fetch.md#L20)

- Прокси-эндпойнт /index.cfm?endpoint=... — рекомендуемый доступ к API.
  - Ссылки: [docs/40_analysis/har/discovery/service_parameters_fetch.md](docs/40_analysis/har/discovery/service_parameters_fetch.md#L6)

- Валидация параметров (validate-cfs) — проверка параметров перед запуском.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L27), [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#L27)

- Запуск операции (run) — финальный шаг, без него ресурс остаётся not created.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L31)

- Поллинг операций — ожидание завершения по dtFinish.
  - Ссылки: [docs/20_discovery/tubulus_and_polling_logic.md](docs/20_discovery/tubulus_and_polling_logic.md#L16-L25)

- Ошибка VM на FW-стадии — сбой применения правил firewall.
  - Ссылки: [docs/20_discovery/vm_provisioning_failures.md](docs/20_discovery/vm_provisioning_failures.md#L28)

- Валидация JSON-массивов в VM — защита от пустых строк/невалидного JSON.
  - Ссылки: [docs/50_history/12_vm_resource_hardening.md](docs/50_history/12_vm_resource_hardening.md#L44-L52)

- Импорт ресурса (terraform import) — поддержка существующих ресурсов.
  - Ссылки: [docs/50_history/11_postgres_import_implementation.md](docs/50_history/11_postgres_import_implementation.md#L17-L19)

- Ошибка подписи “unknown issuer” — несовпадение ключей подписи.
  - Ссылки: [docs/20_discovery/troubleshooting_gpg_and_registry.md](docs/20_discovery/troubleshooting_gpg_and_registry.md#L7)

- Ошибка подписи “openpgp invalid data” — неверный формат .sig.
  - Ссылки: [docs/20_discovery/troubleshooting_gpg_and_registry.md](docs/20_discovery/troubleshooting_gpg_and_registry.md#L16)

- Proxy mode для скачивания артефактов — обход проблем presigned URL.
  - Ссылки: [docs/50_history/02_registry_protocol_fix.md](docs/50_history/02_registry_protocol_fix.md#L41)

- Миграция на S3 — переход переменных окружения.
  - Ссылки: [docs/50_history/09_s3_migration_and_branded_docs.md](docs/50_history/09_s3_migration_and_branded_docs.md#L13)

- MkDocs — сборка статической документации.
  - Ссылки: [docs/20_discovery/documentation_build_and_deploy.md](docs/20_discovery/documentation_build_and_deploy.md#L10-L11)

- Хранилище документации (terraform-registry) — S3 бакет для docs.
  - Ссылки: [docs/20_discovery/s3-storage-and-docs-architecture.md](docs/20_discovery/s3-storage-and-docs-architecture.md#L15)

- Проблема доступа к внешнему Gitea (gitea.services.ngcloud.ru) — деплой падает, в то время как зеркало на собственном Gitea работает.
  - Ссылки: [docs/20_discovery/session_report_2026-02-13.md](docs/20_discovery/session_report_2026-02-13.md)

- Полный дамп параметров API (test) — эталонная выгрузка всех операций и параметров для проверки универсального генератора YAML.
  - Ссылки: [docs/20_discovery/api_meta_test_dump.md](docs/20_discovery/api_meta_test_dump.md)

## A
- `access_ip_list` — параметр VM, список IP в формате JSON-массива.
  - Ссылки: [docs/50_history/12_vm_resource_hardening.md](docs/50_history/12_vm_resource_hardening.md#L99)

- `access_port_list` — параметр VM, список портов в формате JSON-массива.
  - Ссылки: [docs/50_history/12_vm_resource_hardening.md](docs/50_history/12_vm_resource_hardening.md#L92)

- `authentication signature from unknown issuer` — ошибка подписи провайдера при `terraform init`.
  - Ссылки: [docs/20_discovery/troubleshooting_gpg_and_registry.md](docs/20_discovery/troubleshooting_gpg_and_registry.md#L7), [docs/50_history/02_registry_protocol_fix.md](docs/50_history/02_registry_protocol_fix.md#L9)

## C
- `cfsParams` — список параметров операции, получаемый из manifest операции.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L18), [docs/40_analysis/har/discovery/service_parameters_fetch.md](docs/40_analysis/har/discovery/service_parameters_fetch.md#L20)

- `checkParam` — функция бэкенда, фигурирует в ошибках VM при типовых несоответствиях.
  - Ссылки: [docs/20_discovery/vm_provisioning_failures.md](docs/20_discovery/vm_provisioning_failures.md#L16)

- `Confidence Scores` — требование стратегии: маркировать уверенность в выводах.
  - Ссылки: [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#L30)

## D
- `suspend_on_destroy` — флаг destroy-поведения для сервисов с `suspend`: `true` -> suspend, `false` -> удаление только из state.
  - Ссылки: [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#L73-L78)

- `dtFinish` — единственный надёжный индикатор завершения операции.
  - Ссылки: [docs/20_discovery/tubulus_and_polling_logic.md](docs/20_discovery/tubulus_and_polling_logic.md#L16-L19)

## E
- `Early Termination` — стратегия раннего остановa плана при логической некорректности.
  - Ссылки: [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#L16)

- `error checking signature: openpgp: invalid data` — ошибка формата подписи.
  - Ссылки: [docs/20_discovery/troubleshooting_gpg_and_registry.md](docs/20_discovery/troubleshooting_gpg_and_registry.md#L16)

- `explainedStatus` — статус инстанса при polling.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L37)

## G
- `GPG` — подпись артефактов провайдера.
  - Ссылки: [docs/50_history/02_registry_protocol_fix.md](docs/50_history/02_registry_protocol_fix.md#L13), [docs/20_discovery/troubleshooting_gpg_and_registry.md](docs/20_discovery/troubleshooting_gpg_and_registry.md#L5)

## I
- `ImportState` — реализация `terraform import` для PostgreSQL.
  - Ссылки: [docs/50_history/11_postgres_import_implementation.md](docs/50_history/11_postgres_import_implementation.md#L17-L19)

- `instance` — экземпляр сервиса в Nubes.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L8)

- `instanceOperation` — асинхронная операция над instance (create/modify/delete/suspend/resume).
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L13), [docs/20_discovery/tubulus_and_polling_logic.md](docs/20_discovery/tubulus_and_polling_logic.md#L14)

- `instanceOperationCfsParams` — эндпойнт для отправки параметров операции.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L22)

- `isSuccessful` — признак успеха операции после завершения.
  - Ссылки: [docs/20_discovery/tubulus_and_polling_logic.md](docs/20_discovery/tubulus_and_polling_logic.md#L22-L25)

## M
- `mkdocs` — инструмент сборки документации.
  - Ссылки: [docs/20_discovery/documentation_build_and_deploy.md](docs/20_discovery/documentation_build_and_deploy.md#L10)

- `S3_*` — переменные окружения для хранилища.
  - Ссылки: [docs/50_history/09_s3_migration_and_branded_docs.md](docs/50_history/09_s3_migration_and_branded_docs.md#L13)

## P
- `param-value-list` — эндпойнт для списков значений параметров.
  - Ссылки: [docs/40_analysis/har/discovery/service_parameters_fetch.md](docs/40_analysis/har/discovery/service_parameters_fetch.md#L21)

- `proxy mode` — режим проксирования скачивания артефактов registry.
  - Ссылки: [docs/50_history/02_registry_protocol_fix.md](docs/50_history/02_registry_protocol_fix.md#L41)

- `publish-docs.sh` — скрипт публикации документации.
  - Ссылки: [docs/20_discovery/documentation_build_and_deploy.md](docs/20_discovery/documentation_build_and_deploy.md#L33-L39)

## R
- `resource_realm` — фиксируемый/скрываемый параметр ресурса в генерации.
  - Ссылки: [docs/20_discovery/development-journey.md](docs/20_discovery/development-journey.md#L31)

- `adopt_existing_on_create` — явное разрешение adopt/import при найденном `running` ресурсе.
  - Ссылки: [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#L60-L71)

- `run` — финальный запуск операции после validate.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L31)

## S
- `serviceOperation` — описание операции сервиса.
  - Ссылки: [docs/40_analysis/har/discovery/service_parameters_fetch.md](docs/40_analysis/har/discovery/service_parameters_fetch.md#L20)

- `services/{svcId}` — получение информации о сервисе.
  - Ссылки: [docs/40_analysis/har/discovery/service_parameters_fetch.md](docs/40_analysis/har/discovery/service_parameters_fetch.md#L19)

- `signing_keys` — массив GPG ключей в DownloadResponse.
  - Ссылки: [docs/50_history/02_registry_protocol_fix.md](docs/50_history/02_registry_protocol_fix.md#L42)

- `Strict Branding` — стандарт оформления документации.
  - Ссылки: [docs/20_discovery/s3-storage-and-docs-architecture.md](docs/20_discovery/s3-storage-and-docs-architecture.md#L12)

- `String[] to GUID` — ошибка VM при неверных типах параметров.
  - Ссылки: [docs/20_discovery/vm_provisioning_failures.md](docs/20_discovery/vm_provisioning_failures.md#L8)

- `svcOperationCfsParamId` — ID параметра операции (различается для create/modify).
  - Ссылки: [docs/50_history/06_postgres_update_and_immutable_params.md](docs/50_history/06_postgres_update_and_immutable_params.md#L12)

## T
- `terraform-registry` — S3 bucket для документации.
  - Ссылки: [docs/20_discovery/s3-storage-and-docs-architecture.md](docs/20_discovery/s3-storage-and-docs-architecture.md#L15)

- `TLS handshake timeout` — типовой сетевой сбой.
  - Ссылки: [docs/50_history/06_postgres_update_and_immutable_params.md](docs/50_history/06_postgres_update_and_immutable_params.md#L39)

## V
- `ValidJSONArray` — валидатор JSON‑массивов для VM параметров.
  - Ссылки: [docs/50_history/12_vm_resource_hardening.md](docs/50_history/12_vm_resource_hardening.md#L44-L52)

- `validate-cfs` — валидация параметров операции перед run.
  - Ссылки: [docs/20_discovery/resource-creation-pattern.md](docs/20_discovery/resource-creation-pattern.md#L27), [docs/60_strategy/provider_philosophy.md](docs/60_strategy/provider_philosophy.md#L27)

## W
- `WaitForOperation` — ожидание завершения операции по opUid.
  - Ссылки: [docs/50_history/07_operation_based_polling_and_negative_testing.md](docs/50_history/07_operation_based_polling_and_negative_testing.md#L12)

- `waitForVMOperationAndInstanceStatus` — VM‑метод поллинга с проверкой ERROR/STOPPED.
  - Ссылки: [docs/50_history/04_vm_hang_fix_and_500_error.md](docs/50_history/04_vm_hang_fix_and_500_error.md#L17-L19)

## Z
- `Zero-Logic Pathing` — прямое проксирование запросов документации в S3.
  - Ссылки: [docs/20_discovery/s3-storage-and-docs-architecture.md](docs/20_discovery/s3-storage-and-docs-architecture.md#L15)