Модуль cisco.intersight.intersight_iscsi_static_target_policy — управление политиками статических целей iSCSI для Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_iscsi_static_target_policy.
Краткое описание
- Создание, обновление и удаление политик статических целей iSCSI в Cisco Intersight.
- Политика статических целей iSCSI позволяет настраивать цели iSCSI для интерфейсов vNIC iSCSI.
- Дополнительные сведения см. в документации 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. По умолчанию: |
description псевдонимы: descr string | Описание политики статических целей iSCSI, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчёркивания (_). |
ip_protocol string | Тип IP-адреса, запрашиваемого для vNIC iSCSI. IPv4 или IPv6. Обязателен, если state имеет значение present. Варианты:
|
ipv4_address string | IPv4-адрес, назначенный цели iSCSI. Обязателен, если ip_protocol имеет значение IPv4, а state — present. |
ipv6_address string | IPv6-адрес, назначенный цели iSCSI. Обязателен, если ip_protocol имеет значение IPv6, а state — present. |
lun_id integer | Идентификатор логического номера устройства (LUN) для цели iSCSI. Допустимые значения: 0 или больше (обычно 0–255). Обязателен, если state имеет значение present. |
name string / обязательный | Имя, назначенное политике статических целей iSCSI. Должно быть уникальным в пределах организации. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_. |
organization string | Имя организации, которой назначен этот ресурс. Политики, созданные в пользовательской организации, применимы только к устройствам той же организации. Для организации по умолчанию используйте значение ‘default’. По умолчанию: |
port integer | Порт, связанный с целью iSCSI. Допустимый диапазон: 1–65535. Стандартный порт iSCSI — 3260. Обязателен, если state имеет значение present. |
state string | Если задано Если задано Варианты:
|
tags list / элементы=dictionary | Список тегов в формате «Ключ:<заданный пользователем ключ> Значение:<заданное пользователем значение>». |
target_name string | Полное имя (IQN) или имя расширенного уникального идентификатора (EUI) цели iSCSI. Это имя однозначно идентифицирует цель в сети iSCSI. Пример формата IQN — iqn.1991-05.com.microsoft:winclient1 Пример формата EUI — eui.02004567A425678D Обязателен, если state имеет значение present. |
use_proxy boolean | Если задано Варианты:
|
validate_certs boolean | Логический параметр, управляющий проверкой TLS-сертификата api_uri. Варианты:
|
Примеры
- name: Create an iSCSI Static Target Policy with IPv4
cisco.intersight.intersight_iscsi_static_target_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "iscsi-static-target-policy-01"
description: "iSCSI static target policy for production servers"
target_name: "iqn.1991-05.com.microsoft:winclient1"
port: 3260
lun_id: 0
ip_protocol: "IPv4"
ipv4_address: "192.168.10.100"
tags:
- Key: "Environment"
Value: "Production"
- Key: "Owner"
Value: "Storage-Team"
state: present
- name: Create an iSCSI Static Target Policy with IPv6
cisco.intersight.intersight_iscsi_static_target_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "iscsi-static-target-policy-ipv6"
description: "iSCSI static target policy with IPv6 addressing"
target_name: "iqn.2001-04.com.example:storage.disk2"
port: 3260
lun_id: 1
ip_protocol: "IPv6"
ipv6_address: "2001:0db8:85a3:0000:0000:8a2e:0370:7334"
state: present
- name: Update an existing iSCSI Static Target Policy
cisco.intersight.intersight_iscsi_static_target_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "iscsi-static-target-policy-01"
description: "Updated description for iSCSI target policy"
target_name: "iqn.1991-05.com.microsoft:winclient1"
port: 3260
lun_id: 2
ip_protocol: "IPv4"
ipv4_address: "192.168.10.101"
state: present
- name: Delete an iSCSI Static Target Policy
cisco.intersight.intersight_iscsi_static_target_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "iscsi-static-target-policy-01"
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
api_response dictionary | Ответ API, возвращённый указанным ресурсом. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_iscsi_static_target_policy_module.html