From a132bfd3877a75cb014ec6784e2b3b15587035d4 Mon Sep 17 00:00:00 2001
From: stSolo <st.solp@gmail.com>
Date: Fri, 3 Jun 2022 19:08:37 +0300
Subject: [PATCH] Create data extnet page

---
 ...ort_extnet-получение-информации-о-внешней-сети.md | 58 +++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 06.27-Data-функция-decort_extnet-получение-информации-о-внешней-сети.md

diff --git a/06.27-Data-функция-decort_extnet-получение-информации-о-внешней-сети.md b/06.27-Data-функция-decort_extnet-получение-информации-о-внешней-сети.md
new file mode 100644
index 0000000..7005d48
--- /dev/null
+++ b/06.27-Data-функция-decort_extnet-получение-информации-о-внешней-сети.md
@@ -0,0 +1,58 @@
+Функция доступна в провайдере версии 2.3 и выше.
+
+_Data source_ функция **decort_extnet** служит для получения информации о внешней сети.
+
+## Аргументы
+_Data source_ функция **decort_extnet** принимает следующие аргументы:
+| Аргумент | Тип | Обязательный | Описание |
+| --- | --- | --- | --- | 
+| net_id | int | :heavy_check_mark: | Идентификатор сети |
+
+## Возвращаемые значения
+В случае успешного выполнения _data source_ функция **decort_extnet** возвращает следующие параметры:
+
+| Параметр | Тип | Описание |
+| --- | --- | --- |
+| net_id | int | ID сети |
+| meta | []string | Мета информация |
+| check__ips | []string | Список ip адресов для проверки |
+| check_ips | []string | Список ip адресов для проверки |
+| default | bool | Является ли сеть сетью по-умолчанию |
+| default_qos | Struct{<br/>e_rate int<br/>guid string<br/>in_burst int<br/>in_rate int<br/>}  | Quality of Service по-умолчанию<br/>Минимальное кол-во потерь<br/>id сервиса<br/>Потери в режиме burst<br/>Потери в режиме rate<br/>&nbsp;<br/> |
+| desc | string | Описание |
+| dns | []string | Список dns |
+| excluded | []string | Список исключенных ip-адресов |
+| free_ips | int | Кол-во свободных ip-адресов |
+| gateway | string | Сетевые врата |
+| gid | int | Grid id |
+| guid | int | Внутренний id сети |
+| ipcidr | string | Маска сети |
+| milestones | int | Время жизни |
+| net_name | string | Имя сети |
+| network | string | Информация о сети |
+| network_id | int | Идентификатор сети |
+| pre_reservations_num | int | Количество зарезервированных ресурсов |
+| prefix | int | Префикс |
+| pri_vnf_dev_id | int | ID внутренней сети для разработки |
+| reservations | []Struct{<br/>client_type string<br/>domainname string<br/>hostname string<br/>desc string<br/>ip string<br/>mac string<br/>type string<br/>vm_id int<br/>} | Зарезервированные части сети<br/>Тип клиента<br/>Имя домена<br/>Имя хоста<br/>Описание<br/>IP-адрес<br/>MAC-адрес<br/>Тип  <br/>ID виртуальной машины<br/>&nbsp;<br/>|
+| shared_with | []int | Список ресурсов, имеющих доступ к сети |
+| status | string | Статус сети |
+| vlan_id | int | Идентификатор vlan |
+| vnfs | Struct{<br/>dhcp int<br/>} | Информация о vnfs<br/>Информация о dhsp<br/>&nbsp;<br/> |
+
+## Пример использования
+Пример вызова _data source_ функции **decort_extnet**:
+```terraform
+data "decort_extnet" "e" {
+  #идентификатор сети
+  #обязательный параметр
+  #тип - число
+  net_id = 1111
+}
+# once the above directive completes, extnet will be accessible 
+# as data.decort_extnet.e
+```
+
+Данный пример подразумевает, что ранее по тексту 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_extnet** в переменной `data.decort_extnet.e` будут сохранены возвращаемые значения.
\ No newline at end of file