diff --git a/06.01.05-Data-%D1%84%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D1%8F-decort_account-%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%B8-%D0%BE%D0%B1-%D0%B0%D0%BA%D0%BA%D0%B0%D1%83%D0%BD%D1%82%D0%B5.md b/06.01.05-Data-%D1%84%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D1%8F-decort_account-%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%B8-%D0%BE%D0%B1-%D0%B0%D0%BA%D0%BA%D0%B0%D1%83%D0%BD%D1%82%D0%B5.md new file mode 100644 index 0000000..9b2f4be --- /dev/null +++ b/06.01.05-Data-%D1%84%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D1%8F-decort_account-%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%B8-%D0%BE%D0%B1-%D0%B0%D0%BA%D0%BA%D0%B0%D1%83%D0%BD%D1%82%D0%B5.md @@ -0,0 +1,118 @@ +Функция доступна в провайдере версии 2.3 и выше. + +_Data source_ функция **decort_account** служит для получения информации об аккаунте. + +## Аргументы +_Data source_ функция **decort_account** принимает следующие аргументы: +| Аргумент | Тип | Обязательный | Описание | +| --- | --- | --- | --- | +| account_id | int | :heavy_check_mark: | ID аккаунте | + + +## Возвращаемые значения +В случае успешного выполнения _data source_ функция **decort_account** возвращает следующие параметры: + +| Параметр | Тип | Описание | +| --- | --- | --- | +| account_id | int | ID аккаунта | +| account_name | string | Название аккаунта | +| meta | []string | Мета информация | +| resources | Struct{} [см. ниже](#описание-структуры-resources)| Информация о ресурсах | +| acl | []Struct{} [см. ниже](#описание-структуры-acl)| Более подробная информация об аккаунтах | +| company | string | Название компании, которой принадлежит аккаунт | +| companyurl | string | url-адрес компани | +| created_by | string | Пользователь - создателя аккаунта | +| created_time | int | Время создания аккаунта | +| deactivation_time | float | Время деактивации аккаунта | +| deleted_by | string | Пользователь, удаливший аккаунт | +| deleted_time | int | Время удаления аккаунта | +| displayname | string | Отображаемое имя аккаунта | +| guid | int | Внутренний guid аккаунта | +| resource_limits | Struct{} [см. ниже](#описание-структуры-resource_limits)| Ограничения ресурсов| +| send_access_emails | bool | Флаг, отправлять ли на указанную почту письмо о доступе | +| service_account | bool | Флаг, является ли аккаунт аккаунтом-обслуживания | +| status | string | Статус аккаунта | +| updated_time | int | Время последнего обновления | +| version | int | Версия аккаунта | +| vins | []int | Список id виртуальных сетей | +| vinses | []int | Список id виртуальных сетей | +| cpu_allocation_parameter | string | Параметр выделения CPU | +| cpu_allocation_ratio | float | Отношение выделения CPU | +| computes | Struct{} [см .ниже](#описание-структуры-computes)| Информация о вычислительных мощностях| +| machines | Struct{} [см .ниже](#описание-структуры-machines)| Информация о виртуальных машинах (устаревшее)| + +### Описание структуры resources +| Параметр | Тип | Описание | +| --- | --- | --- | +| current | Struct{} [см. ниже](#описание-структуры-current) | Информация о текуших ресурсах | +| reserved | Struct{} [см. ниже](#описание-структуры-reserved) | Информация о зарезверированных аккаунтом ресурсах | + +### Описание структуры acl +| Параметр | Тип | Описание | +| --- | --- | --- | +| can_be_deleted | bool | Может ли быть удален | +| explicit | bool | Видимость аккаунта | +| guid | string | GUID | +| right | string | Права | +| status | string | Статус | +| type | string | Тип | +| user_group_id | string | ID группы юзеров | + +### Описание структуры resource_limits +| Параметр | Тип | Описание | +| --- | --- | --- | +| cu_c | float | Количество ядер CPU | +| cu_d | float | Размер диска | +| cu_i | float | Количество публичных IP адресов | +| cu_m | float | размер RAM | +| cu_np | float | Хранилище траффика | +| gpu_units | float | количество GPU ядер | + +### Описание структуры computes +| Параметр | Тип | Описание | +| --- | --- | --- | +| started | int | Количество запущенных ВМ | +| stopped | int | Количество остановленных ВМ | + +### Описание структуры machines +| Параметр | Тип | Описание | +| --- | --- | --- | +| halted | int | Количество остановленных ВМ | +| running | int | Количество запущенных ВМ | + +### Описание структуры current и reserved +| Параметр | Тип | Описание | +| --- | --- | --- | +| cpu | int | Количество CPU | +| disksize | int | Размер диска | +| extips | int | Внешние IPs | +| exttraffic | int | Внешний Traffic | +| gpu | int | Количество GPU | +| ram | int | Количество RAM | +| seps | []Struct{} [см . ниже](#описание-структуры-seps)| Информация о seps | + +### Описание структуры seps +| Параметр | Тип | Описание | +| --- | --- | --- | +| sep_id | int | ID SEP | +| data_name | string | Имя пула информации внутри SEP'а | +| disk_size | int | Количество занятого места | +| disk_size_max | int | Размер диска | + +## Пример использования +Пример вызова _data source_ функции **decort_account**: +```terraform +data "decort_account" "a" { + #id аккаунта + #обязательный параметр + #тип - число + account_id = 28096 + +} +# once the above directive completes, account will be accessible +# as data.decort_account.a +``` + +Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)). + +После успешного завершения такого вызова **decort_account** в переменной `data.decort_account.a` будут сохранены возвращаемые значения.