cisco.mso.mso_schema_site_anp_epg_bulk_staticport 模块 – 在模式模板中批量管理站点本地 EPG 静态端口

注意

此模块是 cisco.mso 集合（版本 2.9.0）的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.mso。您需要其他要求才能使用此模块，请参阅 要求 了解详细信息。

要在 playbook 中使用它，请指定：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` 选项。

概要

• 在 Cisco ACI 多站点上批量管理模式模板中的站点本地 EPG 静态端口。

要求

以下要求需要在执行此模块的主机上满足。

• Multi Site Orchestrator v2.1 或更新版本

参数

参数	注释
anp 字符串 / 必需	ANP 的名称。
deployment_immediacy 字符串	静态端口的部署即时性。 immediate 表示 立即部署。 lazy 表示 按需部署。 选项 "immediate" "lazy" ← (默认)
epg 字符串 / 必需	EPG 的名称。
fex 字符串	静态端口的 FEX ID。
host 别名: hostname 字符串	ACI 多站点编排器主机的 IP 地址或主机名。 如果任务中未指定该值，则将改用环境变量 MSO_HOST 的值。
leaf 字符串	静态端口的叶节点。
login_domain 字符串	用于身份验证的登录域名。 默认值为 Local。 如果任务中未指定该值，则将改用环境变量 MSO_LOGIN_DOMAIN 的值。 当使用 HTTPAPI 连接插件时，如果未指定此属性，将使用清单变量 ansible_httpapi_login_domain。
mode 字符串	静态端口的模式。 native 表示 接入 (802.1p)。 regular 表示 Trunk。 untagged 表示 接入 (未标记)。 选项 "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 的值。
路径 字符串	静态端口的路径。
Pod 字符串	静态端口的 Pod。
端口 整数	用于 REST 连接的端口号。 默认值取决于参数 `use_ssl`。 如果在任务中未指定该值，则将改用环境变量 MSO_PORT 的值。
主微段 VLAN 整数	静态端口的主微段 VLAN。
模式 字符串 / 必需	模式的名称。
站点 字符串 / 必需	站点的名称。
状态 字符串	使用 present 添加或 absent 删除。 使用 query 列出一个或多个对象。 选项 "absent" "present" ← (默认) "query"
静态端口 列表 / 元素=字典	静态端口配置的列表，以及字典形式的元素。 模块级别的属性将被路径级别的属性覆盖。 更改列表中的项目将更新整个有效负载。
deployment_immediacy 字符串	静态端口的部署即时性。 immediate 表示 立即部署。 lazy 表示 按需部署。 选项 "immediate" "lazy"
fex 字符串	静态端口的 FEX ID。
leaf 字符串	静态端口的叶节点。
mode 字符串	静态端口的模式。 native 表示 接入 (802.1p)。 regular 表示 Trunk。 untagged 表示 接入 (未标记)。 选项 "native" "regular" "untagged"
路径 字符串	静态端口的路径。 在特定的叶节点中，每个静态端口的路径必须是唯一的。
Pod 字符串	静态端口的 Pod。
主微段 VLAN 整数	静态端口的主微段 VLAN。
类型 字符串	静态端口的路径类型 vpc 用于虚拟端口通道 dpc 用于直接端口通道 port 用于单个接口 选项 "port" "vpc" "dpc"
VLAN 整数	静态端口的端口封装 VLAN ID。
模板 字符串 / 必需	模板的名称。
超时 整数	套接字级别的超时时间，以秒为单位。 默认值为 30 秒。 如果在任务中未指定该值，则将改用环境变量 MSO_TIMEOUT 的值。
类型 字符串	静态端口的路径类型 vpc 用于虚拟端口通道 dpc 用于直接端口通道 port 用于单个接口 选项 "port" ← (默认) "vpc" "dpc"
使用代理 布尔值	如果为 false，则即使在目标主机上的环境变量中定义了代理，也不会使用代理。 如果在任务中未指定该值，则将改用环境变量 MSO_USE_PROXY 的值。 默认为 true。 选项 false true
使用 SSL 布尔值	如果为 false，将使用 HTTP 连接而不是默认的 HTTPS 连接。 如果在任务中未指定该值，则将改用环境变量 MSO_USE_SSL 的值。 当使用 HTTPAPI 连接插件时，如果未指定此属性，将使用清单变量 ansible_httpapi_use_ssl。 当使用 HTTPAPI 连接插件（mso 或 nd）时，默认值为 false；当使用旧的连接方法（仅适用于 mso）时，默认值为 true。 选项 false true
用户名 字符串	用于身份验证的用户名。 如果在任务中未指定该值，则将改用环境变量 MSO_USERNAME 或 ANSIBLE_NET_USERNAME 的值。
验证证书 布尔值	如果为 false，则不会验证 SSL 证书。 仅当在个人控制的站点上使用自签名证书时，才应将其设置为 false。 如果在任务中未指定该值，则将改用环境变量 MSO_VALIDATE_CERTS 的值。 默认为 true。 选项 false true
VLAN 整数	静态端口的端口封装 VLAN ID。

注意

注意

• ACI MultiSite PATCH API 存在一个缺陷，要求某些对象通过索引引用。这可能会在并发访问时更改/删除对象时导致静默损坏，因为可能会引用错误的对象。此模块会受到此缺陷的影响。

• 此模块编写旨在支持 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_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)

集合链接

• 问题跟踪器
• 主页
• 存储库（源代码）