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

Примечание

Этот модуль входит в коллекцию cisco.mso (версия 2.13.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 строка / обязательный	Имя ANP.
deployment_immediacy строка	Немедленность развертывания статического порта. `immediate` означает немедленное развертывание. `lazy` означает развертывание по запросу. Варианты: `"immediate"` `"lazy"` ← (по умолчанию)
epg строка / обязательный	Имя EPG.
fex строка	Идентификатор FEX статического порта.
force_replace логический	Заменяет все настроенные статические порты указанными статическими портами. Этот параметр можно использовать только вместе с параметром `static_ports`. В сочетании с `state=absent`, если конфигурация статических портов не указана, все настроенные статические порты будут удалены. Варианты: `false` `true`
host псевдонимы: hostname строка	IP-адрес или имя хоста ACI Multi Site Orchestrator. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_HOST`.
leaf строка	Коммутатор leaf статического порта.
login_domain строка	Домен входа, используемый для аутентификации. Значение по умолчанию — Local. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_LOGIN_DOMAIN`. При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использована переменная инвентаря `ansible_httpapi_login_domain`.
mode строка	Режим статического порта. `native` означает Access (802.1p. `regular` означает Trunk. `untagged` означает Access (без тегирования. Варианты: `"native"` `"regular"` `"untagged"` ← (по умолчанию)
output_level строка	Определяет формат вывода этого модуля MSO. `normal` — стандартный вывод, включая словарь `current` `info` добавляет информационный вывод, включая `previous`, `proposed` и словари `sent` `debug` добавляет отладочный вывод, включая сведения `filter_string`, `method`, `response`, `status` и `url` Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_OUTPUT_LEVEL`. Варианты: `"debug"` `"info"` `"normal"` ← (по умолчанию)
password строка	Пароль для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение одной из переменных среды: `MSO_PASSWORD` или `ANSIBLE_NET_PASSWORD`.
path строка	Путь статического порта.
pod строка	Под статического порта.
port целое число	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_PORT`.
primary_micro_segment_vlan целое число	Основной VLAN микросегмента статического порта.
schema строка / обязательный	Имя схемы.
site строка / обязательный	Имя сайта.
state строка	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для вывода одного или нескольких объектов. Варианты: `"absent"` `"present"` ← (по умолчанию) `"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 строка	Коммутатор leaf статического порта.
mode строка	Режим статического порта. `native` означает Access (802.1p. `regular` означает Trunk. `untagged` означает Access (без тегирования. Варианты: `"native"` `"regular"` `"untagged"`
path строка	Путь статического порта.
pod строка	Под статического порта.
primary_micro_segment_vlan целое число	Основной VLAN микросегмента статического порта.
type строка	Тип пути статического порта `vpc` используется для виртуального Port Channel `dpc` используется для прямого Port Channel `port` используется для отдельного интерфейса Варианты: `"port"` `"vpc"` `"dpc"`
vlan целое число	Идентификатор VLAN инкапсуляции порта статического порта.
template строка / обязательный	Имя шаблона.
timeout целое число	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_TIMEOUT`.
type строка	Тип пути статического порта `vpc` используется для виртуального Port Channel `dpc` используется для прямого Port Channel `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`. При использовании плагина подключения HTTPAPI (mso или nd) значение по умолчанию — `false`, а при использовании устаревшего метода подключения (только для mso) — `true`. Варианты: `false` `true`
username строка	Имя пользователя для аутентификации. Если значение не указано в задаче, вместо него будет использовано значение одной из переменных среды: `MSO_USERNAME` или `ANSIBLE_NET_USERNAME`.
validate_certs логический	Если `false`, сертификаты SSL проверяться не будут. Значение `false` следует задавать только для сайтов под личным управлением, использующих самозаверяющие сертификаты. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_VALIDATE_CERTS`. Значение по умолчанию — `true`. Варианты: `false` `true`
vlan целое число	Идентификатор VLAN инкапсуляции порта статического порта.

Примечания

Примечание

В API PATCH ACI MultiSite есть ограничение: некоторые объекты требуется указывать по индексу. При одновременном доступе это может привести к скрытому повреждению данных при изменении или удалении объекта, поскольку может быть указан не тот объект. Это ограничение затрагивает данный модуль.
Этот модуль разработан для Multi Site Orchestrator версии 2.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)
Noppanut Ploywong (@noppanut15)

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

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