name: vc_org service_id: 19 service_display_name: Организация в Cloud Director service_short_name: vcOrg service_man: '# Инструкция по развертыванию Организация в Cloud Director через платформу

## 1. Общая информация

Сервис **Организация в Cloud Director** предназначен для управления изолированными организационными единицами (тенантами) внутри инфраструктуры Cloud Director. Он обеспечивает создание, модификацию и администрирование организаций, предоставление им облачных ресурсов, а также контроль уровня доступа. Сервис используется для организации рабочих окружений потребителей, управления жизненным циклом организаций и их сетевой инфраструктурой.

### Доступные операции

**create** — Создание новой организации с заданными характеристиками и типом доступа.
**delete** — Удаление организации после перехода в состояние suspend; приводит к удалению всех связанных сущностей.
**modify** — Изменение параметров внутри организации (на текущий момент поддерживается изменение ipSpaces).
**suspend** — Заморозка организации, ограничение возможности изменения и добавления сущностей.
**resume** — Разморозка организации, восстановление функций управления.

---

## 2. Параметры развертывания

Параметры входных данных операции **create**:

### Платформа для развертывания
Описание: платформа, на которой будет создана организация.
Пример значения: `ngcloud.ru`.

### Тип организации
Описание: тип создаваемой организации.
Варианты:
- `iaas` — организация с прямым доступом к облаку и авторизацией через Keycloak.
- `saas` — организация под управлением Nubes, без прямого доступа к облаку.

---

## 3. Рекомендованные характеристики

### Тестовое окружение
- Тип организации: `iaas` для обеспечения полного доступа к облачным ресурсам и самостоятельного управления.

### Промышленное окружение
- Тип организации: `saas` (упрощённая модель использования).

---

## 4. Выходные параметры

Услуга предоставляет следующие выходные параметры (формируются в процессе операций):

### Url организации
Для быстрого доступа в тенант

### Статус организации
Отражает текущее состояние и параметры.

---

## 5. Дополнительная информация

- Для конфигурации внешних IP внутри организации необходимо предварительно создать:
-- хотя бы один **Виртуальный датацентр (VDC)** привязанный к этой организации;
-- хотя бы один **Сетевой шлюз периметра (Edge Gateway)**, привязанный к vdc выше.
- Удаление организации возможно только через 14 дней после перевода в состояние suspend.
- Удаление организации приводит к удалению всех связанных сущностей: VDC, Edge Gateway, пулов IP, сетей, ВМок и иных объектов.
- Операция suspend не останавливает виртуальные машины, но блокирует любые изменения инфраструктуры внутри организации.
- Для iaas-организаций доступ осуществляется через Keycloak.' lifecycle: suspendOnDestroyDefault: true adoptExistingOnCreateDefault: false operations: - svcOperationId: 136 operation: create kind: instance action: create - svcOperationId: 283 operation: create_user kind: subresource action: create - svcOperationId: 137 operation: delete kind: instance action: delete - svcOperationId: 284 operation: delete_user kind: subresource action: delete - svcOperationId: 207 operation: modify kind: instance action: modify - svcOperationId: 249 operation: reconcile kind: action action: reconcile - svcOperationId: 144 operation: resume kind: instance action: resume - svcOperationId: 143 operation: suspend kind: instance action: suspend stateOut: users: {} cfsParams: - svcOperationCfsParamId: 418 svcOperationCfsParam: resourceRealm dataType: string isRequired: true defaultValue: ngcloud.ru isModifiable: false valueList: - ngcloud.ru - svcOperationCfsParamId: 556 svcOperationCfsParam: organizationType dataType: string isRequired: true defaultValue: iaas isModifiable: false valueList: - iaas - saas - svcOperationCfsParamId: 871 svcOperationCfsParam: admins dataType: array-map-fixed isRequired: true defaultValue: '[{}]' isModifiable: false dataDescriptor: email: dataType: string defaultValue: '' isRequired: true isModifiable: false - svcOperationCfsParamId: 872 svcOperationCfsParam: admins dataType: array-map-fixed isRequired: true defaultValue: '' isModifiable: true dataDescriptor: email: dataType: string defaultValue: '' isRequired: true isModifiable: false - svcOperationCfsParamId: 662 svcOperationCfsParam: vIPConfigure dataType: array-map-fixed isRequired: true defaultValue: '' isModifiable: true dataDescriptor: name: dataType: string defaultValue: '' isRequired: true isModifiable: false count: dataType: integer > 0 defaultValue: '' isRequired: true isModifiable: false cfsParamsByOp: 136: - 418 - 556 283: - 871 137: [] 284: - 872 207: - 662 249: [] 144: [] 143: [] stateParams: resourceRealm: ngcloud.ru organizationType: iaas