BASIS/wiki-decort-ansible
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
main
wiki-decort-ansible/12.0.0/модуль-decort_vins.md

2640 lines
44 KiB
Markdown
Raw Permalink Normal View History

12.0.0
2026-06-01 18:15:20 +03:00
# Модуль decort_vins
## Обзор модуля decort_vins
Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия:
- создавать
- на уровне ресурсной группы (если РГ задана)
- на уровне аккаунта (если РГ не задана)
- удалять (в корзину или безвозвратно)
- восстанавливать из корзины
- запрашивать информацию
- включать/отключать
- соединять (необходимы права администратора)
- изменять:
- включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора)
- включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора)
- сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора)
- зону
## Параметры модуля decort_vins
Ниже приведен список параметров для модуля **decort_vins** (за исключением [общих параметров](./введение.md#общие-параметры-модулей)):
| Параметр | Тип, допустимые значения | Описание |
| ------ | ------ | ------ |
| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
|description | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.|
| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. |
| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически.
| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.|
|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.|
| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.|
| state | (string)<br>Значения:<br/>`present`<br/>`absent`<br/>`enabled`<br/>`disabled` | Целевое состояние внутренней сети.<br/>Значение по умолчанию если объект не существует или безвозвратно удалён: `present` |
| permanently | (bool)<br>Default: `false` | Параметр, использующийся для удаления внутренней сети. При значении `true` - внутренняя сеть удалится безвозвратно, а при `false` - попадёт в корзину. |
| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.|
| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.|
| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору.
| custom_config | (bool)<br>Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. |
| config_save | (bool)<br>Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. |
| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры.
| zone_id | (int) | Идентификатор зоны.|
| security_group_mode | (bool) | Включить/выключить группы безопасности. Не поддерживается изменение в существующей внутренней сети. <br>Значение по умолчанию если объект не существует или безвозвратно удалён: `false` |
## Возвращаемые значения модуля decort_vins
Модуль **decort_vins** возвращает информацию о внутренней сети в виде словаря `facts` со следующими ключами:
<table>
<tr>
<th colspan="6">
Ключ
</th>
<th>
Тип
<br>данных
</th>
<th>
Описание
</th>
</tr>
<tr>
<td colspan="6">
account_id
</td>
<td>
int
</td>
<td>
Идентификатор аккаунта.
</td>
</tr>
<tr>
<td colspan="6">
account_name
</td>
<td>
str
</td>
<td>
Имя аккаунта.
</td>
</tr>
<tr>
<td colspan="6">
created_by
</td>
<td>
str
</td>
<td>
Имя пользователя, создавшего сеть.
</td>
</tr>
<tr>
<td colspan="6">
created_datetime
</td>
<td>
str
</td>
<td>
Дата и время создания.
</td>
</tr>
<tr>
<td colspan="6">
created_timestamp
</td>
<td>
int
</td>
<td>
Unix-время создания.
</td>
</tr>
<tr>
<td colspan="6">
default_gw
</td>
<td>
str
</td>
<td>
Шлюз по умолчанию.
</td>
</tr>
<tr>
<td colspan="6">
default_qos
</td>
<td>
dict[str, any]
</td>
<td>
QoS по умолчанию для сети.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
egress_rate
</td>
<td>
int
</td>
<td>
Скорость исходящего трафика.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
guid
</td>
<td>
str
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
ingress_burst
</td>
<td>
int
</td>
<td>
Пиковая нагрузка входящего трафика.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
ingress_rate
</td>
<td>
int
</td>
<td>
Скорость входящего трафика.
</td>
</tr>
<tr>
<td colspan="6">
deleted_by
</td>
<td>
str
</td>
<td>
Имя пользователя, удалившего сеть.
</td>
</tr>
<tr>
<td colspan="6">
deleted_datetime
</td>
<td>
str
</td>
<td>
Дата и время удаления.
</td>
</tr>
<tr>
<td colspan="6">
deleted_timestamp
</td>
<td>
int
</td>
<td>
Unix-время удаления.
</td>
</tr>
<tr>
<td colspan="6">
description
</td>
<td>
str | null
</td>
<td>
Описание.
</td>
</tr>
<tr>
<td colspan="6">
grid_id
</td>
<td>
int
</td>
<td>
Идентификатор ЦОД.
</td>
</tr>
<tr>
<td colspan="6">
guid
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td colspan="6">
id
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td colspan="6">
lock_status
</td>
<td>
str
</td>
<td>
Статус блокировки.
</td>
</tr>
<tr>
<td colspan="6">
manager_id
</td>
<td>
int
</td>
<td>
Идентификатор менеджера.
</td>
</tr>
<tr>
<td colspan="6">
manager_type
</td>
<td>
str
</td>
<td>
Тип менеджера.
</td>
</tr>
<tr>
<td colspan="6">
milestones
</td>
<td>
int
</td>
<td>
Количество событий.
</td>
</tr>
<tr>
<td colspan="6">
name
</td>
<td>
str
</td>
<td>
Имя.
</td>
</tr>
<tr>
<td colspan="6">
net_ip
</td>
<td>
str
</td>
<td>
IP-адрес сети.
</td>
</tr>
<tr>
<td colspan="6">
net_prefix
</td>
<td>
int
</td>
<td>
Префикс сети.
</td>
</tr>
<tr>
<td colspan="6">
pre_reservation_count
</td>
<td>
int
</td>
<td>
Количество забронированных IP-aдресов в сети.
</td>
</tr>
<tr>
<td colspan="6">
redundant
</td>
<td>
bool
</td>
<td></td>
</tr>
<tr>
<td colspan="6">
rg_id
</td>
<td>
int
</td>
<td>
Идентификатор ресурсной группы.
</td>
</tr>
<tr>
<td colspan="6">
rg_name
</td>
<td>
str
</td>
<td>
Имя ресурсной группы.
</td>
</tr>
<tr>
<td colspan="6">
secondary_vnfdev_id
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td colspan="6">
security_group_mode
</td>
<td>
bool
</td>
<td>
Включены ли группы безопасности.
</td>
</tr>
<tr>
<td colspan="6">
status
</td>
<td>
str
</td>
<td>
Статус.
</td>
</tr>
<tr>
<td colspan="6">
updated_by
</td>
<td>
str
</td>
<td>
Пользователь, обновивший сеть.
</td>
</tr>
<tr>
<td colspan="6">
updated_datetime
</td>
<td>
str
</td>
<td>
Дата и время обновления сети.
</td>
</tr>
<tr>
<td colspan="6">
updated_timestamp
</td>
<td>
int
</td>
<td>
Unix-время обновления сети.
</td>
</tr>
<tr>
<td colspan="6">
user_managed
</td>
<td>
bool
</td>
<td>
Управляется ли пользователем.
</td>
</tr>
<tr>
<td colspan="6">
vms
</td>
<td>
list[int]
</td>
<td>
Список идентификаторов виртуальных машин с внутренней сетью.
</td>
</tr>
<tr>
<td colspan="6">
vnfdev
</td>
<td>
dict[str, any]
</td>
<td>
Словарь описывающий маршрутизатор.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
account_id
</td>
<td>
int
</td>
<td>
Идентификатор аккаунта.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
capabilities
</td>
<td>
list[str]
</td>
<td>
Список типов виртуальных функций.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
config
</td>
<td>
dict[str, any]
</td>
<td>
Кофигурация маршрутизатора.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
mgmt
</td>
<td>
dict[str, str]
</td>
<td>
Параметры управления устройством.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ip_addr
</td>
<td>
str
</td>
<td>
IP-адрес.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
password
</td>
<td>
str
</td>
<td>
Пароль.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ssh_public_key
</td>
<td>
str
</td>
<td>
SSH ключ.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
user_name
</td>
<td>
str
</td>
<td>
Имя.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
resources
</td>
<td>
dict[str, any]
</td>
<td>
Выделенные ресурсы.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
cpu_count
</td>
<td>
int
</td>
<td>
Количество виртуальных процессоров.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
node_id
</td>
<td>
int
</td>
<td>
Идентификатор физического узла.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ram_size_mb
</td>
<td>
int
</td>
<td>
Объём оперативной памяти в МБ.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
uuid
</td>
<td>
str
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
config_saved
</td>
<td>
bool
</td>
<td></td>
</tr>
<tr>
<td></td>
<td colspan="5">
custom_pre_cfg
</td>
<td>
bool
</td>
<td></td>
</tr>
<tr>
<td></td>
<td colspan="5">
description
</td>
<td>
str
</td>
<td>
Описание.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
grid_id
</td>
<td>
int
</td>
<td>
Идентификатор ЦОД.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
guid
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
id
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
interfaces
</td>
<td>
list[dict[str, any]]
</td>
<td>
Сетевые интерфейсы маршрутизатора.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
bus_num
</td>
<td>
int
</td>
<td>
Номер шины.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
conn_id
</td>
<td>
int
</td>
<td>
Идентификатор соединения.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
conn_type
</td>
<td>
str
</td>
<td>
Тип соединения.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
default_gw
</td>
<td>
str
</td>
<td>
Шлюз по умолчанию.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
enabled
</td>
<td>
bool
</td>
<td>
Включен ли сетевой интерфейс.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
flip_group_id
</td>
<td>
int
</td>
<td>
Идентификатор группы с плавающим IP-адресом.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
guid
</td>
<td>
str
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
ip_addr
</td>
<td>
str
</td>
<td>
IP-адрес.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
libvirt_settings
</td>
<td>
dict[str, any]
</td>
<td>
Настройки libvirt.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
event_idx
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
guid
</td>
<td>
str
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ioeventfd
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
queues
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
rx_queue_size
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
tx_mode
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
tx_queue_size
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
listen_ssh
</td>
<td>
bool
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
mac
</td>
<td>
str
</td>
<td>
MAC-адрес.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
mtu
</td>
<td>
int
</td>
<td>
MTU сетевого интерфейса.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
name
</td>
<td>
str
</td>
<td>
Имя.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
net_id
</td>
<td>
int
</td>
<td>
Идентификатор сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
net_prefix
</td>
<td>
int
</td>
<td>
Префикс сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
net_type
</td>
<td>
str
</td>
<td>
Тип сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
node_id
</td>
<td>
int
</td>
<td>
Идентификатор физического узла.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
pci_slot_num
</td>
<td>
int
</td>
<td>
Номер слота PCI.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
qos
</td>
<td>
dict[str, any]
</td>
<td>
Quality of Service
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
egress_rate
</td>
<td>
int
</td>
<td>
Скорость исходящего трафика.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
guid
</td>
<td>
str
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ingress_burst
</td>
<td>
int
</td>
<td>
Пиковая нагрузка входящего трафика.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ingress_rate
</td>
<td>
int
</td>
<td>
Скорость входящего трафика.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
sdn_logical_port_id
</td>
<td>
str
</td>
<td>
Идентификатор логического порта SDN.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
security_group_ids
</td>
<td>
list[int]
</td>
<td>
Список идентификаторов групп безопасности.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
security_group_mode
</td>
<td>
bool
</td>
<td>
Включены ли группы безопасности.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
target
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
type
</td>
<td>
str
</td>
<td>
Тип.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
vnf_ids
</td>
<td>
list[int]
</td>
<td>
Идентификаторы виртуальных функций.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
live_migration_job_id
</td>
<td>
int
</td>
<td>
Идентификатор задачи live-миграции.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
lock_status
</td>
<td>
str
</td>
<td>
Статус блокировки.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
milestones
</td>
<td>
int
</td>
<td>
Количество событий.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
name
</td>
<td>
str
</td>
<td>
Имя.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
status
</td>
<td>
str
</td>
<td>
Статус.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
tech_status
</td>
<td>
str
</td>
<td>
Технический статус.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
type
</td>
<td>
str
</td>
<td>
Тип.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
vins_ids
</td>
<td>
list[int]
</td>
<td>
Идентификаторы внутренних сетей.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
vnc_password
</td>
<td>
str
</td>
<td>
Пароль, используемый для подключения к ВМ через VNC.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
zone_id
</td>
<td>
int
</td>
<td>
Идентификатор зоны.
</td>
</tr>
<tr>
<td colspan="6">
vnfs
</td>
<td>
dict[str, dict[str, any] | null]
</td>
<td>
Словарь описывающий функции виртуальной сети.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
dhcp
</td>
<td>
dict[str, any]
</td>
<td>
Словарь описывающий DHCP-сервер.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
account_id
</td>
<td>
int
</td>
<td>
Идентификатор аккаунта.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
config
</td>
<td>
dict[str, any]
</td>
<td>
Кофигурация DHCP-сервера.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
default_gw
</td>
<td>
str
</td>
<td>
Шлюз по умолчанию.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
dns_servers
</td>
<td>
list[str]
</td>
<td>
Список dns.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ip_pool_end
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ip_pool_start
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
lease_time
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
net_ip
</td>
<td>
str
</td>
<td>
IP-адрес сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
net_prefix
</td>
<td>
int
</td>
<td>
Префикс сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
reservations
</td>
<td>
list[dict[str, any]]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
account_id
</td>
<td>
int
</td>
<td>
Идентификатор аккаунта.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
client_type
</td>
<td>
str
</td>
<td>
Тип клиентов.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
description
</td>
<td>
str
</td>
<td>
Описание.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
domain_name
</td>
<td>
str
</td>
<td>
Имя домена.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
hostname
</td>
<td>
str
</td>
<td>
Имя хоста.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
ip_addr
</td>
<td>
str
</td>
<td>
IP-адрес.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
mac
</td>
<td>
str
</td>
<td>
MAC-адрес.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
type
</td>
<td>
str
</td>
<td>
Тип.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
vm_id
</td>
<td>
int
</td>
<td>
Идентификатор виртуальной машины.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
created_datetime
</td>
<td>
str
</td>
<td>
Дата и время создания.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
created_timestamp
</td>
<td>
int
</td>
<td>
Unix-время создания.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
devices
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
primary
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
device_id
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
iface01_name
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
iface02_name
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
secondary
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
grid_id
</td>
<td>
int
</td>
<td>
Идентификатор ЦОД.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
guid
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
id
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
lock_status
</td>
<td>
str
</td>
<td>
Статус блокировки.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
milestones
</td>
<td>
int
</td>
<td>
Количество событий.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
owner_id
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
owner_type
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
pure_virtual
</td>
<td>
bool
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
routes
</td>
<td>
list[dict[str, any]]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
status
</td>
<td>
str
</td>
<td>
Статус.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
tech_status
</td>
<td>
str
</td>
<td>
Технический статус.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
type
</td>
<td>
str
</td>
<td>
Тип.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
zone_id
</td>
<td>
int
</td>
<td>
Идентификатор зоны.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
gw
</td>
<td>
dict[str, any]
</td>
<td>
Словарь описывающий шлюз.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
account_id
</td>
<td>
int
</td>
<td>
Идентификатор аккаунта.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
config
</td>
<td>
dict[str, any]
</td>
<td>
Кофигурация шлюза.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
default_gw
</td>
<td>
str
</td>
<td>
Шлюз по умолчанию.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ext_net_id
</td>
<td>
int
</td>
<td>
Идентификатор внешней сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ext_net_ip
</td>
<td>
str
</td>
<td>
IP-адрес внешней сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
ext_net_prefix
</td>
<td>
int
</td>
<td>
Префикс внешней сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
qos
</td>
<td>
dict[str, any]
</td>
<td>
Quality of Service
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
created_datetime
</td>
<td>
str
</td>
<td>
Дата и время создания.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
created_timestamp
</td>
<td>
int
</td>
<td>
Unix-время создания.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
devices
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
primary
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
device_id
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
iface01_name
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
iface02_name
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
secondary
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
grid_id
</td>
<td>
int
</td>
<td>
Идентификатор ЦОД.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
guid
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
id
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
lock_status
</td>
<td>
str
</td>
<td>
Статус блокировки.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
milestones
</td>
<td>
int
</td>
<td>
Количество событий.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
owner_id
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
owner_type
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
pure_virtual
</td>
<td>
bool
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
routes
</td>
<td>
list[dict[str, any]]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
status
</td>
<td>
str
</td>
<td>
Статус.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
tech_status
</td>
<td>
str
</td>
<td>
Технический статус.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
type
</td>
<td>
str
</td>
<td>
Тип.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
zone_id
</td>
<td>
int
</td>
<td>
Идентификатор зоны.
</td>
</tr>
<tr>
<td></td>
<td colspan="5">
nat
</td>
<td>
dict[str, any]
</td>
<td>
Словарь описывающий NAT.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
account_id
</td>
<td>
int
</td>
<td>
Идентификатор аккаунта.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
config
</td>
<td>
dict[str, any]
</td>
<td>
Кофигурация NAT.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
net_ip
</td>
<td>
str
</td>
<td>
IP-адрес сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
net_prefix
</td>
<td>
int
</td>
<td>
Префикс сети.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
rules
</td>
<td>
list[dict[str, any]]
</td>
<td>
Правила.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
created_datetime
</td>
<td>
str
</td>
<td>
Дата и время создания.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
created_timestamp
</td>
<td>
int
</td>
<td>
Unix-время создания.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
devices
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
primary
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
device_id
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
iface01_name
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td colspan="2">
iface02_name
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td colspan="3">
secondary
</td>
<td>
dict[str, any]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
grid_id
</td>
<td>
int
</td>
<td>
Идентификатор ЦОД.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
guid
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
id
</td>
<td>
int
</td>
<td>
Идентификатор.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
lock_status
</td>
<td>
str
</td>
<td>
Статус блокировки.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
milestones
</td>
<td>
int
</td>
<td>
Количество событий.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
owner_id
</td>
<td>
int
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
owner_type
</td>
<td>
str
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
pure_virtual
</td>
<td>
bool
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
routes
</td>
<td>
list[dic[str, any]]
</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
status
</td>
<td>
str
</td>
<td>
Статус.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
tech_status
</td>
<td>
str
</td>
<td>
Технический статус.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
type
</td>
<td>
str
</td>
<td>
Тип.
</td>
</tr>
<tr>
<td></td>
<td></td>
<td colspan="4">
zone_id
</td>
<td>
int
</td>
<td>
Идентификатор зоны.
</td>
</tr>
<tr>
<td colspan="6">
vxlan_id
</td>
<td>
int
</td>
<td>
Идентификатор VXLAN.
</td>
</tr>
<tr>
<td colspan="6">
zone_id
</td>
<td>
int
</td>
<td>
Идентификатор зоны.
</td>
</tr>
</table>
## Пример использования модуля decort_vins
В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01").
Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0).
Результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks.
```
- name: Manage ViNS on resource group level
decort_vins:
account_name: "MyMainAccount"
rg_name: "MyRg01"
authenticator: jwt
jwt: "{{ my_jwt.jwt }}"
controller_url: "https://ds1.digitalenergy.online"
ext_net_id: 0
vins_name: "MyVins01"
register: my_vins
```
В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196.
```
- name: Manage ViNS on resource group level
decort_vins:
authenticator: jwt
jwt: "{{ my_jwt.jwt }}"
controller_url: "https://cloud.digitalenergy.online"
vins_name: "ViNS_connected_by_decort_vins_module"
rg_id: 98
connect_to:
- id: 864
ipaddr: 192.168.5.66
netmask: 24
- id: 196
ipaddr: 192.168.9.133
netmask: 24
register: managed_vins
```
Reference in New Issue Copy Permalink