# 60_reference — справочные материалы

Справочники и внешние факты: состояния инстансов, матрицы переходов, списки API, обзор
универсального ядра. Это не планы и не анализы — это «шпаргалки».

## Файлы

| Файл | Что внутри | Статус |
|---|---|---|
| `INSTANCE_STATES.md` | Матрица состояний ресурсов в облаке ngcloud | ✅ Справочник |
| `STATE_TRANSITIONS.md` | Матрица переходов состояний инстансов ngcloud | ✅ Справочник |
| `apis.txt` | Список API. **В самом файле предупреждение:** старые API закрываются, не использовать для генерации; актуальные — `lk-api-gateway*.ngcloud.ru/api/v1/svc` | ⚠️ Читать с учётом шапки файла |
| `ai_universal_provider_gen.md` | Подробный отчёт по универсальному ядру и генератору ресурсов | ⚠️ Проверить актуальность (описывает общее устройство) |

## Где искать более точные данные

| Нужно | Где |
|---|---|
| Endpoint + токен стенда | `../../TOOLS/config/<стенд>/profile.env` → `NUBES_API_ENDPOINT`, `TOKEN_FILE` |
| Спеки сервисов (операции/параметры/ID) | `../../generated/<стенд>/resources_yaml/<id>_<svc>.yaml` |
| Live-ответы API | `../../HAR/*.har` |
| Залитые версии провайдера | `../../VERSIONS.md` |
| Схема нумерации стендов | `../10_plans/PLAN_FLASH_reversion_cleanup.md` |
| Состояния после `modify` (примеры) | `../30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md` |