Spec-Zone.ru › Ansible

Модуль cisco.intersight.intersight_iscsi_adapter_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_adapter_policy.

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

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

  • Создание, изменение и удаление политик адаптеров iSCSI в Cisco Intersight.
  • Политики адаптеров iSCSI настраивают параметры тайм-аута и повторных попыток для адаптеров iSCSI.
  • Эти политики управляют тайм-аутом TCP-соединения, тайм-аутом DHCP и поведением при повторных попытках в случае занятости LUN.
  • Дополнительные сведения см. в документации 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"

connection_time_out

integer

Количество секунд ожидания до того, как Cisco UCS сочтет, что первоначальный вход в систему не удался и адаптер iSCSI недоступен.

Значение тайм-аута TCP-соединения.

Допустимый диапазон — от 0 до 255 секунд.

По умолчанию: 15

description

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

string

Описание политики адаптера iSCSI, заданное пользователем.

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

dhcp_timeout

integer

Количество секунд ожидания до того, как инициатор сочтет DHCP-сервер недоступным.

Допустимый диапазон — от 60 до 300 секунд.

По умолчанию: 60

lun_busy_retry_count

integer

Количество повторных попыток подключения в случае сбоя при обнаружении LUN iSCSI.

Допустимый диапазон — от 0 до 60 повторных попыток.

По умолчанию: 15

name

string / обязательный

Имя, присвоенное политике адаптера iSCSI.

Имя должно быть уникальным в пределах организации.

Имя должно содержать от 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 iSCSI Adapter Policy with default settings
  cisco.intersight.intersight_iscsi_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "iscsi-adapter-default"
    description: "iSCSI adapter policy with default timeout values"
    state: present

- name: Create iSCSI Adapter Policy with custom timeout settings
  cisco.intersight.intersight_iscsi_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "iscsi-adapter-custom"
    description: "iSCSI adapter policy with custom timeouts"
    connection_time_out: 30
    dhcp_timeout: 120
    lun_busy_retry_count: 30
    tags:
      - Key: Environment
        Value: Production
    state: present

- name: Create iSCSI Adapter Policy with extended timeouts
  cisco.intersight.intersight_iscsi_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "Engineering"
    name: "iscsi-adapter-extended"
    description: "iSCSI adapter policy with extended timeout values"
    connection_time_out: 60
    dhcp_timeout: 300
    lun_busy_retry_count: 60
    state: present

- name: Create iSCSI Adapter Policy with minimal timeouts
  cisco.intersight.intersight_iscsi_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "iscsi-adapter-minimal"
    description: "iSCSI adapter policy with minimal timeout values"
    connection_time_out: 0
    dhcp_timeout: 60
    lun_busy_retry_count: 0
    state: present

- name: Update iSCSI Adapter Policy description
  cisco.intersight.intersight_iscsi_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "iscsi-adapter-default"
    description: "Updated iSCSI adapter policy description"
    state: present

- name: Delete iSCSI Adapter Policy
  cisco.intersight.intersight_iscsi_adapter_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "iscsi-adapter-default"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

Данные ответа API, возвращенные для указанного ресурса.

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

Пример: {"api_response": {"ConnectionTimeOut": 30, "Description": "iSCSI adapter policy with custom timeouts", "DhcpTimeout": 120, "LunBusyRetryCount": 30, "Moid": "1234567890abcdef12345678", "Name": "iscsi-adapter-custom", "ObjectType": "vnic.IscsiAdapterPolicy", "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_iscsi_adapter_policy_module.html

Spec-Zone.ru

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