ngine_io.cloudstack.cs_vmsnapshot 模块 – 管理基于 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_vmsnapshot
。
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 术语中,显示名称。 |
|
轮询异步作业,直到作业完成。 选择
|
|
虚拟机分配到的项目名称。 |
|
如果设置为 true,则快照内存。 选择
|
|
快照的状态。 选择
|
|
标签列表。标签是具有键 key 和 value 的字典列表。 要删除所有标签,请设置一个空列表,例如 tags: []。 |
|
如果 如果未给出,则考虑 这只应在个人控制的站点上使用自签名证书。 选择
|
|
虚拟机的名称。 |
|
虚拟机所在的区域的名称。如果未设置。 |
备注
注意
有关 cloudstack 模块的详细指南可以在 CloudStack 云指南 中找到。
此模块支持检查模式。
示例
- name: Create a VM snapshot of disk and memory before an upgrade
ngine_io.cloudstack.cs_vmsnapshot:
name: Snapshot before upgrade
vm: web-01
zone: zone01
snapshot_memory: yes
- name: Revert a VM to a snapshot after a failed upgrade
ngine_io.cloudstack.cs_vmsnapshot:
name: Snapshot before upgrade
vm: web-01
zone: zone01
state: revert
- name: Remove a VM snapshot after successful upgrade
ngine_io.cloudstack.cs_vmsnapshot:
name: Snapshot before upgrade
vm: web-01
zone: zone01
state: absent
返回值
常见的返回值记录在此处,以下是此模块独有的字段
键 |
描述 |
---|---|
虚拟机快照相关的帐户。 返回:成功 示例: |
|
快照的日期。 返回:成功 示例: |
|
如果快照是当前快照,则为 true 返回:成功 示例: |
|
虚拟机快照的描述 返回:成功 示例: |
|
快照的显示名称。 返回:成功 示例: |
|
虚拟机快照相关的域。 返回:成功 示例: |
|
快照的UUID。 返回:成功 示例: |
|
快照的名称。 返回:成功 示例: |
|
虚拟机快照相关的项目名称。 返回:成功 示例: |
|
虚拟机快照的状态 返回:成功 示例: |
|
虚拟机快照的类型 返回:成功 示例: |