diff --git a/06.01.05-Data-функция-decort_account-получение-информации-об-аккаунте.md b/06.01.05-Data-функция-decort_account-получение-информации-об-аккаунте.md index f8faee5..1152ead 100644 --- a/06.01.05-Data-функция-decort_account-получение-информации-об-аккаунте.md +++ b/06.01.05-Data-функция-decort_account-получение-информации-об-аккаунте.md @@ -1,13 +1,11 @@ -_Data source_ функция **decort_account** служит для получения информации о подписчике ("account"), к ресурсам которого имеет доступ данный пользователь. Основной сценарий применения данной функции - получить цифровой идентификатор подписчика по его имени, чтобы в дальнейшем использовать этот идентификатор для управления ресурсами. +_Data source_ функция **decort_account** служит для получения информации об аккаунте. ## Аргументы -**Внимание:** в качестве параметра должен быть **обязательно** передан хотя бы один из аргументов. -_Data source_ функция **decort_account** принимает следующие аргументы: +_Data source_ функция **decort_account** приниает следующие аргументы: | Аргумент | Тип | Обязательный | Описание | | --- | --- | --- | --- | -| name | string | :x: | Имя подписчика, по которому требуется получить информацию. Имя не может быть пустым.
Вы можете задать или `account_id`, или `name`. Если задан параметр `account_id`, то параметр `name` игнорируется. | -| account_id | int | :x: | Идентификатор подписчика, по которому требуется получить информацию. Не может быть нулевым.
Если задан данный параметр, то параметр `name` игнорируется. | +| account_id | int | :heavy_check_mark: | Идентификатор аккаунта | Пользователь облачной платформы, от лица которого происходит обращение к данной функции, должен иметь доступ к указанному `account`. В противном случае возникнет ошибка доступа. @@ -18,21 +16,42 @@ _Data source_ функция **decort_account** принимает следую | Параметр | Тип | Описание | | --- | --- | --- | -| account_id | int | Уникальный идентификатор подписчика. | -| account_name | string | Имя подписчика. | -| status | string | Текущий статус подписчика. | +| 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 аккаунта
Права доступа
Статус аккаунта
Тип аккаунта
Идентификатор пользователя-владельца аккаунта
 
| +| 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{
cu_c float
cu_d float
cu_i float
cu_m float
cu_np float
gpu_units float
} | Ограничения ресурсов
Кол-во ядер
Размер диска, ГБ
Число публичных ip адресов
Размер RAM, МБ
Объем трафика, ГБ
Кол-вол графических ядер
 
| +| send_access_emails | bool | Флаг, отправлять ли на указанную почту письмо о доступе | +| service_account | bool | Флаг, является ли аккаунт аккаунтом-обслуживания | +| status | string | Статус аккаунта | +| updated_time | int | Время последнего обновления | +| version | int | Версия аккаунта | +| vins | []int | Список id виртуальных сетей | +| vinses | []int | Список id виртуальных сетей | +| computes | Struct{
started int
stopped int
} | Информация о вычислительных мощностях
Кол-во запущенных
Кол-во остановленных
 
| +| machines | Struct{
halted int
running int
} | Информация о виртуальных машинах (устаревшее)
Кол-во запущенных
Кол-во остановленных
 
| ## Пример использования Пример вызова _data source_ функции **decort_account**: ```terraform data "decort_account" "my_account" { - name = "MyAccount" # this is the name of the account, which ID we want to get + account_id = 1111 } -# Once the above directive completes, accountID will be accessible as -# data.decort_account.my_account.id +# Once the above directive completes, account will be available to +# data.decort_account.my_account ``` Данный пример подразумевает, что ранее по тексту 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.) и [пример](https://github.com/rudecs/terraform-provider-decort/wiki/02.-%D0%9A%D0%BE%D1%80%D0%BE%D1%87%D0%B5,-%D0%A1%D0%BA%D0%BB%D0%B8%D1%84%D0%BE%D1%81%D0%BE%D1%84%D1%81%D0%BA%D0%B8%D0%B9!)). -После успешного завершения такого вызова **decort_account** в переменной `data.decort_account.my_account` будут сохранены возвращаемые значения. В частности, для получения идентификатора подписчика следует использовать конструкцию `data.decort_account.my_account.id` \ No newline at end of file +После успешного завершения такого вызова **decort_account** в переменной `data.decort_account.my_account` будут сохранены возвращаемые значения. \ No newline at end of file