diff --git a/07.15-Resource-функция-decort_pcidevice-управление-устройством.md b/07.15-Resource-функция-decort_pcidevice-управление-устройством.md new file mode 100644 index 0000000..9d546a8 --- /dev/null +++ b/07.15-Resource-функция-decort_pcidevice-управление-устройством.md @@ -0,0 +1,58 @@ +Функция доступна в провайдере версии 2.2 и выше. + +**Внимание:** необходимы права администратора. + +_Resource_ функция **decort_pcidevice** служит для управления устройств с шиной PCI. + +## Аргументы +_Resource_ функция **decort_pcidevice** принимает следующие аргументы: + +| Аргумент | Тип | Обязательный | Описание | +| --- | --- | --- | --- | +| name | string | :heavy_check_mark: | Имя устройства | +| hw_path | string | :heavy_check_mark: | Путь до устройства (HW Path) | +| description | string | :heavy_check_mark: | Описание устройства | +| rg_id | int | :heavy_check_mark: | id ресурсной группы устройства | +| stack_id | int | :heavy_check_mark: | id стака устройства | +| enable | bool | :x: | Доступность устройства, может использоваться на уже созданном ресурсе | +| force | bool | :x: | Принудительное удаление устройства, используется при удалении устройства | +| device_id | int | :x: | id устройства, может быть использовано для формирования .tfstate, при наличии ресурса в облаке | + +## Возвращаемые значения +В случае успешного выполнения _resource_ функция **decort_pcidevice** возвращает в указанную при вызове переменную элемент, который состоит из следующих параметров: + +| Параметр | Тип | Описание | +| --- | --- | --- | +| meta | []string | Мета информация | +| compute_id | int | id вычислительной площадки | +| description | string | Описание | +| guid | int | Внутренний id | +| hw_path | string | HW Путь | +| device_id | int | id устройства | +| name | string | Наименование устройства | +| rg_id | int | id ресурсной группы (resource group) | +| stack_id | int | id стэка | +| status | string | Статус устройства | +| system_name | string | Системное имя устройства | + + +## Пример использования +Пример вызова _resource_ функции **decort_pcidevice**: +```terraform +resource "decort_pcidevice" "pd" { + name = "test_device" + hw_path = "0000:01:00.0" + description = "test desc" + rg_id = 11111 + stack_id = 11 + + #enable = false + #force = true +} +# once the above directive completes, pcidevice will be accessible +# as decort_pcidevice.pd +``` + +Данный пример подразумевает, что ранее по тексту 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_pcidevice** в переменной `decort_pcidevice.pd` будут сохранены возвращаемые значения. \ No newline at end of file