Модуль community.general.packet_ip_subnet — назначение IP-подсети выделенному физическому серверу

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

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

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

Чтобы использовать его в плейбуке, укажите: community.general.packet_ip_subnet.

Добавлен в community.general 0.2.0

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

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

Назначение и отмена назначения подсетей IPv4 или IPv6 устройству на платформе Packet.
Подсети IPv4 должны принадлежать уже зарезервированному блоку.
Подсети IPv6 должны принадлежать общедоступному маршрутизируемому блоку /56 вашего проекта.
Дополнительную информацию о резервировании блоков IP-адресов см. на странице https://support.packet.com/kb/articles/elastic-ips.

Требования

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

packet-python >= 1.35

Параметры

Параметр	Комментарии
auth_token строка	Токен API Packet. Его также можно указать в переменной среды `PACKET_API_TOKEN`.
cidr псевдоним: name строка / обязательный	Подсеть IPv4 или IPv6, которой требуется управлять. Она должна принадлежать блоку, зарезервированному для вашего проекта на платформе Packet.
device_count целое число	Количество устройств, получаемых из проекта. Максимально допустимое значение — 1000. Дополнительную информацию см. на странице https://www.packet.com/developers/api/#retrieve-all-devices-of-a-project. По умолчанию: `100`
device_id строка	UUID устройства, которому назначается или с которого снимается подсеть.
hostname строка	Имя узла устройства, которому назначается или с которого снимается подсеть.
project_id строка	UUID проекта устройства, которому назначается или с которого снимается подсеть.
state строка	Требуемое состояние IP-подсети на указанном устройстве. При значении `state=present` необходимо указать либо `hostname`, либо `device_id`. После этого подсеть с указанным CIDR назначается указанному устройству. При значении `state=absent` можно указать либо `hostname`, либо `device_id`. После этого подсеть снимается с указанных устройств. Если оставить оба параметра — `hostname` и `device_id` — пустыми, подсеть будет снята с любого устройства, которому она назначена. Варианты: `"present"` ← (по умолчанию) `"absent"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примеры

# All the examples assume that you have your Packet API token in env var PACKET_API_TOKEN.
# You can also pass it to the auth_token parameter of the module instead.

- name: Create 1 device and assign an arbitrary public IPv4 subnet to it
  hosts: localhost
  tasks:

    - packet_device:
        project_id: 89b497ee-5afc-420a-8fb5-56984898f4df
        hostnames: myserver
        operating_system: ubuntu_16_04
        plan: baremetal_0
        facility: sjc1
        state: active

# Pick an IPv4 address from a block allocated to your project.

    - community.general.packet_ip_subnet:
        project_id: 89b497ee-5afc-420a-8fb5-56984898f4df
        hostname: myserver
        cidr: "147.75.201.78/32"

# Release IP address 147.75.201.78

- name: Unassign IP address from any device in your project
  hosts: localhost
  tasks:
    - community.general.packet_ip_subnet:
        project_id: 89b497ee-5afc-420a-8fb5-56984898f4df
        cidr: "147.75.201.78/32"
        state: absent

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

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

Ключ	Описание
device_id строка	UUID устройства, связанного с указанным IP-адресом. Возвращается: при успехе
subnet словарь	Словарь с данными об обрабатываемой IP-подсети. Возвращается: при успехе Пример: `{"address": "147.75.90.241", "address_family": 4, "assigned_to": {"href": "/devices/61f9aa5e-0530-47f5-97c2-113828e61ed0"}, "cidr": 31, "created_at": "2017-08-07T15:15:30Z", "enabled": true, "gateway": "147.75.90.240", "href": "/ips/31eda960-0a16-4c0f-b196-f3dc4928529f", "id": "1eda960-0a16-4c0f-b196-f3dc4928529f", "manageable": true, "management": true, "netmask": "255.255.255.254", "network": "147.75.90.240", "public": true}`

Ключ

Описание

device_id

строка

UUID устройства, связанного с указанным IP-адресом.

Возвращается: при успехе

subnet

словарь

Словарь с данными об обрабатываемой IP-подсети.

Возвращается: при успехе

Пример: {"address": "147.75.90.241", "address_family": 4, "assigned_to": {"href": "/devices/61f9aa5e-0530-47f5-97c2-113828e61ed0"}, "cidr": 31, "created_at": "2017-08-07T15:15:30Z", "enabled": true, "gateway": "147.75.90.240", "href": "/ips/31eda960-0a16-4c0f-b196-f3dc4928529f", "id": "1eda960-0a16-4c0f-b196-f3dc4928529f", "manageable": true, "management": true, "netmask": "255.255.255.254", "network": "147.75.90.240", "public": true}

Авторы

Tomas Karasek (@t0mk)
Nurfet Becirevic (@nurfet-becirevic)

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

© 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/community/general/packet_ip_subnet_module.html