From 3ac6572d741754fabb9b93fa7ddc3355dd455f07 Mon Sep 17 00:00:00 2001 From: stSolo Date: Thu, 5 May 2022 12:08:01 +0300 Subject: [PATCH] Create data source decort_vgpu page --- ...ние-информации-о-виртуальном-графическом-устройстве.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 06.20-Data-функция-decort_vgpu-получение-информации-о-виртуальном-графическом-устройстве.md diff --git a/06.20-Data-функция-decort_vgpu-получение-информации-о-виртуальном-графическом-устройстве.md b/06.20-Data-функция-decort_vgpu-получение-информации-о-виртуальном-графическом-устройстве.md new file mode 100644 index 0000000..8fe8b7e --- /dev/null +++ b/06.20-Data-функция-decort_vgpu-получение-информации-о-виртуальном-графическом-устройстве.md @@ -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` будут сохранены возвращаемые значения. \ No newline at end of file