модуль cisco.intersight.intersight_san_connectivity_policy_info — сбор информации о политиках подключения SAN и их vHBA в Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_san_connectivity_policy_info.
Обзор
- Получение информации о политиках подключения SAN и связанных с ними vHBA из Cisco Intersight.
- Запрос политик по организации или имени, а также фильтрация vHBA по шаблонам имён.
- Возвращает структурированные данные, объединяющие метаданные политик и подробные конфигурации vHBA.
- Поддерживает фильтрацию по организации, имени политики и имени vHBA.
- Если фильтры не заданы, будут возвращены все политики подключения SAN и их vHBA.
- Возвращает структурированные данные с информацией о политиках и связанных с ними vHBA.
Параметры
Параметр | Комментарии |
|---|---|
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. По умолчанию: |
name string | Точное имя политики подключения SAN, сведения о которой нужно получить. Если задано, будут возвращены только соответствующая политика и её vHBA. Можно использовать вместе с фильтром vhba_name, чтобы получить сведения об определённых vHBA конкретной политики. |
organization string | Имя организации, по которой нужно отфильтровать политики подключения SAN. Для организации по умолчанию используйте значение ‘default’. Если задано, будут возвращены только политики этой организации. |
use_proxy boolean | Если задано Варианты:
|
validate_certs boolean | Логический параметр, управляющий проверкой TLS-сертификата api_uri Варианты:
|
vhba_name string | Фильтрация vHBA по имени в политиках. Можно использовать как с фильтром по имени политики, так и без него. Поддерживается точное совпадение (например, “vhba-a” будет соответствовать только “vhba-a”). При использовании вместе с именем политики фильтрует vHBA в рамках этой политики. |
Примеры
# Basic Usage Examples
- name: Fetch all SAN Connectivity Policies and their vHBAs from all organizations
cisco.intersight.intersight_san_connectivity_policy_info:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
register: all_san_policies
# Organization-specific Examples
- name: Fetch all SAN Connectivity Policies from the default organization
cisco.intersight.intersight_san_connectivity_policy_info:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
register: default_org_policies
- name: Fetch all SAN Connectivity Policies from a custom organization
cisco.intersight.intersight_san_connectivity_policy_info:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "Engineering"
register: engineering_policies
# Specific Policy Examples
- name: Fetch a specific SAN Connectivity Policy by name with all its vHBAs
cisco.intersight.intersight_san_connectivity_policy_info:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "fi-attached-san-policy"
register: specific_policy
# vHBA Filtering Examples
- name: Find all policies containing a specific vHBA
cisco.intersight.intersight_san_connectivity_policy_info:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
vhba_name: "vhba-a"
register: policies_with_vhba_a
- name: Find specific vHBA in a specific policy
cisco.intersight.intersight_san_connectivity_policy_info:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "fi-attached-san-policy"
vhba_name: "vhba-b"
register: specific_vhba_in_policy
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, относящиеся только к этому модулю:
Ключ | Описание |
|---|---|
api_response dictionary | Ответ API, содержащий сведения о политике и vHBA. При запросе одной политики или отсутствии найденных политик возвращает словарь. Если найдено несколько политик, возвращает список. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_san_connectivity_policy_info_module.html
