dellemc.openmanage.ome_server_interface_profiles 模块 – 配置服务器接口配置文件

注意

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

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

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

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

dellemc.openmanage 5.1.0 中的新增功能

概要

• 此模块允许在 OpenManage Enterprise Modular 上配置服务器接口配置文件。

要求

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

• python >= 3.9.6

参数

参数	注释
ca_path 路径 在 dellemc.openmanage 5.0.0 中添加	包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。
device_id 列表 / 元素=整数	机箱结构下服务器的设备 ID。 device_id 和 device_service_tag 是互斥的。
device_service_tag 列表 / 元素=字符串	机箱结构下服务器的服务标签。 device_service_tag 和 device_id 是互斥的。
hostname 字符串 / 必需	OpenManage Enterprise Modular IP 地址或主机名。
job_wait 布尔值	提供等待作业完成的选项。 选择 false true ←（默认）
job_wait_timeout 整数	job_wait 的最大等待时间（以秒为单位）。仅在此持续时间内跟踪作业。 仅当 job_wait 为 true 时，此选项才适用。 默认值： 120
nic_configuration 列表 / 元素=字典	要应用的服务器的 NIC 配置。
nic_identifier 字符串 / 必需	NIC 的 ID 或端口号。 注意 这不会被验证。
tagged_networks 字典	标记网络列表 如果网络已分配给未标记的网络，则不能将其添加为标记网络
names 列表 / 元素=字符串 / 必需	要标记为标记网络的网络名称列表 可以使用 dellemc.openmanage.ome_network_vlan_info 检索 names
state 字符串	指示是否需要添加或删除网络列表。 present 将网络添加到标记列表 absent 从标记列表中删除网络 选择 "present" ←（默认） "absent"
team 布尔值	将两个或多个端口分组。这些端口必须连接到同一对以太网交换机。 仅当 nic_teaming 为 LACP 时，team 才适用。 选择 false true
untagged_network 整数	要取消标记的网络的最高或最低 VLAN ID。 可以使用 dellemc.openmanage.ome_network_vlan_info 检索 untagged_network 如果需要取消设置 untagged_network，则需要将其发送为 0 注意 如果网络已分配给标记网络，则不能将其添加为未标记网络。
nic_teaming 字符串	NIC 绑定选项。 NoTeaming NIC 不绑定，不提供负载均衡或冗余。 LACP 使用 LACP 进行 NIC 绑定。 Other 使用其他技术进行 NIC 绑定。 选择 "LACP" "NoTeaming" "Other"
password 字符串	OpenManage Enterprise Modular 密码。 如果未提供密码，则会使用环境变量 OME_PASSWORD。 示例：export OME_PASSWORD=password
端口 整数	OpenManage Enterprise Modular HTTPS 端口。 默认值： 443
超时 整数 在 dellemc.openmanage 5.0.0 中添加	套接字级别的超时时间，单位为秒。 默认值： 30
用户名 字符串	OpenManage Enterprise Modular 用户名。 如果未提供用户名，则会使用环境变量 OME_USERNAME。 示例：export OME_USERNAME=username
验证证书 布尔值 在 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

注意

注意

• 此模块支持 check_mode。

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

示例

---
- name: Modify Server Interface Profile for the server using the service tag
  dellemc.openmanage.ome_server_interface_profiles:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag:
      - SVCTAG1
      - SVCTAG2
    nic_teaming: LACP
    nic_configuration:
      - nic_identifier: NIC.Mezzanine.1A-1-1
        team: false
        untagged_network: 2
        tagged_networks:
          names:
            - vlan1
      - nic_identifier: NIC.Mezzanine.1A-2-1
        team: true
        untagged_network: 3
        tagged_networks:
          names:
            - range120-125

- name: Modify Server Interface Profile for the server using the device id
  dellemc.openmanage.ome_server_interface_profiles:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id:
      - 34523
      - 48999
    nic_teaming: NoTeaming
    nic_configuration:
      - nic_identifier: NIC.Mezzanine.1A-1-1
        team: false
        untagged_network: 2
        tagged_networks:
          names:
            - vlan2
      - nic_identifier: NIC.Mezzanine.1A-2-1
        team: true
        untagged_network: 3
        tagged_networks:
          names:
            - range120-125

返回值

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

键	描述
error_info 字典	HTTP 错误的详细信息。 返回： 在 HTTP 错误时 示例： {"error": {"@Message.ExtendedInfo": [{"Message": "无法处理请求，因为发生错误。", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "重试该操作。如果问题仍然存在，请联系您的系统管理员。", "Severity": "严重"}], "code": "Base.1.0.GeneralError", "message": "发生了一般错误。有关详细信息，请参阅 ExtendedInfo。"}}
job_id 整数	应用服务器接口配置文件的任务的作业 ID。 返回： 在应用接口配置文件时 示例： 14123
msg 字符串	整体服务器接口操作的状态。 返回： 总是 示例： "成功触发应用服务器配置文件作业。"

作者

• Jagadeesh N V (@jagadeeshnv)

集合链接

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