Модуль hetzner.hcloud.network — создание сетей Hetzner Cloud и управление ими.

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 6.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install hetzner.hcloud. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hetzner.hcloud.network.

Краткое описание
Требования
Параметры
См. также
Примеры
Возвращаемые значения

Краткое описание

Создание сетей Hetzner Cloud и управление ими.
Требуется hcloud-python версии не ниже 1.3.0.

Псевдонимы: hcloud_network

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint строка	Адрес конечной точки API Hetzner Cloud. Этот параметр также можно задать с помощью переменной окружения `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner строка	Адрес конечной точки API Hetzner. Этот параметр также можно задать с помощью переменной окружения `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token строка / обязательный	Токен для API Hetzner Cloud. Этот параметр также можно задать с помощью переменной окружения `HCLOUD_TOKEN`.
delete_protection логическое значение	Защитить сеть от удаления. Варианты: `false` `true`
expose_routes_to_vswitch логическое значение	Указывает, следует ли передавать маршруты из этой сети в подключение vSwitch. Передача маршрутов осуществляется только при активном подключении vSwitch. Варианты: `false` `true`
id целое число	Идентификатор сети Hetzner Cloud, которой нужно управлять. Обязателен, если имя сети name не указано.
ip_range строка	Диапазон IP-адресов сети. Обязателен, если сеть не существует.
labels словарь	Пользовательские метки (пары «ключ-значение»).
name строка	Имя сети Hetzner Cloud, которой нужно управлять. Обязательно, если идентификатор сети id не указан или сеть не существует.
state строка	Состояние сети. Варианты: `"absent"` `"present"` ← (по умолчанию)

См. также

Документация по API Hetzner: Полный справочник по API Hetzner.

Примеры

- name: Create a basic network
  hetzner.hcloud.network:
    name: my-network
    ip_range: 10.0.0.0/8
    state: present

- name: Ensure the Network is absent (remove if needed)
  hetzner.hcloud.network:
    name: my-network
    state: absent

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

Общие возвращаемые значения описаны здесь; ниже перечислены поля, относящиеся только к этому модулю:

Ключ	Описание
hcloud_network словарь	Сеть Возвращается: всегда
delete_protection логическое значение добавлено в hetzner.hcloud 0.1.0	True, если сеть защищена от удаления Возвращается: всегда Пример: `false`
expose_routes_to_vswitch логическое значение	Указывает, следует ли передавать маршруты из этой сети в подключение vSwitch. Возвращается: всегда Пример: `false`
id целое число	Идентификатор сети Возвращается: всегда Пример: `12345`
ip_range строка	Диапазон IP-адресов сети Возвращается: всегда Пример: `"10.0.0.0/8"`
labels словарь	Пользовательские метки (пары «ключ-значение») Возвращается: всегда Пример: `{"key": "value", "mylabel": 123}`
name строка	Имя сети Возвращается: всегда Пример: `"my-volume"`

Авторы

Lukas Kaemmerling (@lkaemmerling)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/hetzner/hcloud/network_module.html