Модуль cisco.intersight.intersight_mac_pool_info — Сбор информации о пуле MAC-адресов в Cisco Intersight

Примечание

Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).

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

Чтобы установить коллекцию, используйте: ansible-galaxy collection install cisco.intersight.

Чтобы использовать ее в плейбуке, укажите: cisco.intersight.intersight_mac_pool_info.

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

Обзор

Сбор информации о пуле MAC-адресов в Cisco Intersight.
Информацию можно отфильтровать по организации и имени. Если ни один параметр не указан, будут получены сведения обо всех существующих пулах MAC-адресов.

Параметры

Параметр	Комментарии
api_key_id string / обязательный	Идентификатор открытого ключа API, связанного с закрытым ключом. Если не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID.
api_private_key path / обязательный	Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM, используемого для аутентификации в API Intersight. Если используется строка, для ее шифрования следует использовать Ansible vault. Например: ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file ‘-----BEGIN EC PRIVATE KEY----- <your private key data> -----END EC PRIVATE KEY-----’ Если не задано, используется значение переменной среды INTERSIGHT_API_PRIVATE_KEY.
api_uri string	URI для доступа к API Intersight. Если не задано, используется значение переменной среды INTERSIGHT_API_URI. По умолчанию: `"https://intersight.com/api/v1"`
name string	Имя пула MAC-адресов, сведения о котором будут собраны.
organization string	Имя организации, сведения о которой будут собраны.
use_proxy boolean	Если `no`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр, управляющий проверкой TLS-сертификата api_uri. Варианты: `false` `true` ← (по умолчанию)

Примеры

- name: Fetch mac pool information by name
  cisco.intersight.intersight_mac_pool_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: mac_pool_1

- name: Fetch all mac pool information
  cisco.intersight.intersight_mac_pool_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"

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

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

Ключ	Описание
api_response dictionary	Ответ API, возвращенный указанным ресурсом. Возвращается: всегда Пример: `{"api_response": [{"Name": "mac_pool_1", "ObjectType": "macpool.Pool", "Tags": [{"Key": "Site", "Value": "tag1"}, {"Key": "Site2", "Value": "tag2"}]}, {"Name": "mac_pool_2", "ObjectType": "macpool.Pool", "Tags": [{"Key": "Site1", "Value": "tag1"}, {"Key": "Site2", "Value": "tag2"}]}]}`

Ключ

Описание

api_response

dictionary

Ответ API, возвращенный указанным ресурсом.

Возвращается: всегда

Пример: {"api_response": [{"Name": "mac_pool_1", "ObjectType": "macpool.Pool", "Tags": [{"Key": "Site", "Value": "tag1"}, {"Key": "Site2", "Value": "tag2"}]}, {"Name": "mac_pool_2", "ObjectType": "macpool.Pool", "Tags": [{"Key": "Site1", "Value": "tag1"}, {"Key": "Site2", "Value": "tag2"}]}]}

Авторы

Ron Gershburg (@rgershbu)

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

© 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/cisco/intersight/intersight_mac_pool_info_module.html