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
参数
参数 |
注释 |
---|---|
存储池的分配状态。 选项
|
|
用于查询 API 端点的 HTTP 方法。 如果未给定,则考虑 选项
|
|
CloudStack API 的 API 密钥。 如果未给定,则考虑 |
|
CloudStack API 的密钥。 如果未设置,则考虑 |
|
HTTP 超时(以秒为单位)。 如果未给定,则考虑 默认: |
|
CloudStack API 的 URL,例如 https://cloud.example.com/client/api。 如果未给定,则考虑 |
|
验证 CA 授权证书文件。 如果未给定,则考虑 |
|
CloudStack 可以从此存储池配置的字节数。 |
|
CloudStack 可以从此存储池配置的字节数。 |
|
群集的名称。 |
|
创建区域范围的池时必需。 可能的值为 |
|
存储池是否应由 CloudStack 管理。 仅在创建时考虑。 选项
|
|
存储池的名称。 |
|
Pod 的名称。 |
|
存储提供商的名称,例如 SolidFire、SolidFireShared、DefaultPrimary、CloudByte。 默认: |
|
存储池的范围。 当提供 选项
|
|
存储池的状态。 选项
|
|
与此存储池关联的标签。 |
|
存储池的 URL。 如果 *state=present*,则为必需项。 |
|
如果 如果未给定,则考虑 这应该仅在使用自签名证书的个人控制站点上使用。 选项
|
|
应在其中部署主机的区域的名称。 |
说明
注意
有关 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
返回值
常见的返回值已在这里文档中说明,以下是此模块特有的字段
键 |
描述 |
---|---|
存储池的状态。 返回: 成功 示例: |
|
CloudStack 可以从此存储池提供的 IOPS 返回: 当可用时 示例: |
|
集群的名称。 返回: 当范围是集群时 示例: |
|
池的创建日期。 返回: 成功 示例: |
|
池当前已分配的磁盘空间。 返回: 成功 示例: |
|
池的总大小。 返回: 成功 示例: |
|
池当前已使用的磁盘大小。 返回: 成功 示例: |
|
与此存储池相关的虚拟机管理程序。 返回: 当可用时 示例: |
|
池的 UUID。 返回: 成功 示例: |
|
存储池的超额配置因子。 返回: 成功 示例: |
|
storage_url 中使用的存储池路径。 返回: 成功 示例: |
|
Pod 的名称。 返回: 当范围是集群时 示例: |
|
存储池的范围。 返回: 成功 示例: |
|
API 返回的存储池状态。 返回: 成功 示例: |
|
存储池的功能。 返回: 成功 示例: |
|
存储池的标签。 返回: 成功 示例: |
|
存储池是否适合迁移卷。 返回: 成功 示例: |
|
区域的名称。 返回: 成功 示例: |