Spec-Zone.ru › Ansible

Модуль 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.

По умолчанию: "https://intersight.com/api/v1"

description

псевдонимы: descr

string

Описание политики статических целей iSCSI, заданное пользователем.

Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчёркивания (_).

ip_protocol

string

Тип IP-адреса, запрашиваемого для vNIC iSCSI.

IPv4 или IPv6.

Обязателен, если state имеет значение present.

Варианты:

  • "IPv4"
  • "IPv6"

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’.

По умолчанию: "default"

port

integer

Порт, связанный с целью iSCSI.

Допустимый диапазон: 1–65535.

Стандартный порт iSCSI — 3260.

Обязателен, если state имеет значение present.

state

string

Если задано present, модуль проверит наличие ресурса и при необходимости создаст его.

Если задано absent, модуль проверит отсутствие ресурса и при необходимости удалит его.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

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

Если задано no, прокси-сервер использоваться не будет, даже если он определён в переменной окружения на целевых узлах.

Варианты:

  • false
  • true ← (по умолчанию)

validate_certs

boolean

Логический параметр, управляющий проверкой TLS-сертификата api_uri.

Варианты:

  • false
  • true ← (по умолчанию)

Примеры

- 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, возвращённый указанным ресурсом.

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

Пример: {"api_response": {"IpAddress": "192.168.10.100", "IscsiIpType": "IPv4", "Lun": {"LunId": 0}, "Moid": "1234567890abcdef12345678", "Name": "iscsi-static-target-policy-01", "ObjectType": "vnic.IscsiStaticTargetPolicy", "Organization": {"Moid": "abcdef1234567890abcdef12", "ObjectType": "organization.Organization"}, "Port": 3260, "Tags": [{"Key": "Environment", "Value": "Production"}], "TargetName": "iqn.1991-05.com.microsoft:winclient1"}}

Авторы

  • 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_iscsi_static_target_policy_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API