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 列表 / 元素=字符串	与此存储池关联的标签。
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 列表 / 元素=字符串	存储池的标签。 返回: 成功 示例: ["perf", "ssd"]
suitable_for_migration 布尔值	存储池是否适合迁移卷。 返回: 成功 示例: false
zone 字符串	区域的名称。 返回: 成功 示例: "Zone01"

作者

• Netservers Ltd. (@netservers)

• René Moser (@resmo)

集合链接

• 问题跟踪器
• 仓库（源）