Модуль cisco.intersight.intersight_vsan_policy_info — сбор информации о политиках VSAN и связанных с ними VSAN в Cisco Intersight

Примечание

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

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

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

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

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

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

Получение информации о политиках VSAN (виртуальных сетей хранения данных) и связанных с ними VSAN из Cisco Intersight.
Поиск политик по организации или имени политики, а также фильтрация VSAN по шаблонам имен.
Возвращает структурированные данные, объединяющие метаданные политики с подробными конфигурациями VSAN.
Поддерживает фильтрацию по организации, имени политики и имени VSAN.
Если фильтры не заданы, возвращаются все политики VSAN и связанные с ними VSAN.
Возвращает структурированные данные с информацией о политике и сведениями о связанных с ней VSAN.

Параметры

Параметр	Комментарии
api_key_id string / обязательный	Идентификатор открытого API-ключа, связанного с закрытым ключом. Если параметр не задан, используется значение переменной окружения INTERSIGHT_API_KEY_ID.
api_private_key path / обязательный	Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM, используемого для аутентификации в API Intersight. Если используется строка, для шифрования строковых данных следует применять Ansible Vault. Ex. 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	Точное имя политики VSAN, сведения о которой требуется получить. Если параметр задан, возвращаются только соответствующая политика и связанные с ней VSAN. Можно сочетать с фильтром vsan_name, чтобы получить определенные VSAN из конкретной политики.
organization string	Имя организации для фильтрации политик VSAN. Для организации по умолчанию используйте ‘default’. Если параметр задан, возвращаются только политики этой организации.
use_proxy boolean	Если `no`, прокси-сервер использоваться не будет, даже если он задан в переменной окружения на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр, управляющий проверкой TLS-сертификата api_uri. Варианты: `false` `true` ← (по умолчанию)
vsan_name string	Фильтрация VSAN по имени в политиках. Можно использовать как с фильтром по имени политики, так и без него. Поддерживается точное совпадение (например, “vsan_uplink_100” будет соответствовать только “vsan_uplink_100”). При сочетании с именем политики фильтруются VSAN в рамках этой конкретной политики.

Примеры

# Basic Usage Examples
- name: Fetch all VSAN Policies and their VSANs from all organizations
  cisco.intersight.intersight_vsan_policy_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
  register: all_vsan_policies

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

- name: Fetch all VSAN Policies from a custom organization
  cisco.intersight.intersight_vsan_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 VSAN Policy by name with all its VSANs
  cisco.intersight.intersight_vsan_policy_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "datacenter-vsan-policy"
  register: specific_policy

# VSAN Filtering Examples
- name: Find all policies containing a specific VSAN
  cisco.intersight.intersight_vsan_policy_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    vsan_name: "vsan_uplink_100"
  register: policies_with_vsan_100

- name: Find specific VSAN in a specific policy
  cisco.intersight.intersight_vsan_policy_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "datacenter-vsan-policy"
    vsan_name: "vsan_storage_200"
  register: specific_vsan_in_policy

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

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

Ключ	Описание
api_response dictionary	Ответ API, содержащий сведения о политике и VSAN. При запросе одной политики или если политики не найдены, возвращается словарь. Если найдено несколько политик, возвращается список. Возвращается: всегда Пример: {"Description": "VSAN policy for datacenter SAN infrastructure", "EnableTrunking": false, "Moid": "12345678901234567890abcd", "Name": "datacenter-vsan-policy", "ObjectType": "fabric.FcNetworkPolicy", "Organization": {"Name": "default", "ObjectType": "organization.Organization"}, "Tags": [{"Key": "Site", "Value": "DataCenter-A"}, {"Key": "Environment", "Value": "Production"}], "vsans": [{"FcNetworkPolicy": {"Moid": "12345678901234567890abcd", "ObjectType": "fabric.FcNetworkPolicy"}, "FcoeVlan": 100, "Moid": "vsan12345678901234567890", "Name": "vsan_uplink_100", "ObjectType": "fabric.Vsan", "VsanId": 100, "VsanScope": "Uplink"}, {"FcNetworkPolicy": {"Moid": "12345678901234567890abcd", "ObjectType": "fabric.FcNetworkPolicy"}, "FcoeVlan": 200, "Moid": "vsan09876543210987654321", "Name": "vsan_storage_200", "ObjectType": "fabric.Vsan", "VsanId": 200, "VsanScope": "Storage"}]}

Ключ

Описание

api_response

dictionary

Ответ API, содержащий сведения о политике и VSAN.

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

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

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

Пример: {"Description": "VSAN policy for datacenter SAN infrastructure", "EnableTrunking": false, "Moid": "12345678901234567890abcd", "Name": "datacenter-vsan-policy", "ObjectType": "fabric.FcNetworkPolicy", "Organization": {"Name": "default", "ObjectType": "organization.Organization"}, "Tags": [{"Key": "Site", "Value": "DataCenter-A"}, {"Key": "Environment", "Value": "Production"}], "vsans": [{"FcNetworkPolicy": {"Moid": "12345678901234567890abcd", "ObjectType": "fabric.FcNetworkPolicy"}, "FcoeVlan": 100, "Moid": "vsan12345678901234567890", "Name": "vsan_uplink_100", "ObjectType": "fabric.Vsan", "VsanId": 100, "VsanScope": "Uplink"}, {"FcNetworkPolicy": {"Moid": "12345678901234567890abcd", "ObjectType": "fabric.FcNetworkPolicy"}, "FcoeVlan": 200, "Moid": "vsan09876543210987654321", "Name": "vsan_storage_200", "ObjectType": "fabric.Vsan", "VsanId": 200, "VsanScope": "Storage"}]}

Авторы

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