cisco.meraki.meraki_network 模块 – 管理 Meraki 云中的网络

注意

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

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

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

要在 playbook 中使用它，请指定：cisco.meraki.meraki_network。

已弃用

在以下版本中移除:

版本 3.0.0

原因:

已发布具有增强功能的新模块

替代方案:

cisco.meraki.networks

概要

• 允许在 Meraki 中创建、管理和查看网络。

参数

参数	注释
auth_key 字符串 / 必需	仪表板提供的身份验证密钥。 如果未设置环境变量 MERAKI_KEY，则为必需。
copy_from_network_id 字符串	新网络继承此网络 ID 的属性。 其他提供的参数将覆盖复制的配置。 必须与此网络的类型完全匹配的类型。
enable_vlans 布尔值	一个布尔值，指定网络是否应支持 VLAN。 需要指定 net_name 或 net_id。 选择 false true
host 字符串	Meraki 仪表板的主机名。 可用于访问区域性 Meraki 环境，如中国。 默认值： "api.meraki.com"
internal_error_retry_time 整数	如果服务器返回内部服务器错误，则重试的秒数。 默认值： 60
local_status_page_enabled 布尔值	这不再起作用，可能会移动到单独的模块。 - 启用本地设备状态页（U[my.meraki.com](my.meraki.com)、U[ap.meraki.com](ap.meraki.com)、U[switch.meraki.com](switch.meraki.com)、U[wired.meraki.com](wired.meraki.com)）。 - 只能单独指定，或与 remote_status_page_enabled 一起指定。 选择 false true
net_id 字符串	网络的 ID 号。
net_name 别名：name、network 字符串	网络的名称。
org_id 字符串	组织的 ID。
org_name 别名：organization 字符串	组织的名称。
output_format 字符串	指示模块响应键应为蛇形命名法（例如，net_id）还是驼峰命名法（例如，netId）。 选择 "snakecase" ←（默认） "camelcase"
output_level 字符串	设置模块执行期间的调试输出量。 选择 "debug" "normal" ←（默认）
rate_limit_retry_time 整数	如果触发速率限制器，则重试的秒数。 默认值： 165
remote_status_page_enabled 布尔值	这不再起作用，可能会移动到单独的模块。 启用对设备状态页的访问（http://device LAN IP）。 仅当 local_status_page_enabled: 设置为 yes 时才能设置。 只能单独指定，或与 local_status_page_enabled 一起指定。 选择 false true
state 字符串	创建或修改组织。 选择 "absent" "present" ←（默认） "query"
tags 列表 / 元素=字符串	要分配给网络的标签列表。 tags 名称与 Ansible 中的 tags 参数冲突。 缩进问题可能会导致意外行为。 Ansible 2.8 将其从逗号分隔的列表转换为列表。
timeout 整数	HTTP 请求的超时时间。 默认值： 30
timezone 字符串	与网络关联的时区。 有关有效时区的列表，请参阅 https://en.wikipedia.org/wiki/List_of_tz_database_time_zones。
type 别名：net_type 列表 / 元素=字符串	网络设备管理的网络类型。 创建网络时是必需的。 从 Ansible 2.8 开始，不再接受 combined 类型。 从 Ansible 2.8 开始，对此参数的更改不再是幂等的。 选择 “appliance”（设备） “switch”（交换机） “wireless”（无线） “sensor”（传感器） “systemsManager”（系统管理器） “camera”（摄像头） “cellularGateway”（蜂窝网关）
use_https 布尔值	如果为 no，则将使用 HTTP。否则将使用 HTTPS。 仅对 Meraki 内部开发人员有用。 选择 false true ← （默认）
use_proxy 布尔值	如果为 no，即使在目标主机上的环境变量中定义了代理，也不会使用代理。 选择 false ← （默认） true
validate_certs 布尔值	是否验证 HTTP 证书。 选择 false true ← （默认）

注释

注意

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

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

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

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

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

示例

- delegate_to: localhost
  block:
    - name: List all networks associated to the YourOrg organization
      meraki_network:
        auth_key: abc12345
        state: query
        org_name: YourOrg
    - name: Query network named MyNet in the YourOrg organization
      meraki_network:
        auth_key: abc12345
        state: query
        org_name: YourOrg
        net_name: MyNet
    - name: Create network named MyNet in the YourOrg organization
      meraki_network:
        auth_key: abc12345
        state: present
        org_name: YourOrg
        net_name: MyNet
        type: switch
        timezone: America/Chicago
        tags: production, chicago
    - name: Create combined network named MyNet in the YourOrg organization
      meraki_network:
        auth_key: abc12345
        state: present
        org_name: YourOrg
        net_name: MyNet
        type:
          - switch
          - appliance
        timezone: America/Chicago
        tags: production, chicago
    - name: Create new network based on an existing network
      meraki_network:
        auth_key: abc12345
        state: present
        org_name: YourOrg
        net_name: MyNet
        type:
          - switch
          - appliance
        copy_from_network_id: N_1234
    - name: Enable VLANs on a network
      meraki_network:
        auth_key: abc12345
        state: query
        org_name: YourOrg
        net_name: MyNet
        enable_vlans: yes
    - name: Modify local status page enabled state
      meraki_network:
        auth_key: abc12345
        state: query
        org_name: YourOrg
        net_name: MyNet
        local_status_page_enabled: yes

返回值

常见返回值在此处进行了记录，以下是此模块特有的字段

键	描述
数据 复杂	有关创建或操作的对象的信息。 返回: 信息
id 字符串	网络的标识字符串。 返回: 成功 示例: "N_12345"
local_status_page_enabled 布尔值	指示是否应启用 my.meraki.com 和其他设备门户。 返回: 成功 示例: true
name 字符串	网络的书写名称。 返回: 成功 示例: "YourNet"
organization_id 字符串	拥有该网络的组织 ID。 返回: 成功 示例: "0987654321"
remote_status_page_enabled 布尔值	启用对设备状态页面的访问。 返回: 成功 示例: true
tags 列表 / 元素=字符串	分配给网络的以空格分隔的标签。 返回: 成功 示例: ["production"]
time_zone 字符串	网络所在的地区时区。 返回: 成功 示例: "America/Chicago"
type 列表 / 元素=字符串	网络的功能类型。 返回: 成功 示例: ["switch"]

状态

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

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

作者

• Kevin Breit (@kbreit)

集合链接

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