Spec-Zone.ru › Ansible

модуль cisco.intersight.intersight_domain — управление профилями домена UCS в Cisco Intersight

Примечание

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

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

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

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

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

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

  • Создание, обновление и удаление профилей домена UCS (SwitchClusterProfiles) в Cisco Intersight.
  • Управление связанными профилями SwitchProfiles (A и B), назначениями Fabric Interconnect и наборами политик.
  • Политики назначаются профилям SwitchProfiles через пакетный API Intersight.
  • Этот модуль не управляет развертыванием профиля домена.
  • Дополнительные сведения см. в документации 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"

assigned_switch_a_serial

string

Серийный номер Fabric Interconnect, назначаемого профилю SwitchProfile A.

Значение определяется с помощью конечной точки API /network/ElementSummaries и поля Serial.

assigned_switch_b_serial

string

Серийный номер Fabric Interconnect, назначаемого профилю SwitchProfile B.

Значение определяется с помощью конечной точки API /network/ElementSummaries и поля Serial.

auditd_policy

string

Имя политики журнала аудита, назначаемой обоим Fabric Interconnect.

certificate_management_policy

string

Имя политики управления сертификатами, назначаемой обоим Fabric Interconnect.

description

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

string

Описание профиля домена UCS, заданное пользователем.

ldap_policy

string

Имя политики LDAP, назначаемой обоим Fabric Interconnect.

name

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

Имя, назначенное профилю домена UCS.

Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.

Имена профилей SwitchProfiles автоматически задаются как {name}-A и {name}-B.

network_connectivity_policy

string

Имя политики подключения к сети (DNS), назначаемой обоим Fabric Interconnect.

ntp_policy

string

Имя политики NTP, назначаемой обоим Fabric Interconnect.

organization

string

Имя организации, которой назначен этот ресурс.

Профили и политики, созданные в пользовательской организации, применимы только к устройствам той же организации.

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

port_policy_fi_a

string

Имя политики портов, назначаемой Fabric Interconnect A.

port_policy_fi_b

string

Имя политики портов, назначаемой Fabric Interconnect B.

snmp_policy

string

Имя политики SNMP, назначаемой обоим Fabric Interconnect.

state

string

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

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

Допустимые значения:

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

switch_control_policy

string

Имя политики управления коммутатором, назначаемой обоим Fabric Interconnect.

syslog_policy

string

Имя политики Syslog, назначаемой обоим Fabric Interconnect.

system_qos_policy

string

Имя системной политики QoS, назначаемой обоим Fabric Interconnect.

Эта политика обязательна для профилей домена UCS.

tags

list / элементы=словарь

Список тегов в формате Key:<ключ, заданный пользователем> Value:<значение, заданное пользователем>.

use_proxy

boolean

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

Допустимые значения:

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

validate_certs

boolean

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

Допустимые значения:

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

vlan_policy_fi_a

string

Имя политики VLAN, назначаемой Fabric Interconnect A.

vlan_policy_fi_b

string

Имя политики VLAN, назначаемой Fabric Interconnect B.

vsan_policy_fi_a

string

Имя политики VSAN, назначаемой Fabric Interconnect A.

vsan_policy_fi_b

string

Имя политики VSAN, назначаемой Fabric Interconnect B.

Примеры

- name: Create a basic UCS Domain Profile
  cisco.intersight.intersight_domain:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "Domain-01"
    description: "Basic domain profile"
    system_qos_policy: "Default-QoS"
    state: present

- name: Create a UCS Domain Profile with switch assignments and policies
  cisco.intersight.intersight_domain:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "Domain-01"
    description: "Full domain profile"
    assigned_switch_a_serial: "FDO23456ABC"
    assigned_switch_b_serial: "FDO23456DEF"
    vlan_policy_fi_a: "VLAN-Policy-A"
    vlan_policy_fi_b: "VLAN-Policy-B"
    vsan_policy_fi_a: "VSAN-Policy-A"
    vsan_policy_fi_b: "VSAN-Policy-B"
    port_policy_fi_a: "Port-Policy-A"
    port_policy_fi_b: "Port-Policy-B"
    ntp_policy: "NTP-Corp"
    syslog_policy: "Syslog-Corp"
    snmp_policy: "SNMP-Monitor"
    system_qos_policy: "QoS-Default"
    switch_control_policy: "Switch-Control"
    state: present

- name: Delete a UCS Domain Profile
  cisco.intersight.intersight_domain:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "Domain-01"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

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

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

Пример: {"api_response": {"Name": "Domain-01", "ObjectType": "fabric.SwitchClusterProfile", "Organization": {"Moid": "675450ee69726530014753e2", "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_domain_module.html

Spec-Zone.ru

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