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

_Data source_ функция **decort_cb_storage_policy_list** служит для получения информации о доступных политиках хранения

## Аргументы

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

| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| account_id | int | :x: | ID аккаунта, имеюшего доступ к политикам хранения |
| page | int | :x: | Номер страницы для вывода |
| size | int | :x: | Размер страницы для вывода |
| sort_by | string | :x: | Фильтр по значениям поля. Формат +/-(field) |
| by_id | int | :x: | Фильтр по ID политики хранения |
| name | string | :x: | Фильтр по имени политики хранения |
| status | string | :x: | Фильтр по статусу |
| desc | string | :x: | Фильтр по описанию |
| limit_iops | int | :x: | Фильтр по лимиту IOPS |
| resgroup_id | int | :x: | Фильтр по ID ресурсной группы |
| sep_id | int | :x: | Фильтр по SEP ID |
| pool_name | string | :x: | Фильтр по имени пула |


## Возвращаемые значения

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

| Параметр | Тип | Описание |
| --- | --- | --- |
| storage_policy_id | int | Уникальный идентификатор политики хранения | 
| description | string | Описание политики хранения | 
| guid | int | GUID | 
| limit_iops | int | Лимит операций ввода-вывода в секунду | 
| name | string | Имя политики хранения | 
| status | string | Статус политики хранения | 
| access_seps_pools | []Struct [см. ниже](#описание-структуры-access-seps-pools) | Список пулов в SEP, к которым относится политика хранения | 
| usage |  Struct{} [см. ниже](#описание-структуры-usage) | Кто использует политику хранения |   

### Описание структуры access seps pools
| Параметр | Тип | Описание |
| --- | --- | --- |
| pool_names | []string | Список имён пулов |
| sep_id | int | SEP ID |
| sep_name | string | Имя SEP |

### Описание структуры usage
| Параметр | Тип | Описание |
| --- | --- | --- |
| accounts | []int | Список ID аккаунтов |
| resgroups | []int | Список ID ресурсных групп |

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

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

```terraform
data "decort_cb_storage_policy_list" "lsp" {    
   #номер страницы результата 
   #опциональный параметр 
   #тип - целое число 
   #page = 1 

   #размер страницы результата   
   #опциональный параметр 
   #тип - целое число 
   #size = 1 

   #фильтр по id 
   #опциональный параметр 
   #тип - целое число 
   #by_id = 1111 

   #фильтр по имени 
   #опциональный параметр 
   #тип - строка 
   #name = "storage_policy_name" 

   #фильтр по статусу 
   #опциональный параметр 
   #тип - строка 
   #status = "status" 

   #фильтр по описанию 
   #опциональный параметр 
   #тип - строка 
   #desc = "desc"     

   #фильтр по лимиту iops     
   #опциональный параметр 
   #тип - целое число 
   #limit_iops = 1111 
 
   #сортировка по одному из поддерживаемых полей 
   #опциональный параметр 
   #тип - строка 
   #формат - "+поле" по возрастанию / "-поле" по убыванию 
   #sort_by = "+name"

   #фильтр по id аккаунта 
   #опциональный параметр 
   #тип - целое число     
   #account_id = 1111

   #фильтр по id ресурсной группы     
   #опциональный параметр 
   #тип - целое число 
   #resgroup_id = 1111 

   #фильтр по id сеп
   #опциональный параметр 
   #тип - целое число 
   #sep_id = 1111 

   #фильтр по имени пула 
   #опциональный параметр 
   #тип - строка
   #pool_name = "name"
    
}
```

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

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