Create data source decort_vgpu page

stSolo
2022-05-05 12:08:01 +03:00
parent 918cf03981
commit 3ac6572d74

@@ -0,0 +1,42 @@
Функция доступна в провайдере версии 2.2 и выше.
**Внимание:** необходимы права администратора.
_Data source_ функция **decort_vgpu** служит для получения информации об имеющимся виртуальном графическом устройстве.
## Аргументы
_Data source_ функция **decort_vgpu** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| vgpu_id | int | :heavy_check_mark: | ID устройства |
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_pcidevice** возвращает в указанную при вызове переменную элемент, который состоит из следующих параметров:
| Параметр | Тип | Описание |
| --- | --- | --- |
| vgpu_id | int | id устройства |
| account_id | int | id аккаунта, к которому привязано устройство |
| mode | string | Режим работы устройства |
| pgpu | int | id физического устройства, на основе которого создано виртуальное |
| profile_id | int | id профиля, к которому привязано устройство |
| ram | int | Количество ОЗУ виртуального устройства |
| status | string | Статус устройства |
| type | string | Тип устройства |
| vm_id | int | id виртуальной машины, использующей устройство |
## Пример использования
Пример вызова _data source_ функции **decort_vgpu**:
```terraform
data "decort_vgpu" "vgpu" {
vgpu_id = 111
}
# once the above directive completes, vgpu will be accessible
# as data.decort_vgpu.vgpu
```
Данный пример подразумевает, что ранее по тексту 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_vgpu** в переменной `data.decort_vgpu.vgpu` будут сохранены возвращаемые значения.