Модуль cisco.mso.mso_schema_site_anp_epg_staticport — Управление статическими портами EPG локальной площадки в шаблоне схемы

Примечание

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

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

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

Для использования в книге задач укажите: cisco.mso.mso_schema_site_anp_epg_staticport.

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

Обзор

Управление статическими портами EPG локальной площадки в шаблоне схемы на Cisco ACI Multi-Site.

Требования

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

Multi Site Orchestrator версии 2.1 или более поздней

Параметры

Параметр	Комментарии
anp string / required	Имя ANP.
deployment_immediacy string	Непосредственность развертывания статического порта. `immediate` means Deploy immediate. `lazy` means deploy on demand. Варианты: `"immediate"` `"lazy"` ← (default)
epg string / required	Имя EPG.
fex string	Идентификатор FEX статического порта.
force_replace boolean	Заменяет все настроенные статические порты(ы) на предоставленные статические порты(ы). Этот параметр можно использовать только в сочетании с параметром `static_ports`. В сочетании с `state=absent` и без какой-либо конфигурации статического порта все настроенные статические порты(ы) будут удалены. Варианты: `false` `true`
host псевдонимы: hostname string	IP-адрес или имя хоста узла ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_HOST`.
leaf string	Узел статического порта.
login_domain string	Имя домена входа, используемое для аутентификации. Значение по умолчанию - Local. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI будет использоваться переменная инвентаризации `ansible_httpapi_login_domain`, если этот атрибут не указан.
mode string	Режим статического порта. `native` means Access (802.1p). `regular` means Trunk. `untagged` means Access (untagged). Варианты: `"native"` `"regular"` `"untagged"` ← (default)
output_level string	Влияет на вывод этого модуля MSO. `normal` means the standard output, incl. `current` dict `info` adds informational output, incl. `previous`, `proposed` and `sent` dicts `debug` adds debugging output, incl. `filter_string`, `method`, `response`, `status` and `url` information Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_OUTPUT_LEVEL`. Варианты: `"debug"` `"info"` `"normal"` ← (default)
password string	Пароль, используемый для аутентификации. Если значение не указано в задаче, вместо него будут использованы значения переменных среды `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
path string	Путь статического порта.
pod string	Под статического порта.
port integer	Номер порта, используемый для подключения REST. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `MSO_PORT`.
primary_micro_segment_vlan integer	Основной VLAN микросегмента статического порта.
schema string / required	Имя схемы.
site string / required	Имя сайта.
state string	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для перечисления объекта или нескольких объектов. Варианты: `"absent"` `"present"` ← (default) `"query"`

static_ports список / элементы=словарь	Список статических портов, связанных с этим EPG. Все настроенные статические порты будут заменены предоставленными статическими портами, если используется `force_replace=true`. Только предоставленные статические порты будут добавлены, обновлены или удалены при использовании `force_replace=false`. В сочетании с `state=query`, все предоставленные статические порты должны быть найдены, иначе задача завершится ошибкой. Если атрибуты static_ports не указаны, будут использоваться атрибуты модуля. Для каждого статического порта, предоставленного в списке, должны быть разрешены следующие атрибуты: static_ports.type static_ports.pod static_ports.leaf static_ports.path static_ports.vlan
deployment_immediacy строка	Немедленность развертывания статического порта. `immediate` означает Немедленное развертывание. `lazy` означает Развертывание по запросу. Варианты: `"immediate"` `"lazy"`
fex строка	Идентификатор fex статического порта.
leaf строка	Узел статического порта.
mode строка	Режим статического порта. `native` означает Доступ (802.1p). `regular` означает Трафик. `untagged` означает Доступ (немаркированный). Варианты: `"native"` `"regular"` `"untagged"`
path строка	Путь статического порта.
pod строка	Подсистема статического порта.
primary_micro_segment_vlan целое число	VLAN первичного микросегмента статического порта.
type строка	Тип пути статического порта `vpc` используется для виртуального канала портов `dpc` используется для прямого канала портов `port` используется для отдельного интерфейса Варианты: `"port"` `"vpc"` `"dpc"`
vlan целое число	Идентификатор VLAN инкапсуляции порта статического порта.
template строка / обязательно	Имя шаблона.
timeout целое число	Таймаут уровня сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, будет использоваться значение переменной окружения `MSO_TIMEOUT`.
type строка	Тип пути статического порта `vpc` используется для виртуального канала портов `dpc` используется для прямого канала портов `port` используется для отдельного интерфейса Варианты: `"port"` ← (по умолчанию) `"vpc"` `"dpc"`
use_proxy булево	Если `false`, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах. Если значение не указано в задаче, будет использоваться значение переменной окружения `MSO_USE_PROXY`. По умолчанию `true`. Варианты: `false` `true`
use_ssl булево	Если `false`, вместо стандартного HTTPS-соединения будет использоваться HTTP-соединение. Если значение не указано в задаче, будет использоваться значение переменной окружения `MSO_USE_SSL`. При использовании плагина HTTPAPI-соединения переменная инвентаризации `ansible_httpapi_use_ssl` будет использована, если этот атрибут не указан. По умолчанию `false` при использовании плагина HTTPAPI-соединения (mso или nd) и `true` при использовании устаревшего метода соединения (только для mso). Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, будет использоваться значение переменных окружения `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs булево	Если `false`, сертификаты SSL не будут проверены. Это следует установить в `false` только при использовании на контролируемых лично сайтах с самоподписанными сертификатами. Если значение не указано в задаче, будет использоваться значение переменной окружения `MSO_VALIDATE_CERTS`. По умолчанию `true`. Варианты: `false` `true`

