community.vmware.vmware_dvswitch_uplink_pg 模块 – 管理分布式交换机的上行链路端口组配置

注意

此模块是 community.vmware 集合 (版本 5.2.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：community.vmware.vmware_dvswitch_uplink_pg。

概要

• 此模块可用于配置分布式交换机的上行链路端口组。

参数

参数	注释
advanced 别名：port_policy 字典	配置上行链路端口组的高级策略设置的字典。 默认值： {"block_override": true, "netflow_override": false, "port_config_reset_at_disconnect": true, "traffic_filter_override": false, "vendor_config_override": false, "vlan_override": false}
block_override 布尔值	指示是否可以按端口更改阻塞策略。 选项 false true ← (默认)
netflow_override 布尔值	指示是否可以按端口更改 NetFlow 策略。 选项 false ← (默认) true
port_config_reset_at_disconnect 布尔值	指示断开连接后是否自动重置端口配置。 选项 false true ← (默认)
traffic_filter_override 布尔值	指示是否可以按端口更改流量过滤器。 选项 false ← (默认) true
vendor_config_override 布尔值	指示是否可以按端口更改供应商配置。 选项 false ← (默认) true
vlan_override 布尔值	指示是否可以按端口更改 VLAN。 选项 false ← (默认) true
block_all_ports 布尔值	指示上行链路端口组上的所有端口是否都被阻塞。 选项 false ← (默认) true
description 字符串	上行链路端口组的描述。
hostname 字符串	vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。 如果任务中未指定此值，则将使用环境变量 VMWARE_HOST 的值。
lacp 字典	配置上行链路端口组的 LACP 设置的字典。 只有当 LACP 支持模式设置为“basic”时，才会使用这些选项。 默认值： {"mode": "passive", "status": "disabled"}
mode 字符串	上行链路/端口的协商状态。 选项 "active" "passive" ← (默认)
status 字符串	指示是否启用 LACP。 选项 "enabled" "disabled" ← (默认)
name 字符串	上行链路端口组的名称。 如果未指定，则使用当前名称。
netflow_enabled 布尔值	指示上行链路端口组上是否启用了 NetFlow。 选项 false ← (默认) true
password 别名：pass, pwd 字符串	vSphere vCenter 或 ESXi 服务器的密码。 如果任务中未指定此值，则将使用环境变量 VMWARE_PASSWORD 的值。
port 整数	vSphere vCenter 或 ESXi 服务器的端口号。 如果任务中未指定此值，则将使用环境变量 VMWARE_PORT 的值。 默认值： 443
proxy_host 字符串	将接收所有 HTTPS 请求并转发它们的代理的地址。 格式为主机名或 IP。 如果任务中未指定此值，则将使用环境变量 VMWARE_PROXY_HOST 的值。
proxy_port 整数	将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。 如果任务中未指定此值，则将使用环境变量 VMWARE_PROXY_PORT 的值。
switch 别名：dvswitch 字符串 / 必需	分布式交换机的名称。
用户名 别名: admin, user 字符串	vSphere vCenter 或 ESXi 服务器的用户名。 如果任务中未指定此值，则将使用环境变量 VMWARE_USER 的值。
validate_certs 布尔值	允许在 SSL 证书无效时连接。当证书不受信任时，将其设置为 false。 如果任务中未指定此值，则将使用环境变量 VMWARE_VALIDATE_CERTS 的值。 选项 false true ← (默认)
vlan_trunk_range 列表 / 元素=字符串	应与上行链路端口组一起配置的 VLAN Trunk 范围。 这可以是多个范围和数字的组合，例如：[2-3967, 4049-4092]。 默认值： ["0-4094"]

备注

注意

• 所有模块都需要 API 写入访问权限，因此在免费 ESXi 许可证上不受支持。

• 所有变量和 VMware 对象名称都区分大小写。

示例

- name: Configure Uplink portgroup
  community.vmware.vmware_dvswitch_uplink_pg:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcsa_username }}'
    password: '{{ vcsa_password }}'
    switch: dvSwitch
    name: dvSwitch-DVUplinks
    advanced:
      port_config_reset_at_disconnect: true
      block_override: true
      vendor_config_override: false
      vlan_override: false
      netflow_override: false
      traffic_filter_override: false
    vlan_trunk_range:
      - '0-4094'
    netflow_enabled: false
    block_all_ports: false
  delegate_to: localhost

- name: Enabled LACP on Uplink portgroup
  community.vmware.vmware_dvswitch_uplink_pg:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcsa_username }}'
    password: '{{ vcsa_password }}'
    switch: dvSwitch
    lacp:
      status: enabled
      mode: active
  delegate_to: localhost

返回值

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

键

描述

result 字符串

有关执行操作的信息 返回值：始终 示例： "{'adv_block_ports': True, 'adv_netflow': False, 'adv_reset_at_disconnect': True, 'adv_traffic_filtering': False, 'adv_vendor_conf': False, 'adv_vlan': False, 'block_all_ports': False, 'changed': False, 'description': None, 'dvswitch': 'dvSwitch', 'lacp_status': 'disabled', 'lacp_status_previous': 'enabled', 'name': 'dvSwitch-DVUplinks', 'netflow_enabled': False, 'result': 'Uplink portgroup already configured properly', 'vlan_trunk_range': ['2-3967', '4049-4092']}"

作者

• Christian Kotte (@ckotte)

资源链接

• 问题追踪器
• 主页
• 代码仓库