Модуль community.general.packet_volume_attachment — присоединение/отсоединение тома к устройству на хосте Packet

Примечание

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

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

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

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

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

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

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

Присоединяет/отсоединяет том к устройству на хосте Packet.
Документация API доступна по адресу https://www.packet.com/developers/api/volumes/.
Этот модуль создает маршрут присоединения в API Packet. Чтобы обнаружить блочные устройства на сервере, необходимо запустить сценарии присоединения, описанные по адресу https://help.packet.net/technical/storage/packet-block-storage-linux.

Требования

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

packet-python >= 1.35

Параметры

Параметр	Комментарии
auth_token string	Токен API Packet. Его также можно указать в переменной среды `PACKET_API_TOKEN`.
device string	Селектор устройства. Это может быть UUID устройства или имя хоста. Примеры значений: 98a14f7a-3d27-4478-b7cf-35b5670523f3, “my device”.
project_id string / обязательный	UUID проекта, которому принадлежат устройство и том.
state string	Желаемое состояние подключения. Варианты: `"present"` ← (по умолчанию) `"absent"`
volume string / обязательный	Селектор тома. Это может быть UUID, созданное API имя тома или заданная пользователем строка описания. Примеры значений: `4a347482-b546-4f67-8300-fb5018ef0c5`, `volume-4a347482`, `my volume`.

Атрибуты

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

Примеры

# All the examples assume that you have your Packet API token in env var PACKET_API_TOKEN.
# You can also pass the api token in module param auth_token.

- hosts: localhost

  vars:
    volname: testvol
    devname: testdev
    project_id: 52000fb2-ee46-4673-93a8-de2c2bdba33b

  tasks:
    - name: Create volume
      community.general.packet_volume:
        description: "{{ volname }}"
        project_id: "{{ project_id }}"
        facility: ewr1
        plan: storage_1
        state: present
        size: 10
        snapshot_policy:
          snapshot_count: 10
          snapshot_frequency: 1day

    - name: Create a device
      community.general.packet_device:
        project_id: "{{ project_id }}"
        hostnames: "{{ devname }}"
        operating_system: ubuntu_16_04
        plan: baremetal_0
        facility: ewr1
        state: present

    - name: Attach testvol to testdev
      community.general.packet_volume_attachment:
        project_id: "{{ project_id }}"
        volume: "{{ volname }}"
        device: "{{ devname }}"

    - name: Detach testvol from testdev
      community.general.packet_volume_attachment:
        project_id: "{{ project_id }}"
        volume: "{{ volname }}"
        device: "{{ devname }}"
        state: absent

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

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

Ключ	Описание
device_id string	UUID устройства, к которому обращается вызов модуля. Возвращается: success
volume_id string	UUID тома, к которому обращается вызов модуля. Возвращается: success

Авторы

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_volume_attachment_module.html