модуль cisco.intersight.intersight_imc_access_policy — настройка политики доступа IMC для Cisco Intersight

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install cisco.intersight.

Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_imc_access_policy.

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

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

Настройка политики доступа IMC для Cisco Intersight.
Используется для настройки IP-адресов и VLAN, применяемых для внешнего подключения к Cisco IMC.
Дополнительную информацию см. в разделе 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	Описание политики доступа IMC, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчёркивания (_).
ip_pool dictionary / обязательный	Пул IP-адресов для назначения IP-адреса и других необходимых сетевых параметров.
name string / обязательный	Имя пула IP-адресов для назначения IP-адреса и других необходимых сетевых параметров.
organization string	Имя организации, которой принадлежит пул IP-адресов. Если значение не задано, используется значение `organization`. Задайте это значение, если политика доступа IMC должна использовать пул IP-адресов из другой организации.
name string / обязательный	Имя, присвоенное политике доступа IMC. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.
organization string	Имя организации, которой назначен этот ресурс. Профили и политики, созданные в пользовательской организации, применимы только к устройствам в той же организации. По умолчанию: `"default"`
out_of_band boolean	Если значение — `true`, будет включена настройка внеполосного управления. Если значение — `false`, будет включена внутриполосная настройка. Варианты: `false` ← (по умолчанию) `true`
state string	Если значение — `present`, будет проверено наличие ресурса, и при необходимости он будет создан. Если значение — `absent`, будет проверено отсутствие ресурса, и при необходимости он будет удалён. Варианты: `"present"` ← (по умолчанию) `"absent"`
tags list / elements=dictionary	Список тегов в формате «Ключ:<ключ, заданный пользователем> Значение:<значение, заданное пользователем>».
use_proxy boolean	Если значение — `no`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр, управляющий проверкой TLS-сертификата api_uri. Варианты: `false` `true` ← (по умолчанию)
vlan_id integer	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:
      name: sjc02-d23-ext-mgmt

- name: Configure IMC Access policy with IP pool from another organization
  intersight_imc_access_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: policy-org
    name: sjc02-d23-access
    vlan_id: 131
    ip_pool:
      name: shared-ext-mgmt
      organization: shared-org

- 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_response dictionary	Результат ответа 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_response

dictionary

Результат ответа 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/intersight/intersight_imc_access_policy_module.html