Функция доступна в провайдере версии 4.5.1 и выше.

_Data source_ функция **decort_cb_pcidevice_list** служит для получения информации об имеющихся устройств с шиной PCI.

## Аргументы
_Data source_ функция **decort_cb_pcidevice_list** принимает следующие аргументы:

| Аргумент   | Тип    | Обязательный | Описание                          |
|------------|--------|--------------|-----------------------------------|
| by_id      | int    | :x:          | фильтр по ID устройства           |
| compute_id | int    | :x:          | фильм по ID вычислительной машины |
| name       | string | :x:          | фильтр по наименованию устройства |
| rg_id      | int    | :x:          | фильтр по ID ресурсной группы     |
| status     | string | :x:          | фильтр по статусу устройства      |
| page       | int    | :x:          | Номер страницы для вывода         |
| size       | int    | :x:          | Размер страницы для вывода        |

## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_cb_pcidevice_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:

| Параметр    | Тип      | Описание                             |
|-------------|----------|--------------------------------------|
| ckey        | string   | CKey                                 |
| 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   | Системное имя устройства             |


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

Пример вызова _data source_ функции **decort_cb_pcidevice_list**:

```terraform
data "decort_cb_pcidevice_list" "pl" {
}
# once the above directive completes, pcidevice list will be accessible 
# as data.decort_cb_pcidevice_list.pl.items
```

Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.5.3/04.02-Инициализация-Terraform-провайдера-DECORT.md)). 

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