модуль hetzner.hcloud.server_network — управление связью между сетями Hetzner Cloud и серверами

Примечание

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

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

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

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

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

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

Создание и удаление связи между сетями Hetzner Cloud и серверами

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

Требования

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

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
alias_ips list / elements=string	IP-адреса-псевдонимы сервера.
api_endpoint псевдонимы: endpoint string	Конечная точка API Hetzner Cloud. Этот параметр также можно задать с помощью переменной среды `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner string	Конечная точка API Hetzner. Этот параметр также можно задать с помощью переменной среды `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token string / обязательный	Токен для API Hetzner Cloud. Этот параметр также можно задать с помощью переменной среды `HCLOUD_TOKEN`.
ip string	IP-адрес, который должен быть назначен серверу.
ip_range string	Диапазон IP-адресов подсети в нотации CIDR, к которой выполняется подключение.
network string / обязательный	Имя или идентификатор сети Hetzner Cloud.
server string / обязательный	Имя или идентификатор сервера Hetzner Cloud.
state string	Состояние server_network. Варианты: `"absent"` `"present"` ← (по умолчанию)

См. также

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

Примеры

- name: Create a basic server network
  hetzner.hcloud.server_network:
    network: my-network
    server: my-server
    state: present

- name: Create a server network and specify the ip address
  hetzner.hcloud.server_network:
    network: my-network
    server: my-server
    ip: 10.0.0.1
    state: present

- name: Create a server network and specify the subnet
  hetzner.hcloud.server_network:
    network: my-network
    server: my-server
    ip_range: 10.1.0.0/24
    state: present

- name: Create a server network and add alias ips
  hetzner.hcloud.server_network:
    network: my-network
    server: my-server
    ip: 10.0.0.1
    alias_ips:
      - 10.1.0.1
      - 10.2.0.1
    state: present

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

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

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

Ключ	Описание
hcloud_server_network dictionary	Связь между сервером и сетью Возвращается: всегда
alias_ips list / elements=string	IP-адреса-псевдонимы сервера в диапазоне IP-адресов сети Возвращается: всегда Пример: `["10.1.0.1", "..."]`
ip string	IP-адрес сервера в диапазоне IP-адресов сети Возвращается: всегда Пример: `"10.0.0.8"`
network string	Имя сети Возвращается: всегда Пример: `"my-network"`
server string	Имя сервера Возвращается: всегда Пример: `"my-server"`

Авторы

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