dellemc.openmanage.omevv_vcenter_info 模块 – 检索所有或特定的 OpenManage Enterprise vCenter 信息。

注意

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

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

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

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

dellemc.openmanage 9.8.0 中的新增功能

概要

  • 此模块允许您从 OpenManage Enterprise 检索所有或特定的 vCenter 信息。

要求

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

  • python >= 3.9.6

参数

参数

注释

ca_path

路径

在 dellemc.openmanage 5.0.0 中添加

包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。

hostname

字符串 / 必需

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

password

字符串

OpenManage Enterprise 或 OpenManage Enterprise Modular 密码。

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

示例：export OME_PASSWORD=password

port

整数

OpenManage Enterprise 或 OpenManage Enterprise Modular HTTPS 端口。

默认值： 443

timeout

整数

在 dellemc.openmanage 5.0.0 中添加

套接字级别的超时时间（以秒为单位）。

默认值： 30

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 ← (默认)

vcenter_hostname

字符串

vCenter IP 地址或主机名。

如果提供 vcenter_hostname，则模块仅检索指定的 vCenter 信息。

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

支持：完整

运行任务以进行验证，而不在目标计算机上执行操作。

备注

注意

  • 此模块支持 IPv4 和 IPv6 地址。

示例

---
- name: Retrieve all vCenter information.
  dellemc.openmanage.omevv_vcenter_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "path/to/ca_file"

- name: Retrieve specific vCenter information.
  dellemc.openmanage.omevv_vcenter_info:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "path/to/ca_file"
    vcenter_hostname: xx.xx.xx.xx

返回值

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

键

描述

error_info

字典

HTTP 错误的详细信息。

返回：在 HTTP 错误时返回

示例： {"error": {"@Message.ExtendedInfo": [{"Message": "无法处理请求，因为发生错误。", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "重试该操作。如果问题仍然存在，请联系您的系统管理员。", "Severity": "严重"}], "code": "Base.1.0.GeneralError", "message": "发生了一般错误。有关更多信息，请参阅 ExtendedInfo。"}}

msg

字符串

检索操作的 vCenter 信息状态。

返回: 总是

示例: "成功检索了 vCenter 信息。"

vcenter_info

列表 / 元素=字典

有关 vCenter 的信息。

返回: 成功

示例: [{"consoleAddress": "vcenter_ip_or_hostname", "description": "vCenter 8.0", "registeredExtensions": ["PHM", "WEBCLIENT", "PHA", "VLCM"], "uuid": "77373c7e-d2b0-453b-9888-102499919bd1"}, {"consoleAddress": "vcenter_ip_or_hostname", "description": "vCenter 8.1", "registeredExtensions": ["PHM", "WEBCLIENT", "PHA", "VLCM"], "uuid": "77373c7e-d2b0-453b-9888-102499919bd2"}]

作者

  • Lovepreet Singh (@singh-lovepreet1)