terraform-provider-dynamix/wiki/1.2.0/06.01.12-Data_dynamix_rg_list.md

Data source функция dynamix_rg_list служит для получения информации об имеющихся ресурсных группах.

Аргументы

Data source функция dynamix_rg_list принимает следующие аргументы:

Аргумент	Тип	Обязательный	Описание
by_id	int	❌	Фильтр по ID
name	string	❌	Фильтр по названию
account_id	int	❌	Фильтр по ID аккаунта
account_name	string	❌	Фильтр по имени аккаунта
created_after	int	❌	Отдает все рес. группы созданные после определенного времени (unix timstamp)
created_before	int	❌	Отдает все рес. группы созданные до определенного времени (unix timstamp)
status	string	❌	Фильтр по статусу
lock_status	string	❌	Фильтр по локстатусу
includedeleted	bool	❌	Включение удаленных rg в результат поиска
sort_by	string	❌	Фильтр по одному из поддерживаемых полей, формат: +или- название поля
page	int	❌	Номер страниц
size	int	❌	Размер страницы

Возвращаемые значения

В случае успешного выполнения data source функция dynamix_rg_list возвращает в указанную при вызове переменную, в поле items массив, каждый элемент которого состоит из следующих параметров:

Параметр	Тип	Описание
account_id	int	ID аккаунта - владельца ресурсной группы
account_name	string	Имя аккаунта - владельца ресурсной группы
compute_features	[]string	Доступ к дополнительным функциям управления ВМ
acl	[]Struct{ explicit bool guid string right string status string type string user_group_id string }	Более подробная информация об аккаунтах, имеющих доступ к ресурсной группе Явно ли указан доступ guid аккаунта Права доступа Статус аккаунта Тип аккаунта Идентификатор пользователя-владельца аккаунта
cpu_allocation_parameter	string	Параметр выделения CPU
cpu_allocation_ratio	float	Отношение выделения CPU
created_by	string	Информация о создателе группы
created_time	int	Время создания группы
def_net_id	int	id сети по-умолчанию
def_net_type	string	Тип сети по-умолчанию
deleted_by	string	Информация о том, кто удалил группу
deleted_time	int	Время удаления группы
desc	string	Описание группы
gid	int	Grid id
guid	int	Внутренний идентификатор ресурсной группы
rg_id	int	Идентификатор ресурсной группы
lock_status	string	Статус блокировки ресурсной группы
name	string	Название ресурсной группы
register_computes	bool	Имеются ли зарезервированные выч. мощности
resource_limits	Struct{ cu_c float cu_d float cu_i float cu_m float cu_np float gpu_units float }	Ограничения ресурсов Кол-во ядер Размер диска, ГБ Число публичных ip адресов Размер RAM, МБ Объем трафика, ГБ Кол-вол графических ядер
secret	string	Секрет группы
status	string	Статус группы
updated_by	string	Кем группа была обновлена в последний раз
updated_time	int	Время последнего обновления
vins	[]int	Список идентификаторов виртуальных сетей
vms	[]int	Список идентификаторов виртуальных машин (устаревшее)

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

Пример вызова data source функции dynamix_rg_list:

data "dynamix_rg_list" "rg_list" {
  #фильтр по id ресурсной группы
  #опциональный параметр
  #тип - целое число
  #by_id = 100

  #фильтр по имени ресурсной группы
  #опциональный параметр
  #тип - строка
  #name = "test"

  #id аккаунта для получения списка ресурсных групп
  #опциональный параметр 
  #тип - целое число
  #account_id = 11111

  #фильтр по имени аккаунта
  #опциональный параметр
  #тип - строка
  #account_name = "test"

  #фильтр по времени создания (после указанного времени)
  #опциональный параметр
  #тип - целое число
  #created_after = "123"

  #фильтр по времени создания (перед указанным временем)
  #опциональный параметр
  #тип - целое число
  #created_before = "123"

  #фильтр по статусу
  #опциональный параметр
  #тип - строка
  #status = "ENABLED"

  #фильтр по lock status
  #опциональный параметр
  #тип - строка
  #lock_status = "UNLOCKED"

  #отображать удаленные ресурсные группы или нет
  #необязательный параметр
  #тип - булев
  #includedeleted = false

  #сортировка по одному из поддерживаемых полей
  #опциональный параметр
  #тип - строка
  #формат - "+поле" по возрастанию / "-поле" по убыванию
  #sort_by = "+name"
  
  #номер страницы
  #необязательный параметр
  #тип - целое число
  #page = 1
  
  #размер страницы
  #необязательный параметр
  #тип - целое число
  #size = 2
}

Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DYNAMIX см. соответствующий раздел).

После успешного завершения такого вызова dynamix_rg_list в переменной data.dynamix_rg_list.rl будут сохранены возвращаемые значения.