dellemc.openmanage.ome_server_interface_profile_info 模块 – 获取 OpenManage Enterprise Modular 上的服务器接口配置文件信息。

注意

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

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

要安装它,请使用:ansible-galaxy collection install dellemc.openmanage。您需要满足进一步的要求才能使用此模块,请参阅 要求 了解详细信息。

要在 playbook 中使用它,请指定:dellemc.openmanage.ome_server_interface_profile_info

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_iddevice_service_tag 互斥。

device_service_tag

列表 / 元素=字符串

设备的 Service Tag。

device_service_tagdevice_id 互斥。

hostname

字符串 / 必需

OpenManage Enterprise Modular 的 IP 地址或主机名。

password

字符串

OpenManage Enterprise Modular 密码。

如果未提供密码,则使用环境变量 OME_PASSWORD

示例:export OME_PASSWORD=password

port

整数

OpenManage Enterprise Modular HTTPS 端口。

默认值: 443

timeout

整数

在 dellemc.openmanage 5.0.0 中添加

套接字级别的超时时间(以秒为单位)。

默认值: 30

username

字符串

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

备注

注意

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

  • 此模块支持 check_mode

示例

---
- name: Retrieves the server interface profiles of all the device using device ID.
  dellemc.openmanage.ome_server_interface_profile_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_id:
      - 10001
      - 10002

- name: Retrieves the server interface profiles of all the device using device service tag.
  dellemc.openmanage.ome_server_interface_profile_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_service_tag:
      - 6GHH6H2
      - 6KHH6H3

返回值

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

描述

error_info

字典

HTTP 错误的详细信息。

返回: HTTP 错误时

示例: {"error": {"@Message.ExtendedInfo": [{"Message": "由于发生错误,无法处理请求。", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "重试该操作。如果问题仍然存在,请联系系统管理员。", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "发生一般错误。请查看ExtendedInfo以获取更多信息。"}}

msg

字符串

服务器接口配置文件信息的总体状态。

返回: 成功时返回

示例: "已成功检索服务器接口配置文件信息。"

server_profiles

列表 / 元素=字符串

返回收集的服务器接口配置文件信息。

返回: 成功时返回

示例: [{"BondingTechnology": "LACP", "Id": "6KZK6K2", "ServerInterfaceProfile": [{"FabricId": "1ea6bf64-3cf0-4e06-a136-5046d874d1e7", "Id": "NIC.Mezzanine.1A-1-1", "NativeVLAN": 0, "Networks": [{"CreatedBy": "system", "CreationTime": "2018-11-27 10:22:14.140", "Description": "VLAN 1", "Id": 10001, "InternalRefNWUUId": "add035b9-a971-400d-a3fa-bb365df1d476", "Name\"": "VLAN 1", "Type": 2, "UpdatedBy": null, "UpdatedTime": "2018-11-27 10:22:14.140", "VlanMaximum": 1, "VlanMinimum": 1}], "NicBonded": true, "OnboardedPort": "59HW8X2:ethernet1/1/1"}, {"FabricId": "3ea6be04-5cf0-4e05-a136-5046d874d1e6", "Id": "NIC.Mezzanine.1A-2-1", "NativeVLAN": 0, "Networks": [{"CreatedBy": "system", "CreationTime": "2018-09-25 14:46:12.374", "Description": null, "Id": 10155, "InternalRefNWUUId": "f15a36b6-e3d3-46b2-9e7d-bf9cd66e180d", "Name": "jagvlan", "Type": 1, "UpdatedBy": null, "UpdatedTime": "2018-09-25 14:46:12.374", "VlanMaximum": 143, "VlanMinimum": 143}], "NicBonded": false, "OnboardedPort": "6H7J6Z2:ethernet1/1/1"}]}]

作者

  • Felix Stephen (@felixs88)