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,33 @@
+# Resource nubes_s3
+
+Service ID: `12`
+
+Service Name: S3 Object Storage
+
+[Manual](s3.md) | [Create params](s3_params_create.md) | [Modify params](s3_params_modify.md) | [Output params](s3_outputs.md) | [Operations](s3_ops.md) | [Example](s3_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>163</td><td><strong><code class="code-no-wrap">resource_realm</code></strong></td><td></td><td>кластер S3 для подключения</td><td>func=getAvailableResourceRealms</td></tr>
+<tr><td>320</td><td><strong><code class="code-no-wrap">display_name</code></strong></td><td><code>string</code></td><td>Человеко-читаемое имя (транслит из Elma) - передаётся имя клиента</td><td></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>