Модуль hetzner.hcloud.subnetwork – управление облачными подсетями в Hetzner Cloud.

Примечание

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

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

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

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

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

Обзор

Создание, обновление и удаление облачных подсетей в Hetzner Cloud.

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

Требования

Следующие требования необходимы на узле, где выполняется этот модуль.

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`.
ip_range строка / обязательный	Диапазон IP-адресов подсети.
network строка / обязательный	Имя или ID сети Hetzner Cloud.
network_zone строка / обязательный	Имя сетевой зоны.
state строка	Состояние подсети. Варианты: `"absent"` `"present"` ← (по умолчанию)
type строка / обязательный	Тип подсети. Варианты: `"server"` `"cloud"` `"vswitch"`
vswitch_id целое число	ID vSwitch, который нужно связать с вашей сетью. Обязательный параметр, если type == vswitch

См. также

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

Примеры

- name: Create a basic subnetwork
  hetzner.hcloud.subnetwork:
    network: my-network
    ip_range: 10.0.0.0/16
    network_zone: eu-central
    type: cloud
    state: present

- name: Create a basic subnetwork
  hetzner.hcloud.subnetwork:
    network: my-vswitch-network
    ip_range: 10.0.0.0/24
    network_zone: eu-central
    type: vswitch
    vswitch_id: 123
    state: present

- name: Ensure the subnetwork is absent (remove if needed)
  hetzner.hcloud.subnetwork:
    network: my-network
    ip_range: 10.0.0.0/8
    network_zone: eu-central
    type: cloud
    state: absent

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

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

Ключ	Описание
hcloud_subnetwork словарь	Одна подсеть сети Возвращается: всегда
gateway строка	Шлюз подсети Возвращается: всегда Пример: `"10.0.0.1"`
ip_range строка	Диапазон IP-адресов сети Возвращается: всегда Пример: `"10.0.0.0/8"`
network строка	Имя сети Возвращается: всегда Пример: `"my-network"`
network_zone строка	Имя сетевой зоны Возвращается: всегда Пример: `"eu-central"`
type строка	Тип подсети Возвращается: всегда Пример: `"server"`
vswitch_id целое число	ID vswitch; null, если тип не vswitch Возвращается: всегда Пример: `123`

Авторы

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/subnetwork_module.html