| account_id | int | :x: | id аккаунта для получения списка дисков |
| account_id | int | :x: | id аккаунта для получения списка дисков |
| type | string | :x: | Тип диска. Возможные типы: "b" - boot_disk, "d" - data_disk |
| type | string | :x: | Тип диска. Возможные типы: "B" - boot_disk, "D" - data_disk |
| sep_id | int | :x: | Фильтр по SEP id. SEP это способ идентифицировать конкретную систему хранения, на ресурсах которой размещён данный диск |
| pool_name | string | :x: | Фильтр по наименованию pool |
| page | int | :x: | Номер страниц |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
| size | int | :x: | Размер страницы |
@ -25,7 +28,7 @@ _Data source_ функция **decort_disk_list** принимает следу
| --- | --- | --- |
| --- | --- | --- |
| account_id | int | Уникальный идентификатор подписчика-владельца диска |
| account_id | int | Уникальный идентификатор подписчика-владельца диска |
| account_name | string | Имя подписчика ("account"), которому принадлежит данный диск |
| account_name | string | Имя подписчика ("account"), которому принадлежит данный диск |
| boot_partition | int | Кол-во разделов диска |
| acl | string | Acces Control List |
| computes | Struct{} [см. ниже](#описание-структуры-computes) | Информация о компьютах (виртуальных машинах) |
| computes | Struct{} [см. ниже](#описание-структуры-computes) | Информация о компьютах (виртуальных машинах) |
| created_time | int | Время создания |
| created_time | int | Время создания |
| deleted_time | int | Время удаления |
| deleted_time | int | Время удаления |
@ -33,28 +36,21 @@ _Data source_ функция **decort_disk_list** принимает следу
| destruction_time | int | Время окончательного удаления |
| destruction_time | int | Время окончательного удаления |
| devicename | string | Наименование устройства |
| devicename | string | Наименование устройства |
| disk_id | int | Идентификатор диска. Дублирует значение параметра `id`. |
| disk_id | int | Идентификатор диска. Дублирует значение параметра `id`. |
| disk_path | string | Адрес диска |
| gid | int | Идентификатор площадки (grid id) |
| gid | int | Идентификатор площадки (grid id) |
| guid | int | Идентификатор диска |
| id | int | Идентификатор диска |
| id | int | Идентификатор диска |
| image_id | int | Идентификатор образа, содержимое которого было склонировано/скопировано в данный диск при его создании. 0 означает, что данный диск не создавался как клон/копия какого-либо образа |
| image_id | int | Идентификатор образа, содержимое которого было склонировано/скопировано в данный диск при его создании. 0 означает, что данный диск не создавался как клон/копия какого-либо образа |
| images | []int | Идентификаторы образов, использующих диск |
| images | []int | Идентификаторы образов, использующих диск |
| iotune | Struct{}[см. ниже](#описание-структуры-iotune) | Информация об ограничениях IO диска|
| iotune | Struct{}[см. ниже](#описание-структуры-iotune) | Информация об ограничениях IO диска|
| iqn | string | iqn диска |
| machine_id | int | id машины (устаревшее) |
| login | string | Логин для доступа к диску |
| machine_name | string | Наименование машины (устаревшее) |
| milestones | int | Вехи |
| disk_name | string | Наименование диска |
| disk_name | string | Наименование диска |
| order | int | Номер диска |
| order | int | Номер диска |
| params | string | Параметры диска |
| params | string | Параметры диска |
| parent_id | int | id родительского диска |
| parent_id | int | id родительского диска |
| passwd | string | Пароль для доступа к диску |
| pci_slot | int | id pci слота, к которому подключен диск |
| pci_slot | int | id pci слота, к которому подключен диск |
| pool | string | Имя пула в системе хранения, на ресурсах которой размещён данный диск |
| pool | string | Имя пула в системе хранения, на ресурсах которой размещён данный диск |
| present_to | []int | Список ID ресурсов, которым предоставлен диск |
| present_to | []int | Список ID ресурсов, которым предоставлен диск |
| purge_attempts | int | Кол-во попыток удаления |
| purge_time | int | Время удаления |
| purge_time | int | Время последней попытки |
| reality_device_number | int | Реальный номер устройства |
| reference_id | int | id ссылки на диск |
| res_id | int | id ресурса |
| res_id | int | id ресурса |
| res_name | string | Наименование ресурса |
| res_name | string | Наименование ресурса |
| role | string | Роль диска |
| role | string | Роль диска |
@ -106,6 +102,36 @@ _Data source_ функция **decort_disk_list** принимает следу
Пример вызова _data source_ функции **decort_disk_list**:
Пример вызова _data source_ функции **decort_disk_list**:
```terraform
```terraform
data "decort_disk_list" "dl" {
data "decort_disk_list" "dl" {
#фильтр по id диска
#опциональный параметр
#тип - число
#by_id = 100
#фильтр по имени диска
#опциональный параметр
#тип - строка
#name = "data_disk"
#фильтр по имени аккаунта
#опциональный параметр
#тип - строка
#account_name = "user"
#фильтр по максимальному размеру диска
#опциональный параметр
#тип - число
#disk_max_size = 100
#фильтр по статусу
#опциональный параметр
#тип - строка
#status = "ENABLED"
#фильтр по доступности иным пользователям
#опциональный параметр
#тип - булев тип
#shared = "false"
#id аккаунта для получения списка дисков
#id аккаунта для получения списка дисков
#опциональный параметр
#опциональный параметр
#тип - число
#тип - число
@ -114,16 +140,26 @@ data "decort_disk_list" "dl" {
@ -4,9 +4,15 @@ _Data source_ функция **decort_extnet_computes_list** служит для
## Аргументы
## Аргументы
_Data source_ функция **decort_extnet_computes_list** принимает следующие аргументы:
_Data source_ функция **decort_extnet_computes_list** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| --- | --- | --- | --- |
| account_id | int | :heavy_check_mark: | Идентификатор аккаунта, которому принадлежать вычислительные ресурсы |
| account_id | int | :heavy_check_mark: | Идентификатор аккаунта, которому принадлежат вычислительные ресурсы |
| rg_id | int | :x: | ID ресурсной группы для фильтрации результата поиска |
| compute_id | int | :x: | ID виртуальной машины для фильтрации результата поиска |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
## Возвращаемые значения
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_extnet_computes_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:
В случае успешного выполнения _data source_ функция **decort_extnet_computes_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:
@ -15,12 +21,20 @@ _Data source_ функция **decort_extnet_computes_list** принимает
| --- | --- | --- |
| --- | --- | --- |
| account_id | int | ID аккаунта - владельца вычислительных ресурсов |
| account_id | int | ID аккаунта - владельца вычислительных ресурсов |
| account_name | string | Имя аккаунта - владельца вычислительных ресурсов |
| account_name | string | Имя аккаунта - владельца вычислительных ресурсов |
В случае успешного выполнения _data source_ функция **decort_account_templates_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:
В случае успешного выполнения _data source_ функция **decort_account_templates_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:
@ -33,6 +39,38 @@ data "decort_account_templates_list" "atl" {
#обязательный параметр
#обязательный параметр
#тип - число
#тип - число
account_id = 11111
account_id = 11111
#фильтр "включая удаленные шаблоны"
#опциональный параметр
#тип - булев тип
#include_deleted = true
#фильтр по id образа
#опциональный параметр
#тип - число
#image_id = 1111
#фильтр по имени
#опциональный параметр
#тип - строка
#name = "test"
#фильтр по типу
#опциональный параметр
#тип - строка
#type = "linux"
#номер страницы для отображения
#опциональный параметр
#тип - число
#если не задан - выводятся все доступные данные
#page = 2
#размер страницы
#опциональный параметр
#тип - число
#если не задан - выводятся все доступные данные
#size = 3
}
}
# once the above directive completes, account templates list will be accessible
# once the above directive completes, account templates list will be accessible
_Data source_ функция **decort_disk_list_types** служит для получения информации о типах диска.
_Data source_ функция **decort_disk_list_types** служит для получения информации о типах диска.
## Аргументы
## Аргументы
_Data source_ функция **decort_disk_list_types** не принимает аргументы.
_Data source_ функция **decort_disk_list_types** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
## Возвращаемые значения
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_disk_list_types** возвращает в указанную при вызове переменную, в поле _types_, массив, состоящий из строк, описывающих поддерживаемые в платформе типы дисков:
В случае успешного выполнения _data source_ функция **decort_disk_list_types** возвращает в указанную при вызове переменную, в поле _types_, массив, состоящий из строк, описывающих поддерживаемые в платформе типы дисков:
@ -17,7 +22,17 @@ _Data source_ функция **decort_disk_list_types** не принимает
Пример вызова _data source_ функции **decort_disk_list_types**:
Пример вызова _data source_ функции **decort_disk_list_types**:
_Data source_ функция **decort_disk_list_types_detailed** служит для получения расширенной информации о поддерживаемых платформой типах дисков. В отличии от другой _data source_ функции **decort_disk_list_types**, данная функция позволяет получить информацию о поддерживаемых пулами и sep типов дисков.
_Data source_ функция **decort_disk_list_types_detailed** служит для получения расширенной информации о поддерживаемых платформой типах дисков. В отличии от другой _data source_ функции **decort_disk_list_types**, данная функция позволяет получить информацию о поддерживаемых пулами и sep типов дисков.
## Аргументы
## Аргументы
_Data source_ функция **decort_disk_list_types_detailed** не принимает аргументы.
_Data source_ функция **decort_disk_list_types_detailed** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
## Возвращаемые значения
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_disk_list_types_detailed** возвращает в указанную при вызове переменную, в поле _items_, массив, каждый элемент которого состоит из следующих параметров:
В случае успешного выполнения _data source_ функция **decort_disk_list_types_detailed** возвращает в указанную при вызове переменную, в поле _items_, массив, каждый элемент которого состоит из следующих параметров:
| Параметр | Тип | Описание |
| Параметр | Тип | Описание |
| --- | --- | --- |
| --- | --- | --- |
| pools | см.ниже | Пул хранилища |
| pools | []Struct см.ниже | Пул хранилища |
| sep_id | id | ID storage endpoint |
| sep_id | int | ID storage endpoint (SEP). SEP это способ идентифицировать конкретную систему хранения, на ресурсах которой размещён данный диск |
| sep_name | int | Имя storage endpoint |
### Описание структуры pool
### Описание структуры pool
| Параметр | Тип | Описание |
| Параметр | Тип | Описание |
| --- | --- | --- |
| --- | --- | --- |
| name | string | Имя пул |
| name | string | Имя пул |
| system | string | Флаг, обозначающий служебный пул, для размещения там данных о блокировках |
| types | []string | Список поддерживаемых типов |
| types | []string | Список поддерживаемых типов |
## Пример использования
## Пример использования
Пример вызова _data source_ функции **decort_disk_list_types_detailed*:
Пример вызова _data source_ функции **decort_disk_list_types_detailed*:
@ -10,6 +10,8 @@ _Data source_ функция **decort_rg_affinity_groups_list** принимае
| Аргумент | Тип | Обязательный | Описание |
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| --- | --- | --- | --- |
| rg_id | :heavy_check_mark: | int | Идентификатор ресурсной группы |
| rg_id | :heavy_check_mark: | int | Идентификатор ресурсной группы |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
Пользователь облачной платформы, от лица которого происходит обращение к данной функции, должен иметь доступ к указанному `account` и ресурсной группе. В противном случае возникнет ошибка доступа.
Пользователь облачной платформы, от лица которого происходит обращение к данной функции, должен иметь доступ к указанному `account` и ресурсной группе. В противном случае возникнет ошибка доступа.
@ -17,6 +19,7 @@ _Data source_ функция **decort_rg_affinity_groups_list** принимае
## Возвращаемые значения
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_rg_affinity_groups_list** возвращает в указанную при вызове переменную, в поле _affinity_groups_, массив, каждый элемент которого состоит из следующих параметров:
В случае успешного выполнения _data source_ функция **decort_rg_affinity_groups_list** возвращает в указанную при вызове переменную, в поле _affinity_groups_, массив, каждый элемент которого состоит из следующих параметров:
| Параметр | Тип | Описание |
| Параметр | Тип | Описание |
| --- | --- | --- |
| --- | --- | --- |
| label | string | Лейбл аффинити группы |
| label | string | Лейбл аффинити группы |
@ -28,6 +31,18 @@ _Data source_ функция **decort_rg_affinity_groups_list** принимае
```terraform
```terraform
data "decort_rg_affinity_groups_list" "rg_affinity_groups_list" {
data "decort_rg_affinity_groups_list" "rg_affinity_groups_list" {
rg_id = 1234
rg_id = 1234
#номер страницы для отображения
#опциональный параметр
#тип - число
#если не задан - выводятся все доступные данные
#page = 1
#размер страницы
#опциональный параметр
#тип - число
#если не задан - выводятся все доступные данные
#size = 1
}
}
# Once the above directive completes, resource group ID will be accessible as
# Once the above directive completes, resource group ID will be accessible as
Функция доступна в провайдере версии 4.4.1 и выше.
_Data source_ функция **decort_account_resource_consumption_get** служит для получения информации о количестве потребляемых и зарезервированных ресурсов (процессор, оперативная память, диск) по конкретному аккаунту
## Аргументы
_Data source_ функция **decort_account_resource_consumption_get** принимает следующие аргументы:
| account_id | int | :heavy_check_mark: | ID аккаунта |
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_account_resource_consumption_get** возвращает в указанную при вызове переменную элемент, который состоит из следующих параметров:
| cu_i | float | Количество публичных IP адресов |
| cu_m | float | размер RAM |
| cu_np | float | Хранилище траффика |
| gpu_units | float | количество GPU ядер |
## Пример использования
Пример вызова _data source_ функции **decort_account_resource_consumption_get**:
```terraform
data "decort_account_resource_consumption_get" "rc_get" {
#id аккаунта
#обязательный параметр
#тип - число
account_id = 111
}
# once the above directive completes, sep will be accessible
# as data.decort_account_resource_consumption_get.rc
```
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/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_resource_consumption_get** в переменной `data.decort_account_resource_consumption_get.rc_get` будут сохранены возвращаемые значения.
Функция доступна в провайдере версии 4.4.1 и выше.
_Data source_ функция **decort_account_resource_consumption_list** служит для получения информации о количестве потребляемых и зарезервированных ресурсов (процессор, оперативная память, диск) доступных аккаунту
## Аргументы
_Data source_ функция **decort_account_resource_consumption_list** не принимает аргументы.
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_account_resource_consumption_list** возвращает в указанную при вызове переменную, в поле _items_, массив, каждый элемент которого состоит из следующих параметров:
| consumed | Struct{} [см. ниже](#описание-структуры-consumed-и-reserved) | Информация о текуших ресурсах |
| reserved | Struct{} [см. ниже](#описание-структуры-consumed-и-reserved) | Информация о зарезервированных аккаунтом ресурсах |
### Описание структуры consumed и reserved
| Параметр | Тип | Описание |
| --- | --- | --- |
| cpu | int | Количество CPU |
| disk_size | float | Размер диска |
| disk_size_max | float | Максимальный размер диск |
| extips | int | Внешние IPs |
| exttraffic | int | Внешний Traffic |
| gpu | int | Количество GPU |
| ram | int | Количество RAM |
| seps | []Struct{} [см . ниже](#описание-структуры-seps)| Информация о seps |
### Описание структуры seps
| Параметр | Тип | Описание |
| --- | --- | --- |
| sep_id | int | ID SEP. SEP это способ идентифицировать конкретную систему хранения, на ресурсах которой размещён данный диск|
| data_name | string | Имя пула информации внутри SEP'а |
| disk_size | float | Количество занятого места |
| disk_size_max | float | Размер диска |
## Пример использования
Пример вызова _data source_ функции **decort_account_resource_consumption_list**:
```terraform
data "decort_account_resource_consumption_list" "rc_list" {
#Нет входных параметров
}
# once the above directive completes, sep will be accessible
# as data.decort_account_resource_consumption_list.rc
```
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/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_resource_consumption_list** в переменной `data.decort_account_resource_consumption_list.rc_list` будут сохранены возвращаемые значения.
Функция доступна в провайдере версии 4.4.1 и выше.
_Data source_ функция **decort_k8s_wg_cloud_init** служит для получения информации об предустановленных настройках группы воркеров кластера Kubernetes (k8s)
## Аргументы
_Data source_ функция **decort_k8s_wg_cloud_init** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| k8s_id | int | :heavy_check_mark: | ID кластера |
| wg_id | int | :heavy_check_mark: | ID группы воркеров |
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_k8s_wg_cloud_init** возвращает следующие параметры:
Пример вызова _data source_ функции **decort_k8s_wg_cloud_init**:
```terraform
data "decort_k8s_wg_cloud_init" "wg_cloud_init" {
#id кластера
#обязательный параметр
#тип - число
k8s_id = 977
#id группы воркеров
#обязательный параметр
#тип - число
wg_id = 2110
}
```
После успешного завершения такого вызова **decort_k8s_wg_cloud_init** в переменной `data.decort_k8s_wg_cloud_init.wg_cloud_init` будут сохранены возвращаемые значения.
| ip_address | string | :x: | Фильтр по IP адресу |
| extnet_name | string | :x: | Фильтр по имени внешней сети |
| extnet_id | int | :x: | Фильтр по extnet ID |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
| ignore_k8s | bool | :x: | При значении true - показать все ВМ, не относящиеся к любому из кластеров k8s |
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_kvmvm_list_deleted** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:
| Параметр | Тип | Описание |
| --- | --- | --- |
| acl | []Struct [см. ниже](#описание-структуры-acl)| Cписок Acces Control |
| account_id | int | Уникальный идентификатор подписчика-владельца ("account") данной виртуальной машины. |
| account_name | string | Имя подписчика, которому принадлежит данная виртуальная машина. |
| affinity_label | string | Лейбл аффинити |
| affinity_rules | []Struct [см. ниже](#описание-структуры-affinity-rules) | Правила аффинити для компьютов |
| affinity_weight | int | weight аффинити |
| anti_affinity_rules | []Struct [см. ниже](#описание-структуры-affinity-rules) | Правила анти аффинити для компьютов |
| arch | string | Архитектура |
| boot_order | []string | Boot order |
| bootdisk_size | int | Размер загрузочного диска в ГБ. |
| clone_reference | int | кол-во клонов |
| clones | []int | id клонов |
| cpus | int | Количество виртуальных CPU, выделенных данному серверу. |
| created_by | string | Кес создан ресурс |
| created_time | int | Время создания ресурса |
| custom_fields | string | Кастомные поля |
| deleted_by | string | Кем удален ресурс |
| deleted_time | int | Время удаления ресурса |
| desc | string | Текстовое описание виртуальной машины. |
| devices | string | Девайсы |
| disks | []Struct [см. ниже](#описание-структуры-disks)| информация о дисках компьюта |
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)).
После успешного завершения такого вызова _data source_ функции **decort_kvmvm_list_deleted** в переменной `data.decort_kvmvm_list_deleted.kvmvm_list` будут сохранены возвращаемые значения.
Функция доступна в провайдере версии 4.4.1 и выше.
_Data source_ функция **decort_kvmvm_pci_device_list** служит для получения информации о доступных компьюту списка устройств с шиной PCI.
## Аргументы
_Data source_ функция **decort_kvmvm_pci_device_list** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| compute_id | int | id компьюта |
| rg_id | int | :x: | Фильтр по ID ресурсной группы |
| device_id | int | :x: | Фильтр по ID устройства |
| name | string | :x: | Фильтр по имени |
| status | string | :x: | Фильтр по статусу |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_kvmvm_pci_device_list** возвращает в указанную при вызове переменную, в поле _items_ массив строк
## Пример использования
Пример вызова _data source_ функции **decort_kvmvm_pci_device_list**:
```terraform
data "decort_kvmvm_pci_device_list" "pci_device_list" {
#id виртуальной машины
#обязательный параметр
#тип - число
compute_id = 100
#фильтр по id ресурсной группы
#опциональный параметр
#тип - число
#rg_id = 100
#фильтр по id устройства
#опциональный параметр
#тип - число
#device_id = 100
#фильтр по имени устройства
#опциональный параметр
#тип - строка
#name = "test"
#фильтр по статусу
#опциональный параметр
#тип - строка
#status = "ENABLED"
#номер страницы для отображения
#опциональный параметр
#тип - число
#если не задан - выводятся все доступные данные
#page = 1
#размер страницы
#опциональный параметр
#тип - число
#если не задан - выводятся все доступные данные
#size = 1
}
# once the above directive completes, pcidevice list will be accessible
# as data.decort_kvmvm_pci_device_list.pl.items
```
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/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_kvmvm_pci_device_list** в переменной `data.decort_kvmvm_pci_device_list.pci_device_list` будут сохранены возвращаемые значения.
Функция доступна в провайдере версии 4.4.1 и выше.
_Data source_ функция **decort_kvmvm_vgpu_list** служит для получения информации о доступных компьюту списка виртуальных графических устройств.
## Аргументы
_Data source_ функция **decort_kvmvm_vgpu_list** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| compute_id | int | id компьюта |
| gpu_id | int | :x: | Фильтр по ID устройства |
| type | int | :x: | Фильтр по типу графического устройства |
| status | string | :x: | Фильтр по статусу |
| includedeleted | bool | :x: | Включить в рез-тат удаленные устройства |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_kvmvm_vgpu_list** возвращает в указанную при вызове переменную, в поле _items_ массив строк
## Пример использования
Пример вызова _data source_ функции **decort_kvmvm_vgpu_list**:
# once the above directive completes, pcidevice list will be accessible
# as data.decort_kvmvm_vgpu_list.pl.items
```
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/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_kvmvm_vgpu_list** в переменной `data.decort_kvmvm_vgpu_list.vgpu_list` будут сохранены возвращаемые значения.
Функция доступна в провайдере версии 4.4.1 и выше.
_Data source_ функция **decort_rg_resource_consumption_get** служит для получения информации о количестве потребляемых и зарезервированных ресурсов (процессор, оперативная память, диск) по конкретной ресурсной группе
## Аргументы
_Data source_ функция **decort_rg_resource_consumption_get** принимает следующие аргументы:
| rg_id | int | :heavy_check_mark: | ID ресурсной группы |
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_rg_resource_consumption_get** возвращает в указанную при вызове переменную элемент, который состоит из следующих параметров:
| cu_i | float | Количество публичных IP адресов |
| cu_m | float | размер RAM |
| cu_np | float | Хранилище траффика |
| gpu_units | float | количество GPU ядер |
## Пример использования
Пример вызова _data source_ функции **decort_rg_resource_consumption_get**:
```terraform
data "decort_rg_resource_consumption_get" "rc_get" {
#id ресурсной группы
#обязательный параметр
#тип - число
rg_id = 111
}
# once the above directive completes, sep will be accessible
# as data.decort_rg_resource_consumption_get.rc
```
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/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_rg_resource_consumption_get** в переменной `data.decort_rg_resource_consumption_get.rc_get` будут сохранены возвращаемые значения.
Функция доступна в провайдере версии 4.4.1 и выше.
_Data source_ функция **decort_account_resource_consumption_list** служит для получения информации о количестве потребляемых и зарезервированных ресурсов (процессор, оперативная память, диск) доступных ресурсной группе
## Аргументы
_Data source_ функция **decort_account_resource_consumption_list** не принимает аргументы.
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_account_resource_consumption_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:
| cu_i | float | Количество публичных IP адресов |
| cu_m | float | размер RAM |
| cu_np | float | Хранилище траффика |
| gpu_units | float | количество GPU ядер |
## Пример использования
Пример вызова _data source_ функции **decort_account_resource_consumption_list**:
```terraform
data "decort_account_resource_consumption_list" "rc_list" {
#Нет входных параметров
}
# once the above directive completes, sep will be accessible
# as data.decort_account_resource_consumption_list.rc
```
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/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_resource_consumption_list** в переменной `data.decort_account_resource_consumption_list.rc_list` будут сохранены возвращаемые значения.
| driver | string | :heavy_check_mark: | Аппаратная архитектура виртуальной машины.<br/>Может принимать одно из следующих значений:<br/> _ "KVM_X86" - stateful виртуальная машина KVM на аппаратной платформе x86.<br/> _ "SVA_KVM_X86" - stateless ВМ на аппаратной платформе x86. <br/> \* "KVM_PPC" - виртуальная машина KVM на аппаратной платформе IBM Power. |
| driver | string | :heavy_check_mark: | Аппаратная архитектура виртуальной машины.<br/>Может принимать одно из следующих значений:<br/> _ "KVM_X86" - stateful виртуальная машина KVM на аппаратной платформе x86.<br/> _ "SVA_KVM_X86" - stateless ВМ на аппаратной платформе x86. <br/> \* "KVM_PPC" - виртуальная машина KVM на аппаратной платформе IBM Power. |
| cpu | int | :heavy_check_mark: | Количество процессоров. |
| cpu | int | :heavy_check_mark: | Количество процессоров. |
| name | string | :heavy_check_mark: | Имя виртуальной машины. Обратите внимание, что имя должно быть уникальным в рамках ресурсной группы. |
| name | string | :heavy_check_mark: | Имя виртуальной машины. Обратите внимание, что имя должно быть уникальным в рамках ресурсной группы. |
| rg_id | int | :heavy_check_mark: | Идентификатор ресурсной группы, которой принадлежит данная виртуальная машина. |
| rg_id | int | :heavy_check_mark: | Идентификатор ресурсной группы, которой принадлежит данная виртуальная машина. |
| ram | int | :heavy_check_mark: | Объём оперативной памяти в МБ.<br/> |
| ram | int | :heavy_check_mark: | Объём оперативной памяти в МБ.<br/> |
| image_id | int | :heavy_check_mark: | Идентификатор образа, на базе которого создаётся загрузочный диск виртуальной машины.<br/> |
| image_id | int | :heavy_check_mark: | Идентификатор образа, на базе которого создаётся загрузочный диск виртуальной машины.<br/> |
| boot_disk_size | int | :heavy_check_mark: | Размер загрузочного диска виртуальной машины в ГБ.
| boot_disk_size | int | :heavy_check_mark: | Размер загрузочного диска виртуальной машины в ГБ. |
| custom_fields | string (json-encoded) | :x: | Управление XML виртуальной машины
| custom_fields | string (json-encoded) | :x: | Управление XML виртуальной машины |
| extra_disks | []int | :x: | Список идентификаторов дополнительных дисков, которые требуется подключить к данной виртуальной машине помимо загрузочного диска. |
| extra_disks | []int | :x: | Список идентификаторов дополнительных дисков, которые требуется подключить к данной виртуальной машине помимо загрузочного диска. |
| cloud_init | string | :x: | Используется на этапе создания вм.<br/>Параметры для утилиты _cloud_init_, которая используется в платформе DECORT для первичного конфигурирования виртуальной машины после её создания. |
| cloud_init | string | :x: | Используется на этапе создания вм.<br/>Параметры для утилиты _cloud_init_, которая используется в платформе DECORT для первичного конфигурирования виртуальной машины после её создания. |
| with_default_vins | bool | :x: | При значении false ВМ создается без подключения стандартных ViNS ресурсной группы. При указании хотя бы одного блока network (см. ниже) данный параметр игнорируется. Дефолтное значение - true. |
| network | []Struct [см. ниже](#описание-блока-network) | :x: | Параметры сетевого подключения. Если нужно сконфигурировать несколько сетевых подключений, данный блок можно задавать многократно - по одному на каждое подключение. |
| network | []Struct [см. ниже](#описание-блока-network) | :x: | Параметры сетевого подключения. Если нужно сконфигурировать несколько сетевых подключений, данный блок можно задавать многократно - по одному на каждое подключение. |
Функция доступна в провайдере версии 4.4.1 и выше.
Функция доступна в провайдере версии 2.0 и выше.
**Внимание:** необходимы права администратора.
_Resource_ функция **decort_virtual_image** служит для управления виртуальным образом. Виртуальный образа создаются на основе уже созданных ранее образов, таким образом, они привязываются к уже созданным образам. Образ, на основе которого создан виртуальный диск, удалить невозможно - для этого необходимо удалить виртуальный образ, либо связать егос другим образом.
_Resource_ функция **decort_image_virtual** служит для управления виртуальным образом. Виртуальный образа создаются на основе уже созданных ранее образов, таким образом, они привязываются к уже созданным образам. Образ, на основе которого создан виртуальный диск, удалить невозможно - для этого необходимо удалить виртуальный образ, либо связать егос другим образом.
## Аргументы
## Аргументы
_Resource_ функция **decort_image_virtual** для создания виртуального образа принимает следующие аргументы:
_Resource_ функция **decort_virtual_image** для создания виртуального образа принимает следующие аргументы:
# once the above directive completes, will be accessible
# once the above directive completes, will be accessible
# as decort_image_virtual.my_image
# as decort_virtual_image.my_image
```
```
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)).
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)).
После успешного завершения такого вызова **decort_image_virtual** в переменной `decort_image_virtual.my_image` будут сохранены возвращаемые значения.
После успешного завершения такого вызова **decort_virtual_image** в переменной `decort_virtual_image.iv` будут сохранены возвращаемые значения.