ngine_io.cloudstack.cs_volume 模块 – 管理基于 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_volume。

ngine_io.cloudstack 0.1.0 中的新增功能

概要

  • 创建、销毁、附加、分离、提取或上传卷。

要求

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

  • python >= 2.6

  • cs >= 0.9.0

参数

参数

注释

account

字符串

卷所属的帐户。

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 环境变量。

custom_id

字符串

资源的自定义 ID。

仅允许 Root 管理员。

device_id

整数

卷附加到的 VM 上的设备 ID。

仅当 state 为 attached 时才考虑。

disk_offering

字符串

要使用的磁盘产品名称。

如果卷不是 state=present，则需要 disk_offering 或 snapshot 其中之一。

display_volume

布尔值

是否向最终用户显示卷。

仅允许 Root 管理员。

选项

  • false

  • true

domain

字符串

要部署卷的域的名称。

force

布尔值

强制删除卷，即使它已附加到 VM。

仅在 state=absent 时考虑。

选项

  • false ← (默认)

  • true

format

字符串

卷的格式。

仅当 state=uploaded 时才考虑。

选项

  • "QCOW2"

  • "RAW"

  • "VHD"

  • "VHDX"

  • "OVA"

max_iops

整数

最大 iops

min_iops

整数

最小 iops

mode

字符串

卷提取的模式。

仅当 state=extracted 时才考虑。

选项

  • "http_download" ← (默认)

  • "ftp_upload"

name

字符串 / 必需

卷的名称。

name 只能包含 ASCII 字母。

poll_async

布尔值

轮询异步作业，直到作业完成。

选项

  • false

  • true ← (默认)

project

字符串

要部署卷的项目名称。

shrink_ok

布尔值

是否允许缩小卷。

选项

  • false ← (默认)

  • true

size

整数

磁盘大小（以 GB 为单位）

snapshot

字符串

磁盘卷的快照名称。

如果卷不是 state=present，则需要 disk_offering 或 snapshot 其中之一。

state

字符串

卷的状态。

选项

  • "present" ← (默认)

  • "absent"

  • "attached"

  • "detached"

  • "extracted"

  • "uploaded"

tags

别名: tag

列表 / 元素=字典

标记列表。标记是具有键 key 和 value 的字典列表。

要删除所有标签，请设置一个空列表，例如 tags: []。

url

字符串

当 state=extracted 时，卷将被提取到的 URL

或者当 state=uploaded 时，从哪里下载卷的 URL。

仅当 state 为 extracted 或 uploaded 时才考虑。

validate_certs

布尔值

在 ngine_io.cloudstack 2.4.0 中添加

如果 false，则不会验证 SSL 证书。

如果未给出，则会考虑 CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY 环境变量。

这应该只在个人控制的使用自签名证书的站点上使用。

选项

  • false

  • true ← (默认)

vm

字符串

要将卷附加到的虚拟机的名称。

zone

字符串 / 必需

卷应部署在其中的区域的名称。

注释

注意

  • 有关 cloudstack 模块的详细指南可以在CloudStack 云指南中找到。

  • 此模块支持检查模式。

示例

- name: create volume within project and zone with specified storage options
  ngine_io.cloudstack.cs_volume:
    name: web-vm-1-volume
    project: Integration
    zone: ch-zrh-ix-01
    disk_offering: PerfPlus Storage
    size: 20

- name: create/attach volume to instance
  ngine_io.cloudstack.cs_volume:
    name: web-vm-1-volume
    zone: zone01
    disk_offering: PerfPlus Storage
    size: 20
    vm: web-vm-1
    state: attached

- name: detach volume
  ngine_io.cloudstack.cs_volume:
    name: web-vm-1-volume
    zone: zone01
    state: detached

- name: remove volume
  ngine_io.cloudstack.cs_volume:
    name: web-vm-1-volume
    zone: zone01
    state: absent

- name: Extract DATA volume to make it downloadable
  ngine_io.cloudstack.cs_volume:
    state: extracted
    name: web-vm-1-volume
    zone: zone01
  register: data_vol_out

- name: Create new volume by downloading source volume
  ngine_io.cloudstack.cs_volume:
    state: uploaded
    name: web-vm-1-volume-2
    zone: zone01
    format: VHD
    url: "{{ data_vol_out.url }}"

返回值

通用返回值记录在此处，以下是此模块独有的字段

键

描述

attached

字符串

卷附加的日期。

返回: 成功

示例: "2014-12-01T14:57:57+0100"

created

字符串

卷创建的日期。

返回: 成功

示例: "2014-12-01T14:57:57+0100"

device_id

整数

卷所附加到的用户虚拟机上的设备 ID (分离时不会返回)

返回: 成功

示例: 1

display_name

字符串

卷的显示名称。

返回: 成功

示例: "web-volume-01"

domain

字符串

卷所属的域

返回: 成功

示例: "示例域"

group

字符串

卷所属的组

返回: 成功

示例: "web"

id

字符串

卷的 ID。

返回: 成功

name

字符串

卷的名称。

返回: 成功

示例: "web-volume-01"

project

字符串

卷所属的项目

返回: 成功

示例: "Production"

size

整数

磁盘卷的大小。

返回: 成功

示例: 20

state

字符串

卷的状态

返回: 成功

示例: "已附加"

type

字符串

磁盘卷类型。

返回: 成功

示例: "DATADISK"

url

字符串

上传的卷的 URL 或根据提取模式的下载 URL。

返回: 当 state=extracted 时成功

示例: "http://1.12.3.4/userdata/387e2c7c-7c42-4ecc-b4ed-84e8367a1965.vhd"

vm

字符串

卷附加到的虚拟机的名称 (分离时不会返回)

返回: 成功

示例: "web-01"

zone

字符串

卷所在的区域的名称。

返回: 成功

示例: "ch-gva-2"

作者

  • Jefferson Girão (@jeffersongirao)

  • René Moser (@resmo)