Модуль cisco.intersight.intersight_network_connectivity_policy — настройка политики сетевого подключения для Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать модуль в плейбуке, укажите: cisco.intersight.intersight_network_connectivity_policy.
Краткое описание
- Управляет настройкой политики сетевого подключения в Cisco Intersight.
- Политика для настройки параметров сетевого подключения, включая DNS и IPv6, на серверах, управляемых Cisco Intersight.
- Дополнительную информацию см. в документации Cisco Intersight.
Параметры
Параметр | Комментарии |
|---|---|
alternate_ipv4_dns_server string | IP-адрес вторичного DNS-сервера. Используется, если enable_ipv4_dns_from_dhcp имеет значение false. По умолчанию: |
alternate_ipv6_dns_server string | IP-адрес вторичного DNS-сервера. По умолчанию: |
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. По умолчанию: |
description псевдонимы: descr string | Описание политики сетевого подключения, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчеркивания (_). |
dynamic_dns_domain string | Доменное имя, добавляемое к имени хоста при обновлении динамической DNS (DDNS). Если оставить поле пустым, в запросе на обновление DDNS будет отправлено только имя хоста. Этот параметр необязателен, даже если enable_dynamic_dns имеет значение true. |
enable_dynamic_dns boolean | Если включено, обновляет ресурсные записи DNS из Cisco IMC. Варианты:
|
enable_ipv4_dns_from_dhcp boolean | Включить получение DNS для IPv4 через DHCP. Если включено, Cisco IMC получает адреса DNS-серверов через DHCP. Варианты:
|
enable_ipv6 boolean | Если включено, разрешает настраивать свойства IPv6. Варианты:
|
enable_ipv6_dns_from_dhcp boolean | Если включено, Cisco IMC получает адреса DNS-серверов через DHCP. Для включения этой функции необходимо активировать поле «Использовать DHCP» для IPv6 в Cisco IMC. Варианты:
|
name string / обязательный | Имя, присвоенное политике сетевого подключения. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_. |
organization string | Имя организации, которой назначен этот ресурс. Профили, политики и пулы, созданные в пользовательской организации, применимы только к устройствам в той же организации. По умолчанию: |
preferred_ipv4_dns_server string | IP-адрес основного DNS-сервера. Используется, если enable_ipv4_dns_from_dhcp имеет значение false. По умолчанию: |
preferred_ipv6_dns_server string | IP-адрес основного DNS-сервера. По умолчанию: |
state string | Если задано значение Если задано значение Варианты:
|
tags list / элементы=dictionary | Список тегов в формате Key:<ключ, заданный пользователем> Value:<значение, заданное пользователем>. |
use_proxy boolean | Если задано значение Варианты:
|
validate_certs boolean | Логический параметр для проверки TLS-сертификата api_uri Варианты:
|
Примеры
- name: Create a Network Connectivity Policy with Dynamic DNS enabled
cisco.intersight.intersight_network_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "DynamicDNS-Policy"
description: "Network connectivity policy with Dynamic DNS"
tags:
- Key: "Site"
Value: "DataCenter-A"
enable_dynamic_dns: true
dynamic_dns_domain: "company.com"
enable_ipv4_dns_from_dhcp: true
enable_ipv6: true
enable_ipv6_dns_from_dhcp: true
state: present
- name: Create a Network Connectivity Policy with static DNS servers
cisco.intersight.intersight_network_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "StaticDNS-Policy"
description: "Network connectivity policy with static DNS servers"
enable_dynamic_dns: false
enable_ipv4_dns_from_dhcp: false
preferred_ipv4_dns_server: "8.8.8.8"
alternate_ipv4_dns_server: "8.8.4.4"
enable_ipv6: true
enable_ipv6_dns_from_dhcp: false
preferred_ipv6_dns_server: "2001:4860:4860::8888"
alternate_ipv6_dns_server: "2001:4860:4860::8844"
state: present
- name: Create a basic Network Connectivity Policy with defaults
cisco.intersight.intersight_network_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "Basic-Network-Policy"
description: "A basic network connectivity policy"
state: present
- name: Delete a Network Connectivity Policy
cisco.intersight.intersight_network_connectivity_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "DynamicDNS-Policy"
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
api_response dictionary | Результат ответа API, возвращенный для указанного ресурса. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_network_connectivity_policy_module.html
