add: documentation

docs/20_discovery/resource_realms_available.md

@@ -0,0 +1,22 @@
+# Resource Realm: универсальное определение через API
+
+## Зачем это нужно
+Для некоторых сервисов (`dummy` и др.) при создании требуется `resource_realm`. Чтобы не хардкодить значения, realm нужно получать из API по `svcId`.
+
+## Универсальный метод (для всех сервисов)
+Используется общий эндпойнт:
+
+```
+GET /api/v1/index.cfm?endpoint=/resourceRealms/available&svcId=<serviceId>
+```
+
+- Возвращает доступные realm для сервиса в поле `results`.
+- Пример: `svcId=1` (dummy) → `results = "dummy"`.
+
+## Практика
+1. Определить `serviceId` ресурса.
+2. Запросить `/resourceRealms/available&svcId=<serviceId>`.
+3. Использовать значение `results` как `resource_realm` в Terraform.
+
+## Важно
+Это **универсальный** способ (не только для dummy) и должен применяться во всех случаях, когда нужен `resource_realm`.