add: documentation

2026-06-30 15:45:24 +04:00
parent 540c1f7293
commit ca276d200f
1055 changed files with 47294 additions and 0 deletions
@@ -0,0 +1,34 @@
+# Resource nubes_vapp
+
+Service ID: `26`
+
+Service Name: Виртуальный каталог ВМ (vApp)
+
+[Manual](vapp.md) | [Create params](vapp_params_create.md) | [Modify params](vapp_params_modify.md) | [Output params](vapp_outputs.md) | [Operations](vapp_ops.md) | [Example](vapp_example.md)
+
+## Create params
+
+**Обязательные параметры (вводимые пользователем)**
+
+<table class="resource-table resource-table-compact resource-table-required">
+<thead><tr><th>ID</th><th>Code</th><th>Type</th><th>Description</th><th>Constraints</th></tr></thead>
+<tbody>
+<tr><td>190</td><td><strong><code class="code-no-wrap">nsxt_uid</code></strong></td><td><code>uuid</code></td><td>К какой сети может быть подключен виртуальный каталог</td><td>ref_svc_id=22</td></tr>
+<tr><td>191</td><td><strong><code class="code-no-wrap">vapp_name</code></strong></td><td><code>string</code></td><td>Имеет строгую маску `^[a-z0-9][a-z0-9.-]{3,61}[a-z0-9]$`<br/><br/>Используется в формировании DNS-Имени (для виртуальных машин)</td><td>regex=^[a-z0-9][a-z0-9.-]{3,61}[a-z0-9]$; minlength=3</td></tr>
+<tr><td>623</td><td><strong><code class="code-no-wrap">vdc_uid</code></strong></td><td><code>uuid</code></td><td>В каких ресурсах будет создан виртуальный каталог</td><td>ref_svc_id=21</td></tr>
+</tbody></table>
+
+**Параметры, имеющие значение по умолчанию, если не меняете - эти параметры не обязательно прописывать в манифесте**
+None.
+
+<div class="lifecycle-note">
+<strong>Параметры поведения (кратко)</strong><br/>
+По умолчанию: `suspend_on_destroy = True`, `adopt_existing_on_create = False`.<br/>
+При `terraform destroy` или удалении ресурса из манифеста:<br/>
+- `suspend_on_destroy=true` — инстанс переводится в `Suspend` (не удаляется).<br/>
+- `suspend_on_destroy=false` — Terraform удаляет ресурс только из state.<br/>
+При `apply` флаг `adopt_existing_on_create` работает как авто-`import`:<br/>
+- `false` — если ресурс уже есть, будет ошибка.<br/>
+- `true` — Terraform может взять существующий инстанс под управление (`running` → adopt, `suspended` → resume+adopt при совпадении параметров).<br/>
+Важно: один инстанс должен быть только в одном state. Иначе получите конфликт управления.
+</div>