END_OF_DOCUMENT_MARKER

vlan

integer

Идентификатор VLAN инкапсуляции порта статического порта.

Примечания

Примечание

API MultiSite PATCH ACI имеет недостаток, требующий, чтобы некоторые объекты ссылались по индексу. Это может привести к неявной порче при одновременном доступе при изменении/удалении объекта, так как может быть ссылаться на неправильный объект. Данный модуль затронут этим недостатком.
Этот модуль был разработан для поддержки Multi Site Orchestrator v2.1 или более поздних версий. Некоторые или все функции могут не работать на более ранних версиях.

См. также

cisco.mso.mso_schema_site_anp_epg: Управление локальными для сайта группами конечных точек (EPG) в шаблоне схемы.
cisco.mso.mso_schema_template_anp_epg: Управление группами конечных точек (EPG) в шаблонах схемы.

Примеры

- name: Add a new static port to a site EPG
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    type: port
    pod: pod-1
    leaf: 101
    path: eth1/1
    vlan: 126
    deployment_immediacy: immediate
    state: present

- name: Add a new static fex port to a site EPG
  mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    type: port
    pod: pod-1
    leaf: 101
    fex: 151
    path: eth1/1
    vlan: 126
    deployment_immediacy: lazy
    state: present

- name: Add a new static VPC to a site EPG
  mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    pod: pod-1
    leaf: 101-102
    path: ansible_polgrp
    vlan: 127
    type: vpc
    mode: untagged
    deployment_immediacy: lazy
    state: present

- name: Add two new static port to a site EPG
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    static_ports:
      - pod: pod-1
        leaf: 101
        path: eth1/1
        vlan: 126
      - pod: pod-2
        leaf: 101
        path: eth2/1
        vlan: 128
    deployment_immediacy: immediate
    state: present

- name: Replace all existing static pors on a site EPG with 2 new static ports
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    force_replace: true
    static_ports:
      - pod: pod-1
        leaf: 101
        path: eth1/1
        vlan: 126
      - pod: pod-2
        leaf: 101
        path: eth2/1
        vlan: 128
    deployment_immediacy: immediate
    state: present

- name: Query a specific site EPG static port
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    type: port
    pod: pod-1
    leaf: 101
    path: eth1/1
    state: query
  register: query_result

- name: Query a list of static ports
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    static_ports:
      - pod: pod-1
        leaf: 101
        path: eth1/1
        vlan: 126
      - pod: pod-2
        leaf: 101
        path: eth2/1
        vlan: 128
    state: query
  register: query_result

- name: Query all site EPG static ports
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    state: query
  register: query_result

- name: Remove a static port from a site EPG
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    type: port
    pod: pod-1
    leaf: 101
    path: eth1/1
    state: absent

- name: Remove two static ports from a site EPG
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    static_ports:
      - pod: pod-1
        leaf: 101
        path: eth1/1
        vlan: 126
      - pod: pod-2
        leaf: 101
        path: eth2/1
        vlan: 128
    deployment_immediacy: immediate
    state: absent

- name: Remove all existing static pors from a site EPG
  cisco.mso.mso_schema_site_anp_epg_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    force_replace: true
    state: absent

Авторы

Dag Wieers (@dagwieers)
Akini Ross (@akinross)

Ссылки на коллекции

© 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/mso/mso_schema_site_anp_epg_staticport_module.html