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

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

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

Создание, обновление и удаление политик VSAN (виртуальных сетей хранения данных) в Cisco Intersight.
Дополнительную информацию см. в документации 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	Описание политики VSAN, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчеркивания (_).
enable_trunking boolean	Включение или отключение транкинга VSAN в политике. Если транкинг включен, несколько VSAN могут передаваться по одному физическому каналу. Варианты: `false` ← (по умолчанию) `true`
name string / обязательный	Имя, присвоенное политике VSAN. Имя должно быть уникальным в пределах организации. Имя должно содержать от 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` ← (по умолчанию)
vsans list / элементы=dictionary	Список VSAN для создания и добавления в политику VSAN. Каждый VSAN представляет собой виртуальный сегмент SAN. Оставьте список пустым, чтобы создать политику без VSAN и настроить их вручную позже.
fcoe_vlan_id integer	Идентификатор VLAN FCoE, связанный с конфигурацией VSAN. Значение должно находиться в диапазоне от 2 до 4093. Идентификаторы VLAN 4043–4047, 4094 и 4095 зарезервированы для системного использования. Обязателен, если state имеет значение present.
name string / обязательный	Имя конфигурации VSAN, заданное пользователем. Имя должно быть уникальным в пределах политики VSAN.
state string	Создать или обновить VSAN либо удалить его. Варианты: `"present"` ← (по умолчанию) `"absent"`
vsan_id integer / обязательный	Идентификатор виртуальной SAN на коммутаторе. Допустимый диапазон обычно составляет 1–4094. Идентификатор должен быть уникальным в пределах домена межсоединения fabric.
vsan_scope string	Указывает, определен ли идентификатор VSAN для трафика хранилища, восходящего канала или обоих типов трафика в FI. Обязателен, если state имеет значение present. Варианты: `"uplink"` `"storage"` `"common"`

Примеры

- name: Create a VSAN Policy with multiple VSANs
  cisco.intersight.intersight_vsan_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "datacenter-vsan-policy"
    description: "VSAN policy for datacenter SAN infrastructure"
    enable_trunking: false
    tags:
      - Key: "Environment"
        Value: "Production"
      - Key: "Site"
        Value: "DataCenter-A"
    vsans:
      - name: "vsan_uplink_100"
        vsan_id: 100
        fcoe_vlan_id: 100
        vsan_scope: "uplink"
      - name: "vsan_storage_200"
        vsan_id: 200
        fcoe_vlan_id: 200
        vsan_scope: "storage"
      - name: "vsan_common_300"
        vsan_id: 300
        fcoe_vlan_id: 300
        vsan_scope: "common"
    state: present

- name: Create a VSAN Policy with trunking enabled
  cisco.intersight.intersight_vsan_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "trunked-vsan-policy"
    description: "VSAN policy with trunking enabled"
    enable_trunking: true
    vsans:
      - name: "vsan_fabric_a"
        vsan_id: 10
        fcoe_vlan_id: 10
        vsan_scope: "common"
      - name: "vsan_fabric_b"
        vsan_id: 20
        fcoe_vlan_id: 20
        vsan_scope: "common"
    state: present

- name: Create a VSAN Policy without VSANs (for manual configuration)
  cisco.intersight.intersight_vsan_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "Engineering"
    name: "empty-vsan-policy"
    description: "Empty policy for manual VSAN configuration"
    enable_trunking: false
    state: present

- name: Update an existing VSAN Policy
  cisco.intersight.intersight_vsan_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "datacenter-vsan-policy"
    description: "Updated description for datacenter SAN infrastructure"
    enable_trunking: true
    tags:
      - Key: "Environment"
        Value: "Production"
      - Key: "Site"
        Value: "DataCenter-A"
      - Key: "Updated"
        Value: "2024-01-01"
    state: present

- name: Delete a VSAN from a policy
  cisco.intersight.intersight_vsan_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "datacenter-vsan-policy"
    vsans:
      - name: "vsan_uplink_100"
        vsan_id: 100
        fcoe_vlan_id: 100
        vsan_scope: "uplink"
      - name: "vsan_storage_200"
        vsan_id: 200
        fcoe_vlan_id: 200
        vsan_scope: "storage"
        state: absent
    state: present

- name: Delete a VSAN Policy
  cisco.intersight.intersight_vsan_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "datacenter-vsan-policy"
    state: absent

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

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

Ключ	Описание
api_response dictionary	Выходные данные ответа API, возвращенные указанным ресурсом. Возвращается: всегда Пример: `{"api_response": {"EnableTrunking": false, "Name": "datacenter-vsan-policy", "ObjectType": "fabric.FcNetworkPolicy", "Tags": [{"Key": "Site", "Value": "DataCenter-A"}], "vsans": [{"FcoeVlan": 100, "Name": "vsan_uplink_100", "ObjectType": "fabric.Vsan", "VsanId": 100, "VsanScope": "Uplink"}]}}`

Ключ

Описание

api_response

dictionary

Выходные данные ответа API, возвращенные указанным ресурсом.

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

Пример: {"api_response": {"EnableTrunking": false, "Name": "datacenter-vsan-policy", "ObjectType": "fabric.FcNetworkPolicy", "Tags": [{"Key": "Site", "Value": "DataCenter-A"}], "vsans": [{"FcoeVlan": 100, "Name": "vsan_uplink_100", "ObjectType": "fabric.Vsan", "VsanId": 100, "VsanScope": "Uplink"}]}}

Авторы

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