модуль cisco.mso.mso_schema_site_anp_epg_bulk_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_bulk_staticport.

УСТАРЕЛ
Краткое описание
Требования
Параметры
Примечания
См. также
Примеры
Статус

УСТАРЕЛ

Удалён в:: версии 3.0.0
Причина:: Модуль объединён с cisco.mso.mso_schema_site_anp_epg_staticport, чтобы централизовать всю функциональность статических портов.
Альтернатива:: Вместо этого используйте cisco.mso.mso_schema_site_anp_epg_staticport с параметром `force_replace=true`.

Краткое описание

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

Требования

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

Multi Site Orchestrator версии 2.1 или новее

Параметры

Параметр	Комментарии
anp строка / обязательный	Имя ANP.
deployment_immediacy строка	Момент применения конфигурации статического порта. `immediate` означает немедленное применение. `lazy` означает применение по запросу. Допустимые значения: `"immediate"` `"lazy"` ← (по умолчанию)
epg строка / обязательный	Имя EPG.
fex строка	Идентификатор FEX статического порта.
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 строка	Pod статического порта.
port целое число	Номер порта для REST-подключения. Значение по умолчанию зависит от параметра `use_ssl`. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_PORT`.
primary_micro_segment_vlan целое число	Основная VLAN микросегмента статического порта.
schema строка / обязательный	Имя схемы.
site строка / обязательный	Имя сайта.
state строка	Для добавления или удаления используйте `present` или `absent`. Для получения списка одного или нескольких объектов используйте `query`. Допустимые значения: `"absent"` `"present"` ← (по умолчанию) `"query"`
static_ports список / элементы=словарь	Список конфигураций статических портов и их элементов в виде словаря. Атрибуты уровня модуля будут переопределены атрибутами уровня пути. Изменение элемента списка обновит всю полезную нагрузку.
deployment_immediacy строка	Момент применения конфигурации статического порта. `immediate` означает немедленное применение. `lazy` означает применение по запросу. Допустимые значения: `"immediate"` `"lazy"`
fex строка	Идентификатор FEX статического порта.
leaf строка	Коммутатор leaf статического порта.
mode строка	Режим статического порта. `native` означает Access (802.1p. `regular` означает Trunk. `untagged` означает Access (без тегирования. Допустимые значения: `"native"` `"regular"` `"untagged"`
path строка	Путь статического порта. Путь должен быть уникальным для каждого статического порта на определённом коммутаторе leaf.
pod строка	Pod статического порта.
primary_micro_segment_vlan целое число	Основная VLAN микросегмента статического порта.
type строка	Тип пути статического порта vpc используется для Virtual Port Channel dpc используется для Direct Port Channel port используется для одного интерфейса Допустимые значения: `"port"` `"vpc"` `"dpc"`
vlan целое число	Идентификатор VLAN инкапсуляции порта статического порта.
template строка / обязательный	Имя шаблона.
timeout целое число	Тайм-аут на уровне сокета в секундах. Значение по умолчанию — 30 секунд. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `MSO_TIMEOUT`.
type строка	Тип пути статического порта vpc используется для Virtual Port Channel dpc используется для Direct 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`. По умолчанию используется `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`
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_bulk_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
    static_ports:
      - path: eth1/2
        leaf: 102
      - path: eth1/3
        vlan: 124
    state: present

- name: Add a new static fex port to a site EPG
  cisco.mso.mso_schema_site_anp_epg_bulk_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: lazy
    static_ports:
      - path: eth1/2
        leaf: 102
      - path: eth1/3
        vlan: 124
      - fex: 151
    state: present

- name: Add a new static VPC to a site EPG
  cisco.mso.mso_schema_site_anp_epg_bulk_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
    static_ports:
      - path: eth1/2
        leaf: 102
      - path: eth1/3
        vlan: 124
      - fex: 151
      - leaf: 101-102
        path: ansible_polgrp
        vlan: 127
        type: vpc
        mode: untagged
        deployment_immediacy: lazy
    state: present

- name: Remove static ports from a site EPG
  cisco.mso.mso_schema_site_anp_epg_bulk_staticport:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema1
    site: Site1
    template: Template1
    anp: ANP1
    epg: EPG1
    state: absent

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

Статус

Этот модуль будет удалён в версии 3.0.0. [устарел]
Дополнительную информацию см. в разделе УСТАРЕЛ.

Авторы

Anvitha Jain (@anvjain)

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

© 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_bulk_staticport_module.html