Модуль cisco.intersight.intersight_imc_access_policy – Настройка политики доступа IMC для Cisco Intersight

Примечание

Этот модуль является частью коллекции cisco.intersight (версия 2.0.20).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.intersight.

Для использования в playbook, укажите: cisco.intersight.intersight_imc_access_policy.

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

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

Настройка политики доступа IMC для Cisco Intersight.
Используется для настройки IP-адресов и VLAN, используемых для внешнего подключения к Cisco IMC.
Для получения дополнительной информации см. Cisco Intersight.

Параметры

Параметр	Комментарии
api_key_id строка / обязательно	Идентификатор открытого API Key, связанный с закрытым ключом. Если не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID.
api_private_key путь / обязательно	Имя файла (абсолютный путь) или строка данных закрытого ключа в формате PEM, которые будут использоваться для аутентификации Intersight API. Если используется строка, для шифрования данных строки следует использовать 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 строка	URI, используемый для доступа к API Intersight. Если не задано, используется значение переменной среды INTERSIGHT_API_URI. Значение по умолчанию: `"https://intersight.com/api/v1"`
description псевдонимы: descr строка	Пользовательское описание политики доступа IMC. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или подчеркивание (_).
ip_pool строка / обязательно	Пул IP-адресов, используемый для назначения IP-адреса и других необходимых сетевых параметров.
name строка / обязательно	Имя, присвоенное политике доступа IMC. Имя должно содержать от 1 до 62 буквенно-цифровых символов, допускаются специальные символы :-_.
organization строка	Имя организации, которой назначен этот ресурс. Профили и политики, созданные в пользовательской организации, применимы только к устройствам в той же организации. Значение по умолчанию: `"default"`
out_of_band логическое	Если `true`, будет включена внеполосная конфигурация. Если `false`, будет включена внутриполосная конфигурация. Варианты: `false` ← (по умолчанию) `true`
state строка	Если `present`, будет проверено наличие ресурса и он будет создан при необходимости. Если `absent`, будет проверено отсутствие ресурса и он будет удален при необходимости. Варианты: `"present"` ← (по умолчанию) `"absent"`
tags список / элементы=словарь	Список тегов в формате Ключ:<пользовательский ключ> Значение:<пользовательское значение>.
use_proxy логическое	Если `no`, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах. Варианты: `false` `true` ← (по умолчанию)
validate_certs логическое	Логический параметр для проверки сертификата TLS api_uri Варианты: `false` `true` ← (по умолчанию)
vlan_id целое число	VLAN, который будет использоваться для доступа к серверу через внутриполосную сеть. Обязательно, если `out_of_band` равно `false`.

Примеры

- name: Configure IMC Access policy
  intersight_imc_access_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: sjc02-d23-access
    description: IMC access for SJC02 rack D23
    tags:
      - Site: D23
    vlan_id: 131
    ip_pool: sjc02-d23-ext-mgmt

- name: Delete IMC Access policy
  intersight_imc_access_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: sjc02-d23-access
    state: absent

Значения возврата

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

Ключ	Описание
api_repsonse словарь	Вывод ответа API, возвращаемый указанным ресурсом. Возвращается: всегда Пример: `{"api_response": {"Name": "sjc02-d23-access", "ObjectType": "access.Policy", "Profiles": [{"Moid": "5e4ec7ae77696e2d30840cfc", "ObjectType": "server.Profile"}, {"Moid": "5e84d78777696e2d302ec195", "ObjectType": "server.Profile"}], "Tags": [{"Key": "Site", "Value": "SJC02"}]}}`

Ключ

Описание

api_repsonse

словарь

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

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

Пример: {"api_response": {"Name": "sjc02-d23-access", "ObjectType": "access.Policy", "Profiles": [{"Moid": "5e4ec7ae77696e2d30840cfc", "ObjectType": "server.Profile"}, {"Moid": "5e84d78777696e2d302ec195", "ObjectType": "server.Profile"}], "Tags": [{"Key": "Site", "Value": "SJC02"}]}}

Авторы

David Soper (@dsoper2)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/intersight/intersight_imc_access_policy_module.html