nubes_vc_org — Организация в Cloud Director

Управляет изолированными организационными единицами (тенантами) в VMware Cloud Director: создание, изменение, предоставление облачных ресурсов и контроль доступа.

Инструкция по сервису Отдельная страница: руководство по сервису.

Специфика Nubes: destroy ≠ удаление terraform destroy по умолчанию усыпляет инстанс (suspend), а не удаляет. Подробности — в разделе «Жизненный цикл» и в общем руководстве «Как работает провайдер».

---

Пример использования

resource "nubes_vc_org" "org" {
  resource_name = "my-org"
  # resource_realm    = "ngcloud.ru" # дефолт
  organization_type = "iaas"               # iaas | saas
}

---

Argument Reference

Имя	Тип	Обязательный	По умолчанию	Описание
resource_name	string	да	—	Имя инстанса
resource_realm	string	нет	ngcloud.ru	Облако, в котором будет развёрнут тенант
organization_type	string	нет	iaas	Тип организации: iaas, saas

v_ipconfigure (через modify)

Имя	Тип	Обязательный	По умолчанию	Описание
name	string	да	—	Имя конфигурации
count	integer	да	—	Количество

Общие атрибуты (есть у всех ресурсов):

Имя	Тип	Обязательный	По умолчанию	Описание
operation_timeout	string	нет	—	Максимальное время ожидания операции
log_level	string	нет	none	Логирование стадий: none, info, debug
suspend_on_destroy	bool	нет	true	При destroy — усыпить вместо удаления
keep_on_destroy	bool	нет	false	При destroy — ничего не делать в облаке (state_only)
adopt_existing_on_create	bool	нет	false	Авто-подхват существующего инстанса при apply

---

Attribute Reference

Имя	Тип	Описание
id	string	UUID инстанса
state_out / state_out_flat	map	Ответ API
state_params / state_params_flat	map	Параметры, отправленные в API
vault_secrets	map (sensitive)	Секреты из Vault
vault_url / vault_user_path	string	Адрес/путь Vault
vault_fields	list	Список доступных ключей секретов

---

Жизненный цикл

Флаг	Дефолт	Поведение при destroy
suspend_on_destroy	true	Инстанс переводится в suspend (не удаляется)
suspend_on_destroy	false	Выполняется операция delete — инстанс удаляется в облаке
keep_on_destroy	false	Если true — ресурс вообще не трогается в облаке (state_only)

Возврат из suspend: повторный terraform apply с adopt_existing_on_create = true — провайдер найдёт инстанс по имени и выполнит resume.

Зачем нужно усыпление suspend — временная остановка: ресурсы высвобождаются, а инстанс можно вернуть в работу в любой момент повторным apply.

Удаление усыплённого инстанса Удалить усыплённый инстанс можно, когда он пробыл в suspend 14 дней.

⚠️ Из Terraform это невозможно — операция delete для усыплённого инстанса недоступна. Удаляйте его вручную в Личном кабинете (ЛК).

• Инстанс в статусе «not created» (после упавшего create) блокирует имя и не удаляется через API — чистится вручную в Личном кабинете.
• reconcile запускается из Terraform ресурсом nubes_service_operation (operation = "reconcile", уникальный run_id).

---

Подресурсы

nubes_vc_org_user

Имя	Тип	Обязательный	По умолчанию	Описание
vc_org_id	string (uuid)	да	—	UUID организации
admins	map (список)	нет	[{}]	Администраторы организации

admins (элемент списка):

Имя	Тип	Обязательный	Описание
email	string	да	Email администратора

Общие атрибуты подресурсов adopt_existing_on_create, keep_on_destroy, skip_missing_on_delete, operation_timeout, log_level.

---

Operations

Операция	Доступно из Terraform	Комментарий
create	✅ apply	Создание организации
modify	✅ apply	Меняется v_ipconfigure
suspend	✅ destroy (при suspend_on_destroy=true)	Усыпление
resume	✅ apply (при adopt_existing_on_create=true)	Пробуждение
delete	✅ destroy (suspend_on_destroy=false)	Удаление инстанса в облаке. Только для работающего (running); усыплённый — вручную в ЛК
create_user / delete_user	✅ через nubes_vc_org_user	Управление пользователями
reconcile	✅ через nubes_service_operation	Синхронизация состояния (универсальная операция)

See the Terraform Registry attribute reference.