Модуль cisco.intersight.intersight_fibre_channel_zone_policy_info — сбор информации о политиках зон Fibre Channel в Cisco Intersight

Примечание

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

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

Для установки используйте: ansible-galaxy collection install cisco.intersight.

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

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

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

Получение подробной информации о политиках зон Fibre Channel из Cisco Intersight.
Поиск политик по организации или имени политики.
Целевые объекты FC встроены в объект политики в виде массива FcTargetMembers.
Если фильтры не заданы, возвращаются все политики зон FC.

Параметры

Параметр	Комментарии
api_key_id string / обязательный	Идентификатор открытого API-ключа, связанного с закрытым ключом. Если значение не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID.
api_private_key path / обязательный	Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM, используемая для аутентификации в Intersight API. Если используется строка, для ее шифрования следует использовать 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 для доступа к Intersight API. Если значение не задано, используется значение переменной среды INTERSIGHT_API_URI. По умолчанию: `"https://intersight.com/api/v1"`
name string	Точное имя политики зон FC, сведения о которой нужно получить. Если указано, будет возвращена только соответствующая политика.
organization string	Имя организации для фильтрации политик зон FC. Для организации по умолчанию используйте ‘default’. Если указано, будут возвращены только политики этой организации.
use_proxy boolean	Если значение `no`, прокси-сервер использоваться не будет, даже если он задан в переменной среды на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр для проверки TLS-сертификата api_uri Варианты: `false` `true` ← (по умолчанию)

Примеры

# Basic Usage Examples
- name: Fetch all FC Zone Policies from all organizations
  cisco.intersight.intersight_fibre_channel_zone_policy_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
  register: all_fc_zone_policies

- name: Display all policies
  debug:
    msg: "Found {{ all_fc_zone_policies.api_response | length }} FC Zone Policies"

# Organization-specific Examples
- name: Fetch all FC Zone Policies from the default organization
  cisco.intersight.intersight_fibre_channel_zone_policy_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
  register: default_org_policies

- name: Fetch all FC Zone Policies from a custom organization
  cisco.intersight.intersight_fibre_channel_zone_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 FC Zone Policy by name
  cisco.intersight.intersight_fibre_channel_zone_policy_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "fc-zone-policy-simt"
  register: specific_policy

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

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

Ключ	Описание
api_response dictionary	Ответ API с информацией о политике, включая встроенные целевые объекты FC. При запросе одной политики возвращает словарь. Если найдено несколько политик, возвращает список. Возвращается: всегда Пример: {"Description": "FC Zone policy with SIMT zoning", "FcTargetMembers": [{"Name": "target1", "SwitchId": "A", "VsanId": 100, "Wwpn": "21:00:00:e0:8b:05:05:04"}, {"Name": "target2", "SwitchId": "B", "VsanId": 100, "Wwpn": "21:00:00:e0:8b:05:05:03"}], "FcTargetZoningType": "SIMT", "Moid": "12345678901234567890abcd", "Name": "fc-zone-policy-simt", "ObjectType": "fabric.FcZonePolicy", "Organization": {"Name": "default", "ObjectType": "organization.Organization"}, "Tags": [{"Key": "Environment", "Value": "Production"}]}

Ключ

Описание

api_response

dictionary

Ответ API с информацией о политике, включая встроенные целевые объекты FC.

При запросе одной политики возвращает словарь.

Если найдено несколько политик, возвращает список.

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

Пример: {"Description": "FC Zone policy with SIMT zoning", "FcTargetMembers": [{"Name": "target1", "SwitchId": "A", "VsanId": 100, "Wwpn": "21:00:00:e0:8b:05:05:04"}, {"Name": "target2", "SwitchId": "B", "VsanId": 100, "Wwpn": "21:00:00:e0:8b:05:05:03"}], "FcTargetZoningType": "SIMT", "Moid": "12345678901234567890abcd", "Name": "fc-zone-policy-simt", "ObjectType": "fabric.FcZonePolicy", "Organization": {"Name": "default", "ObjectType": "organization.Organization"}, "Tags": [{"Key": "Environment", "Value": "Production"}]}

Авторы

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