dellemc.openmanage.ome_template_network_vlan 模块 – 在 OpenManage Enterprise 上设置模板支持的原生网卡的标记和未标记 VLAN

注意

此模块是 dellemc.openmanage 集合 (版本 9.9.0) 的一部分。

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

要安装它，请使用：ansible-galaxy collection install dellemc.openmanage。您需要其他要求才能使用此模块，请参阅 需求 了解详情。

要在 playbook 中使用它，请指定：dellemc.openmanage.ome_template_network_vlan。

dellemc.openmanage 2.0.0 中的新增功能

概要

• 此模块允许在 OpenManage Enterprise 上设置模板支持的原生网卡的标记和未标记 VLAN。

需求

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

• python >= 3.9.6

参数

参数	注释
ca_path 路径 在 dellemc.openmanage 5.0.0 中添加	包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。
hostname 字符串 / 必填	OpenManage Enterprise 或 OpenManage Enterprise Modular 的 IP 地址或主机名。
nic_identifier 字符串 / 必填	模板中用于 VLAN 配置的 NIC 端口的显示名称。
password 字符串	OpenManage Enterprise 或 OpenManage Enterprise Modular 密码。 如果未提供密码，则使用环境变量 OME_PASSWORD。 示例：export OME_PASSWORD=password
port 整数	OpenManage Enterprise 或 OpenManage Enterprise Modular 的 HTTPS 端口。 默认值： 443
propagate_vlan 布尔值 在 dellemc.openmanage 3.4.0 中添加	立即部署修改后的 VLAN 设置，无需重新启动服务器。 仅当 VLAN 配置发生更改时，才会应用此选项。 选项 false true ← (默认)
tagged_networks 列表 / 元素=字典	标记的 VLAN 列表及其对应的 NIC 端口。
port 整数 / 必填	标记 VLAN 的 NIC 端口号
tagged_network_ids 列表 / 元素=整数	标记 VLAN 的 ID 列表 输入 [] 可从端口中删除标记的 VLAN。 在向端口添加标记的 VLAN 时，将 tagged_network_ids 列表与 tagged_network_names 列表组合。 要获取 VLAN 网络 ID，请使用 API ` https://I(hostname <%20https://I(hostname>`__/api/NetworkConfigurationService/Networks)
tagged_network_names 列表 / 元素=字符串	标记的 VLAN 名称列表 输入 [] 可从端口中删除标记的 VLAN。 在向端口添加标记的 VLAN 时，将 tagged_network_names 列表与 tagged_network_ids 列表组合。
template_id 整数	模板的 ID。 它与 template_name 互斥。
template_name 字符串	模板的名称。 它与 template_id 互斥。
timeout 整数 在 dellemc.openmanage 5.0.0 中添加	以秒为单位的套接字级别超时。 默认值： 30
untagged_networks 列表 / 元素=字典	未标记的网络列表及其对应的 NIC 端口。
port 整数 / 必填	未标记 VLAN 的 NIC 端口号。
untagged_network_id 整数	未标记 VLAN 的 ID 输入 0 可清除端口上的未标记 VLAN。 此选项与 untagged_network_name 互斥 要获取 VLAN 网络 ID，请使用 API ` https://I(hostname <%20https://I(hostname>`__/api/NetworkConfigurationService/Networks)
untagged_network_name 字符串	用于取消标记的 VLAN 名称 提供 0 可清除此 port 的取消标记。 此参数与 untagged_network_id 互斥
username 字符串	OpenManage Enterprise 或 OpenManage Enterprise Modular 用户名。 如果未提供用户名，则使用环境变量OME_USERNAME。 示例：export OME_USERNAME=username
validate_certs 布尔值 在 dellemc.openmanage 5.0.0 中添加	如果为false，则不会验证SSL证书。 仅在使用自签名证书的个人控制站点上配置false。 在集合版本5.0.0之前，validate_certs默认为false。 选项 false true ← (默认)
x_auth_token 字符串 新增于dellemc.openmanage 9.3.0	身份验证令牌。 如果未提供x_auth_token，则使用环境变量OME_X_AUTH_TOKEN。 示例：export OME_X_AUTH_TOKEN=x_auth_token

注释

注意

• 从可以直接访问Dell OpenManage Enterprise的系统运行此模块。

• 此模块支持check_mode。

示例

---
- name: Add tagged or untagged VLANs to a template using VLAN ID and name
  dellemc.openmanage.ome_template_network_vlan:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    template_id: 78
    nic_identifier: NIC Slot 4
    untagged_networks:
      - port: 1
        untagged_network_id: 127656
      - port: 2
        untagged_network_name: vlan2
    tagged_networks:
      - port: 1
        tagged_network_ids:
          - 12767
          - 12768
      - port: 4
        tagged_network_ids:
          - 12767
          - 12768
        tagged_network_names:
          - vlan3
      - port: 2
        tagged_network_names:
          - vlan4
          - vlan1

- name: Clear the tagged and untagged VLANs from a template
  dellemc.openmanage.ome_template_network_vlan:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    template_id: 78
    nic_identifier: NIC Slot 4
    untagged_networks:
      # For removing the untagged VLANs for the port 1 and 2
      - port: 1
        untagged_network_id: 0
      - port: 2
        untagged_network_name: 0
    tagged_networks:
      # For removing the tagged VLANs for port 1, 4 and 2
      - port: 1
        tagged_network_ids: []
      - port: 4
        tagged_network_ids: []
        tagged_network_names: []
      - port: 2
        tagged_network_names: []

返回值

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

键	描述
error_info 字典	HTTP错误的详细信息。 返回：HTTP错误时 示例：{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to complete the request because TemplateId  does not exist or is not applicable for the resource URI.", "MessageArgs": ["TemplateId"], "MessageId": "CGEN1004", "RelatedProperties": [], "Resolution": "Check the request resource URI. Refer to the OpenManage Enterprise-Modular User's Guide for more information about resource URI and its properties.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}
msg 字符串	模板VLAN操作的总体状态。 返回：始终 示例："Successfully applied the network settings to template."

作者

• Jagadeesh N V(@jagadeeshnv)

集合链接

• 问题跟踪器
• 主页
• 代码库（源代码）