Модуль cisco.aci.aci_firmware_source — Управление источниками изображений прошивки (firmware:OSource)
Примечание
Этот модуль входит в коллекцию cisco.aci (версия 2.10.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.aci.
Чтобы использовать её в плейбуке, укажите: cisco.aci.aci_firmware_source.
Обзор
- Управление источниками изображений прошивки на Cisco ACI.
Параметры
Параметр | Комментарии |
|---|---|
annotation string | Пользовательская строка для аннотации объекта. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Если значение не указано в задаче и переменной окружения Значение по умолчанию: |
certificate_name aliases: cert_name string | Имя сертификата X.509, прикрепленного к пользователю APIC AAA, используемому для аутентификации на основе подписи. Если указано имя файла Если для Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
host aliases: hostname string | IP-адрес или имя хоста APIC, разрешимые узлом управления Ansible. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
name_alias string | Псевдоним для текущего объекта. Это относится к полю nameAlias в ACI. |
output_level string | Влияет на вывод этого модуля ACI.
Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Варианты:
|
output_path string | Путь к файлу, который будет использоваться для выгрузки объектов конфигурации ACI JSON, созданных модулем. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
password string | Пароль, который нужно использовать для аутентификации. Эта опция взаимоисключающая с Если значение не указано в задаче, вместо него будут использованы значения переменных окружения |
polling_interval integer | Интервал опроса в минутах. |
port integer | Номер порта, который будет использоваться для REST-подключения. Значение по умолчанию зависит от параметра Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
private_key aliases: cert_key string | Либо файл закрытого ключа в формате PEM, либо содержимое закрытого ключа, используемое для аутентификации на основе подписи. Это значение также влияет на используемое значение Эта опция взаимоисключающая с Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
source aliases: name, source_name string | Идентифицирующее имя для внешнего источника образов, например, HTTP или SCP-сервер. |
state string | Используйте Используйте Варианты:
|
suppress_previous aliases: no_previous, ignore_previous boolean | Если Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Значение по умолчанию — ПРЕДУПРЕЖДЕНИЕ — Это приводит к тому, что предыдущее возвращаемое значение будет пустым. Предыдущее состояние объекта не будет проверено, и обновление POST будет содержать все свойства. Варианты:
|
suppress_verification aliases: no_verification, no_verify, suppress_verify, ignore_verify, ignore_verification boolean | Если Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Значение по умолчанию — ПРЕДУПРЕЖДЕНИЕ — Это приводит к тому, что текущее возвращаемое значение устанавливается в предложенное значение. Текущий объект, включая значения по умолчанию, будет непроверяемым в одной задаче. Варианты:
|
timeout integer | Таймаут уровня сокета в секундах. Если значение не указано в задаче, будет использовано значение переменной окружения Значение по умолчанию 30. |
url string | URL прошивки для изображения(ов) на источнике. |
url_password string | Пароль или строка ключа прошивки. Предоставление этого параметра всегда приведет к изменению, так как это защищенное свойство, которое нельзя получить из APIC. |
url_protocol aliases: url_proto string | Протокол загрузки прошивки. Варианты:
|
url_username string | Имя пользователя для источника. |
use_proxy boolean | Если Если значение не указано в задаче, будет использовано значение переменной среды Значение по умолчанию true. Варианты:
|
use_ssl boolean | Если Если значение не указано в задаче, будет использовано значение переменной среды Значение по умолчанию true, когда соединение локальное. Варианты:
|
username aliases: user string | Имя пользователя для аутентификации. Если значение не указано в задаче, будет использовано значение переменных окружения Значение по умолчанию admin. |
validate_certs boolean | Если Это следует установить в Если значение не указано в задаче, будет использовано значение переменной среды Значение по умолчанию true. Варианты:
|
См. также
См. также
- Справочник по модели управления информацией APIC
-
Дополнительная информация об внутренней APIC-классе firmware:OSource.
- Руководство по Cisco ACI
-
Подробная информация о том, как управлять вашей инфраструктурой ACI с помощью Ansible.
- Разработка модулей Cisco ACI
-
Подробное руководство по написанию собственных модулей Cisco ACI для внесения вклада.
Примеры
- name: Add firmware source
cisco.aci.aci_firmware_source:
host: apic
username: admin
password: SomeSecretPassword
source: aci-msft-pkg-3.1.1i.zip
url: foo.bar.cisco.com/download/cisco/aci/aci-msft-pkg-3.1.1i.zip
url_protocol: http
state: present
delegate_to: localhost
- name: Remove firmware source
cisco.aci.aci_firmware_source:
host: apic
username: admin
password: SomeSecretPassword
source: aci-msft-pkg-3.1.1i.zip
state: absent
delegate_to: localhost
- name: Query a specific firmware source
cisco.aci.aci_firmware_source:
host: apic
username: admin
password: SomeSecretPassword
source: aci-msft-pkg-3.1.1i.zip
state: query
delegate_to: localhost
register: query_result
- name: Query all firmware sources
cisco.aci.aci_firmware_source:
host: apic
username: admin
password: SomeSecretPassword
state: query
delegate_to: localhost
register: query_result
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
current список / элементы=строка | Существующая конфигурация с APIC после завершения модуля Возвращается при: успехе Пример: |
error словарь | Информация об ошибке, возвращённая с APIC Возвращается при: ошибке Пример: |
filter_string строка | Используемая строка фильтра для запроса Возвращается при: ошибке или отладке Пример: |
method строка | Используемый HTTP-метод запроса к APIC Возвращается при: ошибке или отладке Пример: |
previous список / элементы=строка | Исходная конфигурация с APIC до запуска модуля Возвращается при: информации Пример: |
proposed словарь | Собраная конфигурация из параметров, предоставленных пользователем Возвращается при: информации Пример: |
raw строка | Необработанный вывод, возвращённый APIC REST API (xml или json) Возвращается при: ошибке разбора Пример: |
response строка | HTTP-ответ от APIC Возвращается при: ошибке или отладке Пример: |
sent список / элементы=строка | Фактическая/минимальная конфигурация, отправленная в APIC Возвращается при: информации Пример: |
status целое число | HTTP-код состояния от APIC Возвращается при: ошибке или отладке Пример: |
url строка | Используемый HTTP-URL для запроса к APIC Возвращается при: ошибке или отладке Пример: |
Ссылки на сборку
© 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/aci/aci_firmware_source_module.html