dellemc.openmanage.omevv_firmware_repository_profile 模块 – 创建、修改或删除 OMEVV 固件库配置文件

注意

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

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

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

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

dellemc.openmanage 9.8.0 中的新增功能

概要 

此模块允许您创建、修改或删除 OpenManage Enterprise 集成 VMware Center (OMEVV) 固件库配置文件。

需求 

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

python >= 3.9.6

参数 

参数	注释
ca_path 路径	包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。
catalog_path 字符串	目录的绝对路径。支持 HTTP、HTTPS、NFS 和 CIFS 路径。当 state 为 `present` 时，此参数是必需的。
description 字符串	OMEVV 固件库配置文件的描述。
hostname 字符串 / 必需	OpenManage Enterprise Modular 的 IP 地址或主机名。
name 字符串	OMEVV 固件库配置文件的名称。当 state 为 `absent` 时，此参数对于修改操作是必需的。
new_name 字符串	执行修改操作时新的 OMEVV 配置文件的名称。
port 整数	OpenManage Enterprise HTTPS 端口。默认值： `443`
protocol_type 字符串	`NFS` 表示 NFS 共享路径。 `CIFS` 表示 CIFS 共享路径。 `HTTP` 表示 HTTP 共享路径。 `HTTPS` 表示 HTTPS 共享路径。当 state 为 `present` 且创建新配置文件时，此参数是必需的。选项 `"NFS"` `"CIFS"` `"HTTP"` `"HTTPS"`
share_domain 字符串	共享的域。
share_password 字符串	共享的密码。当 catalog_path 为 HTTPS 或 CIFS 时，此参数是必需的。
share_username 字符串	共享的用户名。当 catalog_path 为 HTTPS 或 CIFS 时，此参数是必需的。
state 字符串	`present` 创建 OMEVV 固件库配置文件，如果存在同名配置文件则修改现有配置文件。 `absent` 删除 OMEVV 固件库配置文件。当 state 为 `absent` 时，profile_name 或 profile_id 是必需的。选项 `"present"` ← (默认) `"absent"`
timeout 整数	以秒为单位的套接字级别超时。默认值： `30`
validate_certs 布尔值	是否检查 SSL 证书。- 如果为 `true`，则将验证 SSL 证书。- 如果为 `false`，则将不验证 SSL 证书。选项 `false` `true` ← (默认)
vcenter_password 字符串	OpenManage Enterprise 集成 VMware vCenter (OMEVV) 的密码。如果未提供密码，则使用环境变量 `OMEVV_VCENTER_PASSWORD`。示例：export OMEVV_VCENTER_PASSWORD=password
vcenter_username 字符串	OpenManage Enterprise 集成 VMware vCenter (OMEVV) 的用户名。如果未提供用户名，则使用环境变量 `OMEVV_VCENTER_USERNAME`。示例：export OMEVV_VCENTER_USERNAME=username
vcenter_uuid 字符串	vCenter 的通用唯一标识符 (UUID)。可以使用 dellemc.openmanage.omevv_vcenter_info 模块检索 vCenter UUID 详情。如果未提供 UUID，则使用环境变量`OMEVV_VCENTER_UUID`。示例：export OMEVV_VCENTER_UUID=uuid

属性 

属性	支持	描述
check_mode	支持：完全支持	运行任务以进行验证，无需对目标机器执行操作。
diff_mode	支持：完全支持	运行任务以报告已进行的更改或必须应用的更改。

备注 

注意

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

示例 

---
- name: Create an OMEVV firmware repository profile
  dellemc.openmanage.omevv_firmware_repository_profile:
    hostname: "192.168.0.1"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    state: present
    name: profile-1
    catalog_path: http://xx.xx.xx.xx/share/Catalog/Catalog.xml

- name: Modify an OMEVV firmware repository profile
  dellemc.openmanage.omevv_firmware_repository_profile:
    hostname: "192.168.0.1"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    state: present
    name: profile-1
    new_name: profile-2
    catalog_path: http://xx.xx.xx.xx/new_share/Catalog/Catalog.xml

- name: Delete an OMEVV firmware repository profile
  dellemc.openmanage.omevv_firmware_repository_profile:
    hostname: "192.168.0.1"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    state: absent
    name: profile-1

返回值 

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

键	描述
error_info 字典	HTTP 错误的详细信息。返回： HTTP 错误时示例：`{"errorCode": "18001", "message": "Repository profile with name Test already exists."}`
msg 字符串	配置文件操作的状态。返回：始终返回示例：`"Successfully created the OMEVV firmware repository profile."`

作者

Shivam Sharma(@ShivamSh3)