ngine_io.cloudstack.cs_storage_pool 模块 – 管理基于 Apache CloudStack 的云上的主存储池。

注意

此模块是 ngine_io.cloudstack 集合（版本 2.5.0）的一部分。

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

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

要在 playbook 中使用它，请指定：ngine_io.cloudstack.cs_storage_pool。

ngine_io.cloudstack 0.1.0 中的新增功能

概要

• 创建、更新、置于维护模式、禁用、启用和删除存储池。

要求

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

• python >= 2.6

• cs >= 0.9.0

参数

参数	注释
allocation_state 字符串	存储池的分配状态。 选项 "enabled" "disabled" "maintenance"
api_http_method 字符串	用于查询 API 端点的 HTTP 方法。 如果未给定，则考虑 CLOUDSTACK_METHOD 环境变量。 选项 "get" ← (默认) "post"
api_key 字符串 / 必需	CloudStack API 的 API 密钥。 如果未给定，则考虑 CLOUDSTACK_KEY 环境变量。
api_secret 字符串 / 必需	CloudStack API 的密钥。 如果未设置，则考虑 CLOUDSTACK_SECRET 环境变量。
api_timeout 整数	HTTP 超时（以秒为单位）。 如果未给定，则考虑 CLOUDSTACK_TIMEOUT 环境变量。 默认： 10
api_url 字符串 / 必需	CloudStack API 的 URL，例如 https://cloud.example.com/client/api。 如果未给定，则考虑 CLOUDSTACK_ENDPOINT 环境变量。
api_verify_ssl_cert 字符串	验证 CA 授权证书文件。 如果未给定，则考虑 CLOUDSTACK_VERIFY 环境变量。
capacity_bytes 整数	CloudStack 可以从此存储池配置的字节数。
capacity_iops 整数	CloudStack 可以从此存储池配置的字节数。
cluster 字符串	群集的名称。
hypervisor 字符串	创建区域范围的池时必需。 可能的值为 KVM、VMware、BareMetal、XenServer、LXC、HyperV、UCS、OVM、Simulator。
managed 布尔值	存储池是否应由 CloudStack 管理。 仅在创建时考虑。 选项 false true
name 字符串 / 必需	存储池的名称。
pod 字符串	Pod 的名称。
provider 字符串	存储提供商的名称，例如 SolidFire、SolidFireShared、DefaultPrimary、CloudByte。 默认： "DefaultPrimary"
scope 字符串	存储池的范围。 当提供 cluster 时，默认为群集，否则为区域。 选项 "cluster" "zone"
state 字符串	存储池的状态。 选项 "present" ← (默认) "absent"
storage_tags 别名：storage_tag 列表 / elements=string	与此存储池关联的标签。
storage_url 字符串	存储池的 URL。 如果 *state=present*，则为必需项。
validate_certs 布尔值 在 ngine_io.cloudstack 2.4.0 中添加	如果 false，则不会验证 SSL 证书。 如果未给定，则考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。 这应该仅在使用自签名证书的个人控制站点上使用。 选项 false true ← (默认)
zone 字符串 / 必需	应在其中部署主机的区域的名称。

说明

注意

• 有关 cloudstack 模块的详细指南，请参阅 CloudStack 云指南。

• 此模块支持检查模式。

示例

- name: ensure a zone scoped storage_pool is present
  ngine_io.cloudstack.cs_storage_pool:
    zone: zone01
    storage_url: rbd://admin:[email protected]/poolname
    provider: DefaultPrimary
    name: Ceph RBD
    scope: zone
    hypervisor: KVM

- name: ensure a cluster scoped storage_pool is disabled
  ngine_io.cloudstack.cs_storage_pool:
    name: Ceph RBD
    zone: zone01
    cluster: cluster01
    pod: pod01
    storage_url: rbd://admin:[email protected]/poolname
    provider: DefaultPrimary
    scope: cluster
    allocation_state: disabled

- name: ensure a cluster scoped storage_pool is in maintenance
  ngine_io.cloudstack.cs_storage_pool:
    name: Ceph RBD
    zone: zone01
    cluster: cluster01
    pod: pod01
    storage_url: rbd://admin:[email protected]/poolname
    provider: DefaultPrimary
    scope: cluster
    allocation_state: maintenance

- name: ensure a storage_pool is absent
  ngine_io.cloudstack.cs_storage_pool:
    name: Ceph RBD
    zone: zone01
    state: absent

返回值

常见的返回值已在这里文档中说明，以下是此模块特有的字段

键	描述
allocation_state 字符串	存储池的状态。 返回: 成功 示例: "enabled"
capacity_iops 整数	CloudStack 可以从此存储池提供的 IOPS 返回: 当可用时 示例: 60000
cluster 字符串	集群的名称。 返回: 当范围是集群时 示例: "Cluster01"
创建时间 字符串	池的创建日期。 返回: 成功 示例: "2014-12-01T14:57:57+0100"
disk_size_allocated 整数	池当前已分配的磁盘空间。 返回: 成功 示例: 2443517624320
disk_size_total 整数	池的总大小。 返回: 成功 示例: 3915055693824
disk_size_used 整数	池当前已使用的磁盘大小。 返回: 成功 示例: 1040862622180
hypervisor 字符串	与此存储池相关的虚拟机管理程序。 返回: 当可用时 示例: "KVM"
id 字符串	池的 UUID。 返回: 成功 示例: "a3fca65a-7db1-4891-b97c-48806a978a96"
overprovision_factor 字符串	存储池的超额配置因子。 返回: 成功 示例: "2.0"
path 字符串	storage_url 中使用的存储池路径。 返回: 成功 示例: "poolname"
pod 字符串	Pod 的名称。 返回: 当范围是集群时 示例: "Cluster01"
scope 字符串	存储池的范围。 返回: 成功 示例: "cluster"
state 字符串	API 返回的存储池状态。 返回: 成功 示例: "Up"
storage_capabilities 字典	存储池的功能。 返回: 成功 示例: {"VOLUME_SNAPSHOT_QUIESCEVM": "false"}
storage_tags 列表 / elements=string	存储池的标签。 返回: 成功 示例: ["perf", "ssd"]
suitable_for_migration 布尔值	存储池是否适合迁移卷。 返回: 成功 示例: false
zone 字符串	区域的名称。 返回: 成功 示例: "Zone01"

作者

• Netservers Ltd. (@netservers)

• René Moser (@resmo)

集合链接

• 问题跟踪器
• 存储库 (源代码)