модуль cisco.intersight.intersight_fibre_channel_zone_policy — управление политиками зон 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.

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

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

Создание, обновление и удаление политик зон Fibre Channel в Cisco Intersight.
Управление целевыми участниками FC (зонами) в политиках зон FC.
Политики зон FC определяют конфигурации зонирования для сетей Fibre Channel.
Поддерживаются типы зонирования SIST (один инициатор — одна цель), SIMT (один инициатор — несколько целей) и None.
Если тип зонирования — None, добавлять цели нельзя, а существующие цели будут отключены.
Дополнительную информацию см. в разделе Cisco Intersight.

Параметры

Параметр	Комментарии
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"`
description псевдонимы: descr string	Описание политики зон Fibre Channel, заданное пользователем. Описание может содержать буквы (a–z, A–Z), цифры (0–9), дефис (-), точку (.), двоеточие (:) или подчёркивание (_).
fc_target_members list / элементы=dictionary	Список целевых участников FC (зон), которые нужно создать в политике зон FC. Каждая цель задаёт WWPN, являющийся участником зоны FC. Оставьте список пустым, если для fc_target_zoning_type задано None.
name string / обязательный	Идентификатор имени целевого участника FC. Имя должно быть уникальным в пределах политики.
switch_id string	Уникальный идентификатор объекта Fabric. Указывает, с каким коммутатором Fabric Interconnect связана цель. Допустимые значения: `"A"` ← (по умолчанию) `"B"`
vsan_id integer / обязательный	Идентификатор VSAN с областью действия Storage, заданной в политике VSAN. Значение должно быть в диапазоне от 1 до 4093.
wwpn string / обязательный	Имя порта в глобальной сети (WWPN), являющееся участником зоны FC. Формат: шестнадцатеричные значения, разделённые двоеточиями (например, 21:00:00:e0:8b:05:05:04). Значение должно соответствовать допустимому формату WWPN.
fc_target_zoning_type string	Тип конфигурации зонирования FC. `SIST` — зонирование «один инициатор — одна цель». `SIMT` — зонирование «один инициатор — несколько целей». `None` — без зонирования. Если выбрано None, добавлять цели нельзя, а существующие цели будут отключены. Допустимые значения: `"SIST"` `"SIMT"` `"None"` ← (по умолчанию)
name string / обязательный	Имя, присвоенное политике зон Fibre Channel. Имя должно быть уникальным в пределах организации. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.
organization string	Имя организации, которой назначен этот ресурс. Политики, созданные в пользовательской организации, применимы только к устройствам этой организации. Для организации по умолчанию используйте ‘default’. По умолчанию: `"default"`
state string	Если задано `present`, будет проверено наличие ресурса, и при необходимости он будет создан. Если задано `absent`, будет проверено отсутствие ресурса, и при необходимости он будет удалён. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
tags list / элементы=dictionary	Список тегов в формате «Ключ:<ключ, заданный пользователем> Значение:<значение, заданное пользователем>».
use_proxy boolean	Если задано `no`, прокси использоваться не будет, даже если он задан в переменной окружения на целевых узлах. Допустимые значения: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр, определяющий, проверяется ли TLS-сертификат api_uri. Допустимые значения: `false` `true` ← (по умолчанию)

Примеры

- name: Create FC Zone Policy with SIMT zoning and multiple targets
  cisco.intersight.intersight_fibre_channel_zone_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "fc-zone-policy-simt"
    description: "FC Zone policy with SIMT zoning"
    fc_target_zoning_type: SIMT
    fc_target_members:
      - name: "target1"
        wwpn: "21:00:00:e0:8b:05:05:04"
        switch_id: A
        vsan_id: 100
      - name: "target2"
        wwpn: "21:00:00:e0:8b:05:05:03"
        switch_id: B
        vsan_id: 100
      - name: "target3"
        wwpn: "21:00:00:e0:8b:05:05:09"
        switch_id: A
        vsan_id: 200
    tags:
      - Key: Environment
        Value: Production
    state: present

- name: Create FC Zone Policy with SIST zoning
  cisco.intersight.intersight_fibre_channel_zone_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "fc-zone-policy-sist"
    description: "FC Zone policy with SIST zoning"
    fc_target_zoning_type: SIST
    fc_target_members:
      - name: "single-target"
        wwpn: "21:00:00:e0:8b:05:05:01"
        switch_id: A
        vsan_id: 100
    state: present

- name: Create FC Zone Policy with no zoning (None type)
  cisco.intersight.intersight_fibre_channel_zone_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "fc-zone-policy-none"
    description: "FC Zone policy with no zoning"
    fc_target_zoning_type: None
    state: present

- name: Update FC Zone Policy - add new target
  cisco.intersight.intersight_fibre_channel_zone_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "fc-zone-policy-simt"
    description: "Updated FC Zone policy"
    fc_target_zoning_type: SIMT
    fc_target_members:
      - name: "target1"
        wwpn: "21:00:00:e0:8b:05:05:04"
        switch_id: A
        vsan_id: 100
      - name: "target2"
        wwpn: "21:00:00:e0:8b:05:05:03"
        switch_id: B
        vsan_id: 100
      - name: "target3"
        wwpn: "21:00:00:e0:8b:05:05:09"
        switch_id: A
        vsan_id: 200
      - name: "target4"
        wwpn: "21:00:00:e0:8b:05:05:10"
        switch_id: B
        vsan_id: 200
    state: present

- name: Update FC Zone Policy - remove a target (only specify remaining targets)
  cisco.intersight.intersight_fibre_channel_zone_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "fc-zone-policy-simt"
    fc_target_zoning_type: SIMT
    fc_target_members:
      - name: "target1"
        wwpn: "21:00:00:e0:8b:05:05:04"
        switch_id: A
        vsan_id: 100
      - name: "target3"
        wwpn: "21:00:00:e0:8b:05:05:09"
        switch_id: A
        vsan_id: 200
    state: present

- name: Delete FC Zone Policy
  cisco.intersight.intersight_fibre_channel_zone_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "fc-zone-policy-simt"
    state: absent

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

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

Ключ	Описание
api_response dictionary	Ответ API, возвращённый указанным ресурсом. Возвращается: всегда Пример: {"api_response": {"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": "1234567890abcdef12345678", "Name": "fc-zone-policy-simt", "ObjectType": "fabric.FcZonePolicy", "Organization": {"Moid": "abcdef1234567890abcdef12", "ObjectType": "organization.Organization"}, "Tags": [{"Key": "Environment", "Value": "Production"}]}}

Ключ

Описание

api_response

dictionary

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

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

Пример: {"api_response": {"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": "1234567890abcdef12345678", "Name": "fc-zone-policy-simt", "ObjectType": "fabric.FcZonePolicy", "Organization": {"Moid": "abcdef1234567890abcdef12", "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_module.html