diff --git a/07.01.11-Resource-функция-decort_account-управление-аккаунтом.md b/07.01.11-Resource-функция-decort_account-управление-аккаунтом.md index 4f1c3aa..86c6281 100644 --- a/07.01.11-Resource-функция-decort_account-управление-аккаунтом.md +++ b/07.01.11-Resource-функция-decort_account-управление-аккаунтом.md @@ -11,13 +11,30 @@ _Resource_ функция **decort_account** принимает следующи | username | string | :heavy_check_mark: | Имя пользователя - владельца аккаунта
Используется при создании | | emailaddress | string | :x: | Адрес электронной почты
Используется при создании | | send_access_emails | bool | :x: | Флаг отправки электронного письма
Используется при создании и редактировании
По-умолчанию: true | -| resource_limits | Struct{
cu_c float
cu_d float
cu_i float
cu_m float
cu_np float
gpu_units float
}
 
 
 
| :x: | Ресурсы аккаунта
Кол-во ядер
Размер диска, ГБ
Кол-во публичных ip-адресов
Размер RAM, МБ
Кол-во переданных данных, в ГБ
Кол-во графических процессоров
 
Используется при создании и редактировании аккаунта
По-умолчанию, все ресурсы выставлены в -1, что обозначает их использование без ограничений.
Значение 0 недопустимо. Должен быть использован хотя бы минимальные экземпляр ресурса. | +| resource_limits | Struct{} [см. ниже](#Описание-структуры-resource_limits) | :x: | Ресурсы аккаунта | | enable | bool | :x: | Флаг доступности аккаунта
Используется при редактировании | | restore | bool | :x: | Флаг восстановления аккаунта
Используется при редактировании | -| users | []Struct{
user_id string
access_type string
recursive_delete bool
} | :x: | Добавление/удаление пользователей в аккаунт
ID пользователя(его имя)
Тип доступа пользователя. R - чтение, RCX - запись, ARCXDU - админ
Флаг рекурсивного удаления пользователя
 
| +| users | []Struct{} [см. ниже](#Описание-структуры-users) | :x: | Поле для того чтобы задать пользователей | | permanently | bool | :x: | Флаг удаления аккаунта
Если выставлен в true, то аккаунт и все с ним связанное удаляется моментально
Если false - то аккаунт попадает в "корзину", где хранится некоторое время. Из "корзины" аккаунт можно восстановить
По-умолчанию: false
Используется при удалении | | account_id | int | :x: | ID аккаунта, используется для формирования .tfstate, если аккаунт уже был создан в платформе
Может использоваться при создании аккаунта | +### Описание структуры resource_limits +| Аргумент | Тип | Обязательный | Описание | +| --- | --- | :---: | --- | +| cu_c | float | :x: | Количество ядер CPU | +| cu_d | float | :x: | Размер диска | +| cu_i | float | :x: | Количество публичных IP адресов | +| cu_m | float | :x: | размер RAM | +| cu_np | float | :x: | Хранилище траффика | +| gpu_units | float | :x: | количество GPU ядер | + +### Описание структуры users +| Аргумент | Тип | Обязательный | Описание | +| --- | --- | :---: | --- | +| user_id | string | :heavy_check_mark: | ID пользователя(его имя) | +| access_type | string | :heavy_check_mark: | Тип доступа пользователя. R - чтение, RCX - запись, ARCXDU - админ | +| recursive_delete | bool | :x: | Флаг рекурсивного удаления пользователя | + ## Возвращаемые значения В случае успешного выполнения _resource_ функция **decort_account** возвращает в указанную при вызове переменную элемент, который состоит из следующих параметров: @@ -26,8 +43,8 @@ _Resource_ функция **decort_account** принимает следующи | account_id | int | ID аккаунта | | account_name | string | Название аккаунта | | meta | []string | Мета информация | -| resources | Struct{
current Struct{
cpu int
disksize int
extips int
exttraffic int
gpu int
ram int
}
reserved Struct{
cpu int
disksize int
extips int
exttraffic int
gpu int
ram int
}
} | Информация о ресурсах
Задействованные
Кол-вол ядер
Размер диска, ГБ
Кол-во внешних ip-адресов
Размер внешнего траффика
Кол-во графических ядер
Размер RAM, MБ

Зарезервированные
Кол-вол ядер
Размер диска, ГБ
Кол-во внешних ip-адресов
Размер внешнего траффика
Кол-во графических ядер
Размер RAM, MБ

 
| -| acl | []Struct{
can_be_deleted bool
explicit bool
guid string
right string
status string
type string
user_group_id string
} | Более подробная информация об аккаунтах
Может ли быть удален аккаунт
Явно ли указан доступ
guid аккаунта
Права доступа
Статус аккаунта
Тип аккаунта
Идентификатор пользователя-владельца аккаунта
 
| +| resources | Struct{} [см. ниже](#Описание-структуры-resources)| Информация о ресурсах | +| acl | []Struct{} [см. ниже](#Описание-структуры-acl)| Более подробная информация об аккаунтах | | company | string | Название компании, которой принадлежит аккаунт | | companyurl | string | url-адрес компани | | created_by | string | Пользователь - создателя аккаунта | @@ -37,7 +54,7 @@ _Resource_ функция **decort_account** принимает следующи | deleted_time | int | Время удаления аккаунта | | displayname | string | Отображаемое имя аккаунта | | guid | int | Внутренний guid аккаунта | -| resource_limits | Struct{
cu_c float
cu_d float
cu_i float
cu_m float
cu_np float
gpu_units float
} | Ограничения ресурсов
Кол-во ядер
Размер диска, ГБ
Число публичных ip адресов
Размер RAM, МБ
Объем трафика, ГБ
Кол-вол графических ядер
 
| +| resource_limits | Struct{} [см. ниже](#Описание-структуры-resource_limits)| Ограничения ресурсов| | send_access_emails | bool | Флаг, отправлять ли на указанную почту письмо о доступе | | service_account | bool | Флаг, является ли аккаунт аккаунтом-обслуживания | | status | string | Статус аккаунта | @@ -45,8 +62,66 @@ _Resource_ функция **decort_account** принимает следующи | version | int | Версия аккаунта | | vins | []int | Список id виртуальных сетей | | vinses | []int | Список id виртуальных сетей | -| computes | Struct{
started int
stopped int
} | Информация о вычислительных мощностях
Кол-во запущенных
Кол-во остановленных
 
| -| machines | Struct{
halted int
running int
} | Информация о виртуальных машинах (устаревшее)
Кол-во запущенных
Кол-во остановленных
 
| +| computes | Struct{} [см .ниже](#Описание-структуры-computes)| Информация о вычислительных мощностях| +| machines | Struct{} [см .ниже](#Описание-структуры-machines)| Информация о виртуальных машинах (устаревшее)| + +### Описание структуры resources +| Параметр | Тип | Описание | +| --- | --- | --- | +| current | Struct{} [см. ниже](#Описание-структуры-current) | Информация о текуших ресурсах | +| reserved | Struct{} [см. ниже](#Описание-структуры-reserved) | Информация о зарезверированных аккаунтом ресурсах | + +### Описание структуры acl +| Параметр | Тип | Описание | +| --- | --- | --- | +| can_be_deleted | bool | Может ли быть удален | +| explicit | bool | Explicit | +| guid | string | GUID | +| right | string | Right | +| 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 | External IPs | +| exttraffic | int | External 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 | Размер диска | @@ -181,4 +256,4 @@ resource "decort_account" "a" { Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://github.com/rudecs/terraform-provider-decort/wiki/05.-%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-Terraform-%D0%BF%D1%80%D0%BE%D0%B2%D0%B0%D0%B9%D0%B4%D0%B5%D1%80%D0%B0-DECORT.)). -После успешного завершения такого вызова **decort_account** в переменной `decort_account.a` будут сохранены возвращаемые значения. \ No newline at end of file +После успешного завершения такого вызова **decort_account** в переменной `decort_account.a` будут сохранены возвращаемые значения.