Spec-Zone.ru › Ansible

Модуль cisco.dnac.applications_v2 – Модуль ресурсов для приложений V2

Примечание

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

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

Для установки используйте: ansible-galaxy collection install cisco.dnac. Для использования этого модуля требуются дополнительные зависимости, см. Требования для получения подробностей.

Чтобы использовать его в плейбуке, укажите: cisco.dnac.applications_v2.

Новое в cisco.dnac 6.14.0

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • См. также
  • Примеры
  • Возвращаемые значения

Обзор

  • Управление операциями создания, обновления и удаления ресурсов приложений V2.
  • Создание новых пользовательских приложений.
  • Удаление существующего пользовательского приложения по идентификатору.
  • Редактирование атрибутов существующего приложения.

Примечание

Для этого модуля существует соответствующий плагин действий.

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

  • dnacentersdk >= 2.7.2
  • python >= 3.5

Параметры

Параметр

Комментарии

dnac_debug

boolean

Флаг для Cisco DNA Center SDK, позволяющий включить отладку.

Варианты:

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

dnac_host

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

Имя хоста Cisco DNA Center.

dnac_password

string

Пароль Cisco DNA Center для аутентификации.

dnac_port

integer

Порт Cisco DNA Center.

По умолчанию: 443

dnac_username

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

string

Имя пользователя Cisco DNA Center для аутентификации.

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

dnac_verify

boolean

Флаг для включения или отключения проверки сертификата SSL.

Варианты:

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

dnac_version

string

Указывает SDK, какую версию Cisco DNA Center использовать.

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

id

string

Параметр пути id. Id пользовательского приложения для удаления.

payload

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

Загрузка приложения V2.

displayName

string

Имя для отображения.

id

string

Идентификатор приложения.

indicativeNetworkIdentity

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

Указательная сетевая идентичность приложения V2.

displayName

string

Имя для отображения.

id

string

Идентификатор.

lowerPort

float

Нижний порт.

ports

string

Порты.

protocol

string

Протокол.

upperPort

float

Верхний порт.

instanceId

integer

Идентификатор экземпляра.

instanceVersion

float

Версия экземпляра.

name

string

Имя приложения.

namespace

string

Пространство имен.

networkApplications

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

Сетевые приложения V2.

applicationSubType

string

Подтип приложения, обнаруженное приложение, NONE nbar и пользовательское приложение.

applicationType

string

Тип приложения, DEFAULT nbar приложение, DEFAULT_MODIFIED измененное nbar приложение, CUSTOM пользовательское приложение.

appProtocol

string

Прикладной протокол.

categoryId

string

Идентификатор категории.

displayName

string

Отображаемое имя.

dscp

string

Dscp.

engineId

string

Идентификатор движка.

helpString

string

Строка справки.

id

string

Идентификатор.

ignoreConflict

boolean

Игнорировать конфликт, true или false.

Варианты:

  • false
  • true

longDescription

string

Подробное описание.

name

string

Имя приложения.

popularity

float

Популярность.

rank

integer

Ранг, любое значение от 1 до 65535.

selectorId

string

Идентификатор селектора.

serverName

string

Имя сервера.

trafficClass

string

Класс трафика.

url

string

URL.

networkIdentity

list / elements=dictionary

networkIdentity для Applications V2.

displayName

string

Отображаемое имя.

id

string

Идентификатор.

ipv4Subnet

list / elements=string

Подсеть IPv4.

ipv6Subnet

list / elements=dictionary

Подсеть IPv6.

lowerPort

float

Нижний порт.

ports

string

Порты.

protocol

string

Протокол.

upperPort

float

Верхний порт.

parentScalableGroup

dictionary

parentScalableGroup для Applications V2.

idRef

string

Ссылка на идентификатор родительского набора приложений.

qualifier

string

Квалификатор, допустимое значение — application.

scalableGroupExternalHandle

string

Внешний идентификатор масштабируемой группы, должен быть равен имени приложения.

scalableGroupType

string

Тип масштабируемой группы, допустимое значение APPLICATION.

type

string

Тип, допустимое значение scalablegroup.

validate_response_schema

boolean

Флаг для Cisco DNA Center SDK, позволяющий включить проверку заголовков запросов на соответствие JSON-схеме.

Выбираемые значения:

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

Примечания

Примечание

  • Используемые методы SDK: application_policy.ApplicationPolicy.create_applications, application_policy.ApplicationPolicy.delete_application, application_policy.ApplicationPolicy.edit_applications,
  • Используемые пути: post /dna/intent/api/v2/applications, delete /dna/intent/api/v2/applications/{id}, put /dna/intent/api/v2/applications,
  • Не поддерживает check_mode
  • Плагин работает на контрольном узле и не использует плагины подключения Ansible, а вместо этого использует встроенный менеджер подключений из Cisco DNAC SDK
  • Параметры, начинающиеся с dnac_, используются Cisco DNAC Python SDK для установления подключения

См. также

См. также

Документация Cisco DNA Center по созданию политики приложений CreateApplications

Полное описание API CreateApplications.

Документация Cisco DNA Center по удалению приложения DeleteApplication

Полное описание API DeleteApplication.

Документация Cisco DNA Center по редактированию приложений EditApplications

Полное описание API EditApplications.

Примеры

- name: Update all
  cisco.dnac.applications_v2:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    state: present
    payload:
    - displayName: string
      id: string
      indicativeNetworkIdentity:
      - displayName: string
        id: string
        lowerPort: 0
        ports: string
        protocol: string
        upperPort: 0
      instanceId: 0
      instanceVersion: 0
      name: string
      namespace: string
      networkApplications:
      - appProtocol: string
        applicationSubType: string
        applicationType: string
        categoryId: string
        displayName: string
        dscp: string
        engineId: string
        helpString: string
        id: string
        ignoreConflict: true
        longDescription: string
        name: string
        popularity: 0
        rank: 0
        selectorId: string
        serverName: string
        trafficClass: string
        url: string
      networkIdentity:
      - displayName: string
        id: string
        ipv4Subnet:
        - string
        ipv6Subnet:
        - {}
        lowerPort: 0
        ports: string
        protocol: string
        upperPort: 0
      parentScalableGroup:
        idRef: string
      qualifier: string
      scalableGroupExternalHandle: string
      scalableGroupType: string
      type: string

- name: Create
  cisco.dnac.applications_v2:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    state: present
    payload:
    - indicativeNetworkIdentity:
      - ipv4Subnet:
        - string
        ipv6Subnet:
        - string
        lowerPort: 0
        ports: string
        protocol: string
        upperPort: 0
      name: string
      networkApplications:
      - appProtocol: string
        applicationType: string
        categoryId: string
        dscp: string
        engineId: 0
        helpString: string
        ignoreConflict: true
        rank: 0
        serverName: string
        trafficClass: string
        type: string
        url: string
      networkIdentity:
      - ipv4Subnet:
        - string
        lowerPort: 0
        ports: string
        protocol: string
        upperPort: 0
      parentScalableGroup:
        idRef: string
      scalableGroupType: string
      type: string

- name: Delete by id
  cisco.dnac.applications_v2:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    state: absent
    id: string

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

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

Ключ

Описание

dnac_response

словарь

Словарь или список, возвращаемый Cisco DNAC Python SDK

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

Пример: {"response": {"taskId": "string", "url": "string"}, "version": "string"}

Авторы

  • Rafael Campos (@racampos)

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

  • Трекер задач
  • Репозиторий (источники)

© 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/dnac/applications_v2_module.html

Spec-Zone.ru

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