cisco.meraki.meraki_ms_l3_interface 模块 – 管理 MS 交换机上的路由接口

注意

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

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

要安装它，请使用：ansible-galaxy collection install cisco.meraki。

要在剧本中使用它，请指定：cisco.meraki.meraki_ms_l3_interface。

已弃用

在以下版本中删除:

3.0.0 版本

原因:

更新后的模块发布，功能增强

替代方案:

cisco.meraki.devices_switch_routing_interfaces

概要

• 允许创建、管理和查看 Meraki MS 交换机上的路由接口。

参数

参数	注释
auth_key 字符串 / 必需	仪表板提供的身份验证密钥。如果未设置环境变量 MERAKI_KEY，则为必需。
default_gateway 字符串	任何不发往直接连接的子网或通过静态路由的流量的下一跳。 此 IP 地址必须存在于具有路由接口的子网中。
host 字符串	Meraki 仪表板的主机名。 可用于访问区域性 Meraki 环境，例如中国。 默认值： "api.meraki.com"
interface_id 字符串	第 3 层接口的唯一标识号。
interface_ip 字符串	此交换机将用于此 VLAN 或子网上的第 3 层路由的 IP 地址。 这不能与交换机的管理 IP 相同。
internal_error_retry_time 整数	如果服务器返回内部服务器错误，则重试的秒数。 默认值： 60
multicast_routing 字符串	如果需要在 VLAN 之间进行多播路由，则启用多播支持。 选择 "disabled" "enabled" "IGMP 窥探 查询器"
name 字符串	接口或 VLAN 的友好名称或描述。
org_id 字符串	组织 ID。
org_name 别名：organization 字符串	组织名称。
ospf_settings 字典	接口的 OSPF 路由设置。
area 字符串	此接口应属于的 OSPF 区域。 可以是“disabled”或现有 OSPF 区域的标识符。
cost 整数	此接口的路径成本。
is_passive_enabled 布尔值	启用后，OSPF 将不会在接口上运行，但仍将播发子网。 选择 false true
output_format 字符串	指示模块响应键是否应使用蛇形命名法（例如 net_id）或驼峰命名法（例如 netId）。 选择 "snakecase" ← (默认) "camelcase"
output_level 字符串	设置模块执行期间的调试输出量。 选择 "debug" "normal" ← (默认)
rate_limit_retry_time 整数	如果触发速率限制器，则重试的秒数。 默认值： 165
serial 字符串	托管第 3 层接口的 MS 交换机的序列号。
state 字符串	创建或修改组织。 选择 "present" ← (默认) "query" "absent"
subnet 字符串	此路由接口所在的网络，采用 CIDR 表示法。
timeout 整数	HTTP 请求的超时时间。 默认值： 30
use_https 布尔值	如果为 no，它将使用 HTTP。否则，它将使用 HTTPS。 仅对内部 Meraki 开发人员有用。 选择 false true ← (默认)
use_proxy 布尔值	如果为 no，它将不使用代理，即使在目标主机上的环境变量中定义了代理。 选择 false ← (默认) true
validate_certs 布尔值	是否验证 HTTP 证书。 选择 false true ← (默认)
vlan_id 整数	此路由接口所在的 VLAN。 VLAN 必须介于 1 和 4094 之间。

注释

注意

• 一旦创建了第 3 层接口，API 就不允许更新该接口并指定 default_gateway。

• 有关 Meraki API 的更多信息，请访问 https://dashboard.meraki.com/api_docs。

• 某些选项可能仅供 Meraki 内部的开发人员使用。

• 从 Ansible 2.9 开始，Meraki 模块将键输出为蛇形命名法。要使用驼峰命名法，请将 ANSIBLE_MERAKI_FORMAT 环境变量设置为 camelcase。

• Ansible 的 Meraki 模块将在 Ansible 2.13 中停止支持驼峰命名法输出。请更新您的 playbook。

• 检查模式会从仪表板下载当前配置，然后将更改与此下载内容进行比较。如果配置存在差异，检查模式将报告已更改，但不会将更改提交到 API 以进行更改验证。

示例

- name: Query all l3 interfaces
  meraki_ms_l3_interface:
    auth_key: abc123
    state: query
    serial: aaa-bbb-ccc

- name: Query one l3 interface
  meraki_ms_l3_interface:
    auth_key: abc123
    state: query
    serial: aaa-bbb-ccc
    name: Test L3 interface

- name: Create l3 interface
  meraki_ms_l3_interface:
    auth_key: abc123
    state: present
    serial: aaa-bbb-ccc
    name: "Test L3 interface 2"
    subnet: "192.168.3.0/24"
    interface_ip: "192.168.3.2"
    multicast_routing: disabled
    vlan_id: 11
    ospf_settings:
      area: 0
      cost: 1
      is_passive_enabled: true

- name: Update l3 interface
  meraki_ms_l3_interface:
    auth_key: abc123
    state: present
    serial: aaa-bbb-ccc
    name: "Test L3 interface 2"
    subnet: "192.168.3.0/24"
    interface_ip: "192.168.3.2"
    multicast_routing: disabled
    vlan_id: 11
    ospf_settings:
      area: 0
      cost: 2
      is_passive_enabled: true

- name: Delete l3 interface
  meraki_ms_l3_interface:
    auth_key: abc123
    state: absent
    serial: aaa-bbb-ccc
    interface_id: abc123344566

返回值

通用返回值已在此处记录 此处，以下是此模块独有的字段

键	描述
数据 复杂	有关第 3 层接口的信息。 返回： 成功
default_gateway 字符串	任何不发往直接连接的子网或通过静态路由的流量的下一跳。 返回： 成功 示例： "192.168.2.1"
interface_id 字符串	第 3 层接口的唯一标识号。 返回： 成功 示例： "62487444811111120"
interface_ip 字符串	此交换机将用于此 VLAN 或子网上的第 3 层路由的 IP 地址。 返回： 成功 示例： "192.168.2.2"
multicast_routing 字符串	如果需要在 VLAN 之间进行多播路由，则启用多播支持。 返回： 成功 示例： "disabled"
name 字符串	接口或 VLAN 的友好名称或描述。 返回： 成功 示例： "L3 interface"
ospf_settings 复杂	接口的 OSPF 路由设置。 返回： 成功
area 字符串	此接口应属于的 OSPF 区域。 返回： 成功 示例： "0"
cost 整数	此接口的路径成本。 返回： 成功 示例： 1
is_passive_enabled 布尔值	启用后，OSPF 将不会在接口上运行，但仍将播发子网。 返回： 成功 示例： true
subnet 字符串	此路由接口所在的网络，采用 CIDR 表示法。 返回： 成功 示例： "192.168.2.0/24"
vlan_id 整数	此路由接口所在的 VLAN。 返回： 成功 示例： 10

状态

• 此模块将在 3.0.0 版本中删除。 [已弃用]

• 有关更多信息，请参阅 已弃用。

作者

• Kevin Breit (@kbreit)

集合链接

• 问题跟踪器
• 存储库（源）