vmware.vmware.cluster_vcls 模块 – 管理此集群的 vCLS（vSphere 集群服务）虚拟机磁盘放置位置。

注意

此模块是 vmware.vmware 集合（版本 1.7.1）的一部分。

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

要安装它，请使用：ansible-galaxy collection install vmware.vmware。

要在 playbook 中使用它，请指定：vmware.vmware.cluster_vcls。

概要 

覆盖此集群的默认 vCLS 虚拟机磁盘放置位置。
如果数据存储被 vCLS 无法配置的解决方案（例如 SRM 或 vSAN 维护模式）阻止，则可能无法为 vCLS 配置数据存储。

参数 

参数	注释
allowed_datastores 列表 / 元素=字符串	允许的数据存储的独占列表。如果 vCenter 中已配置现有列表，则此值将覆盖该列表。
集群别名：cluster_name 字符串 / 必需	要管理的集群的名称。
数据中心别名：datacenter_name 字符串	可以找到集群和数据存储的数据中心的名称。如果集群名称在您的环境中是唯一的，则数据中心是可选的。
datastores_to_add 列表 / 元素=字符串	要添加到 vCLS 配置中的数据存储列表模块将确保这些数据存储存在于配置中，并且不会更改其他存在的数据存储。
datastores_to_remove 列表 / 元素=字符串	要从 vCLS 配置中删除的数据存储列表模块将确保这些数据存储不存在于配置中，并且不会更改其他存在的数据存储。
hostname 字符串	vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。如果任务中未指定此值，则将改为使用环境变量 `VMWARE_HOST` 的值。
密码别名：pass，pwd 字符串	vSphere vCenter 或 ESXi 服务器的密码。如果任务中未指定此值，则将改为使用环境变量 `VMWARE_PASSWORD` 的值。
port 整数	vSphere vCenter 或 ESXi 服务器的端口号。如果任务中未指定此值，则将改为使用环境变量 `VMWARE_PORT` 的值。默认值： `443`
proxy_host 字符串	将接收所有 HTTPS 请求并转发它们的代理的地址。格式为主机名或 IP。如果任务中未指定此值，则将改为使用环境变量 `VMWARE_PROXY_HOST` 的值。
proxy_port 整数	将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。如果任务中未指定此值，则将改为使用环境变量 `VMWARE_PROXY_PORT` 的值。
用户名别名：admin，user 字符串	vSphere vCenter 或 ESXi 服务器的用户名。如果任务中未指定此值，则将改为使用环境变量 `VMWARE_USER` 的值。
validate_certs 布尔值	允许在 SSL 证书无效时连接。当证书不受信任时，将其设置为 `false`。如果任务中未指定此值，则将改为使用环境变量 `VMWARE_VALIDATE_CERTS` 的值。选项 `false` `true` ← (默认)

备注 

注意

所有模块都需要 API 写入权限，因此在免费 ESXi 许可证上不支持。
所有变量和 VMware 对象名称都区分大小写。

示例 

- name: Set Allowed vCLS Datastores
  vmware.vmware.cluster_vcls:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    datacenter_name: datacenter
    cluster_name: cluster
    allowed_datastores:
      - ds1
      - ds2

- name: Make sure DS1 is Allowed and DS2 is Not
  vmware.vmware.cluster_vcls:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    datacenter_name: datacenter
    cluster_name: cluster
    datastores_to_add:
      - ds1
    datastores_to_remove:
      - ds2

返回值 

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

键	描述
added_datastores 列表 / 元素=字符串	此模块添加的数据存储列表。如果没有需要添加的，则为空返回：始终示例： `["ds3"]`
allowed_datastores 列表 / 元素=字符串	活动配置中（模块完成之后）的所有数据存储的完整列表返回：始终示例： `["ds1 ds2 ds3"]`
reconfig_task_result 字典	有关重新配置 vCLS 的 vSphere 任务的信息返回：发生更改时示例： `{"completion_time": "2024-07-29T15:27:37.041577+00:00", "entity_name": "test-5fb1_cluster", "error": null, "result": null, "state": "success"}`
removed_datastores 列表 / 元素=字符串	此模块删除的数据存储列表。如果没有需要删除的，则为空返回：始终示例： `["ds4"]`

作者

Ansible云团队 (@ansible-collections)