cisco.mso.mso_schema_site_anp_epg_selector 模块 – 管理模式模板中的站点本地 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_selector

概要

  • 在 Cisco ACI Multi-Site 上管理模式模板中的 EPG 选择器。

要求

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

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

参数

参数

注释

anp

字符串 / 必需

ANP 的名称。

epg

字符串 / 必需

要管理的 EPG 的名称。

表达式

列表 / 元素=字典

与此选择器关联的表达式。

运算符

字符串 / 必需

与表达式关联的运算符。

运算符 has_key 或 does_not_have_key 仅适用于自定义类型/标签

选择

  • "not_in"

  • "in"

  • "equals"

  • "not_equals"

  • "has_key"

  • "does_not_have_key"

类型

别名: 标签

字符串 / 必需

表达式的类型。

类型是自定义的,或者是区域、区域和 ip_address 之一

仅当站点为 AWS 时,类型才能为区域。

字符串

与表达式关联的值。

如果运算符是 in 或 not_in,则值应为逗号分隔的字符串。

主机

别名: 主机名

字符串

ACI Multi Site Orchestrator 主机的 IP 地址或主机名。

如果未在任务中指定该值,则将改用环境变量 MSO_HOST 的值。

login_domain

字符串

用于身份验证的登录域名。

默认值为 Local。

如果未在任务中指定该值,则将改用环境变量 MSO_LOGIN_DOMAIN 的值。

当使用 HTTPAPI 连接插件时,如果未指定此属性,将使用清单变量 ansible_httpapi_login_domain

output_level

字符串

影响此 MSO 模块的输出。

normal 表示标准输出,包括 current 字典

info 添加信息输出,包括 previousproposedsent 字典

debug 添加调试输出,包括 filter_stringmethodresponsestatusurl 信息

如果未在任务中指定该值,则将改用环境变量 MSO_OUTPUT_LEVEL 的值。

选择

  • "debug"

  • "info"

  • "normal" ← (默认)

密码

字符串

用于身份验证的密码。

如果未在任务中指定该值,则将改用环境变量 MSO_PASSWORDANSIBLE_NET_PASSWORD 的值。

端口

整数

用于 REST 连接的端口号。

默认值取决于参数 `use_ssl`。

如果未在任务中指定该值,则将改用环境变量 MSO_PORT 的值。

模式

字符串 / 必需

模式的名称。

选择器

字符串

选择器的名称。

站点

字符串 / 必需

站点的名称。

状态

字符串

使用 presentabsent 进行添加或删除。

使用 query 列出一个对象或多个对象。

选择

  • "absent"

  • "present" ← (默认)

  • "query"

模板

字符串 / 必需

模板的名称。

超时

整数

套接字级别的超时时间(以秒为单位)。

默认值为 30 秒。

如果未在任务中指定该值,则将改用环境变量 MSO_TIMEOUT 的值。

use_proxy

布尔值

如果为 false,即使在目标主机上的环境变量中定义了代理,也不会使用代理。

如果未在任务中指定该值,则将改用环境变量 MSO_USE_PROXY 的值。

默认值为 true

选择

  • false

  • true

use_ssl

布尔值

如果为 false,将使用 HTTP 连接而不是默认的 HTTPS 连接。

如果未在任务中指定该值,则将改用环境变量 MSO_USE_SSL 的值。

当使用 HTTPAPI 连接插件时,如果未指定此属性,将使用清单变量 ansible_httpapi_use_ssl

当使用 HTTPAPI 连接插件(mso 或 nd)时,默认值为 false;当使用旧连接方法时(仅适用于 mso),默认值为 true

选择

  • false

  • true

用户名

字符串

用于身份验证的用户名。

如果任务中未指定该值,则将使用环境变量 MSO_USERNAMEANSIBLE_NET_USERNAME 的值。

validate_certs

布尔值

如果为 false,则不会验证 SSL 证书。

只有在个人控制的站点上使用自签名证书时,才应将其设置为 false

如果任务中未指定该值,则将使用环境变量 MSO_VALIDATE_CERTS 的值。

默认值为 true

选择

  • false

  • true

注意

注意

  • 此模块编写用于支持 Multi Site Orchestrator v2.1 或更高版本。某些或全部功能可能在早期版本上无法工作。

另请参阅

另请参阅

cisco.mso.mso_schema_site_anp_epg

管理模式模板中的站点本地端点组 (EPG)。

示例

- name: Add a selector to a site EPG
  cisco.mso.mso_schema_site_anp_epg_selector:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    site: Site 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    selector: selector_1
    expressions:
      - type: expression_1
        operator: in
        value: test
    state: present

- name: Remove a Selector from a site EPG
  cisco.mso.mso_schema_site_anp_epg_selector:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    site: Site 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    selector: selector_1
    state: absent

- name: Query a specific Selector
  cisco.mso.mso_schema_site_anp_epg_selector:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    site: Site 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    selector: selector_1
    state: query
  register: query_result

- name: Query all Selectors
  cisco.mso.mso_schema_site_anp_epg_selector:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    site: Site 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    state: query
  register: query_result

作者

  • Cindy Zhao (@cizhao)