Модуль community.digitalocean.digital_ocean_firewall_info – Сбор информации о брандмауэрах DigitalOcean

Примечание

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

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

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

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

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

Описание

Этот модуль позволяет собирать информацию о брандмауэрах DigitalOcean.
Этот модуль назывался digital_ocean_firewall_facts до Ansible 2.9. Способ использования не изменился.

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

Требования

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

python >= 2.6

Параметры

Параметр	Комментарии
baseurl строка	Базовый URL API DigitalOcean. По умолчанию: `"https://api.digitalocean.com/v2"`
name строка	Имя правила брандмауэра, используемое для идентификации и ссылки на конкретное правило.
oauth_token псевдонимы: api_token строка	Токен DigitalOcean OAuth. Можно использовать несколько переменных окружения для указания этого значения. Например, - `DO_API_TOKEN`, `DO_API_KEY`, `DO_OAUTH_TOKEN` и `OAUTH_TOKEN`.
timeout целое число	Таймаут в секундах для опроса API DigitalOcean. По умолчанию: `30`
validate_certs логическое значение	Если установлено `no`, сертификаты SSL не будут проверены. Это следует установить только в `no`, используемых на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов. Варианты: `false` `true` ← (по умолчанию)

Примеры

- name: Gather information about all firewalls
  community.digitalocean.digital_ocean_firewall_info:
    oauth_token: "{{ oauth_token }}"

- name: Gather information about a specific firewall by name
  community.digitalocean.digital_ocean_firewall_info:
    oauth_token: "{{ oauth_token }}"
    name: "firewall_name"

- name: Gather information from a firewall rule
  community.digitalocean.digital_ocean_firewall_info:
    name: SSH
  register: resp_out

- set_fact:
    firewall_id: "{{ resp_out.data.id }}"

- debug:
    msg: "{{ firewall_id }}"

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

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

Ключ	Описание
data список / элементы=словарь	Информация о брандмауэре DigitalOcean Возвращается: успех Пример: `[{"created_at": "2018-01-15T07:04:25Z", "droplet_ids": [87426985], "id": "435tbg678-1db53-32b6-t543-28322569t252", "inbound_rules": [{"ports": "9100", "protocol": "tcp", "sources": {"addresses": ["1.1.1.1"]}}], "name": "metrics", "outbound_rules": [], "pending_changes": [], "status": "succeeded", "tags": []}]`

Ключ

Описание

data

список / элементы=словарь

Информация о брандмауэре DigitalOcean

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

Пример: [{"created_at": "2018-01-15T07:04:25Z", "droplet_ids": [87426985], "id": "435tbg678-1db53-32b6-t543-28322569t252", "inbound_rules": [{"ports": "9100", "protocol": "tcp", "sources": {"addresses": ["1.1.1.1"]}}], "name": "metrics", "outbound_rules": [], "pending_changes": [], "status": "succeeded", "tags": []}]

Авторы

Anthony Bond (@BondAnthony)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/digitalocean/digital_ocean_firewall_info_module.html