cisco.mso.mso_schema_template_anp_epg_selector 模块 – 管理模式模板中的 EPG 选择器

注意

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

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

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

要在 playbook 中使用它,请指定:cisco.mso.mso_schema_template_anp_epg_selector

概要

  • 管理 Cisco ACI 多站点上的模式模板中的 EPG 选择器。

要求

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

  • 多站点编排器 v2.1 或更新版本

参数

参数

注释

anp

字符串 / 必需

ANP 的名称。

epg

字符串 / 必需

要管理的 EPG 的名称。

表达式

列表 / 元素=字典

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

运算符

字符串 / 必需

与表达式关联的运算符。

选项

  • "not_in"

  • "in"

  • "equals"

  • "not_equals"

  • "has_key"

  • "does_not_have_key"

类型

别名: tag

字符串 / 必需

表达式的名称。

字符串

与表达式关联的值。

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

主机

别名: hostname

字符串

ACI 多站点编排器主机的 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" ← (默认)

password

字符串

用于身份验证的密码。

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

port

整数

用于 REST 连接的端口号。

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

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

schema

字符串 / 必需

模式的名称。

selector

字符串

选择器的名称。

state

字符串

使用 presentabsent 用于添加或删除。

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

选项

  • "absent"

  • "present" ← (默认)

  • "query"

template

字符串 / 必需

要更改的模板的名称。

timeout

整数

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

默认值为 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

username

字符串

用于身份验证的用户名。

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

validate_certs

布尔值

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

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

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

默认值为 true

选项

  • false

  • true

备注

注意

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

另请参阅

另请参阅

cisco.mso.mso_schema_template_anp_epg

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

示例

- name: Add a selector to an EPG
  cisco.mso.mso_schema_template_anp_epg_selector:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 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
  cisco.mso.mso_schema_template_anp_epg_selector:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    selector: selector_1
    state: absent

- name: Query a specific Selector
  cisco.mso.mso_schema_template_anp_epg_selector:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 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_template_anp_epg_selector:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    schema: Schema 1
    template: Template 1
    anp: ANP 1
    epg: EPG 1
    state: query
  register: query_result

作者

  • Cindy Zhao (@cizhao)