community.digitalocean.digital_ocean_snapshot_info 模块 – 收集关于 DigitalOcean 快照的信息
注意
此模块是 community.digitalocean 集合 (版本 1.27.0) 的一部分。
如果您使用的是 ansible 包,您可能已经安装了这个集合。 它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list。
要安装它,请使用:ansible-galaxy collection install community.digitalocean。您需要其他要求才能使用此模块,请参阅要求了解详细信息。
要在 playbook 中使用它,请指定:community.digitalocean.digital_ocean_snapshot_info。
概要
- 此模块可用于根据提供的诸如 droplet、卷和快照 ID 之类的值来收集有关快照信息的信息。 
- 在 Ansible 2.9 之前,此模块被称为 - digital_ocean_snapshot_facts。用法没有改变。
别名:digital_ocean_snapshot_facts
要求
在执行此模块的主机上需要以下要求。
- python >= 2.6 
参数
| 参数 | 注释 | 
|---|---|
| DigitalOcean API 基本 URL。 默认值:  | |
| DigitalOcean OAuth 令牌。 还有其他几个环境变量可用于提供此值。 例如,- | |
| 要检索有关快照的信息,请将其指定为快照 ID。 如果设置为实际快照 ID,则仅收集与该特定快照相关的信息。 如果  | |
| 指定要检索的快照信息的类型。 如果设置为  如果设置为  如果设置为  如果未设置为以上任何一项,则收集与所有快照相关的信息。 选项 
 | |
| 轮询 DigitalOcean API 的超时时间(以秒为单位)。 默认值:  | |
| 如果设置为  这应该只在个人控制的使用自签名证书的站点上设置为  选项 
 | 
示例
- name: Gather information about all snapshots
  community.digitalocean.digital_ocean_snapshot_info:
    snapshot_type: all
    oauth_token: "{{ oauth_token }}"
- name: Gather information about droplet snapshots
  community.digitalocean.digital_ocean_snapshot_info:
    snapshot_type: droplet
    oauth_token: "{{ oauth_token }}"
- name: Gather information about volume snapshots
  community.digitalocean.digital_ocean_snapshot_info:
    snapshot_type: volume
    oauth_token: "{{ oauth_token }}"
- name: Gather information about snapshot by snapshot id
  community.digitalocean.digital_ocean_snapshot_info:
    snapshot_type: by_id
    snapshot_id: 123123123
    oauth_token: "{{ oauth_token }}"
- name: Get information about snapshot named big-data-snapshot1
  community.digitalocean.digital_ocean_snapshot_info:
  register: resp_out
- set_fact:
    snapshot_id: "{{ item.id }}"
  loop: "{{ resp_out.data | community.general.json_query(name) }}"
  vars:
    name: "[?name=='big-data-snapshot1']"
- debug:
    var: snapshot_id
返回值
常见的返回值记录在此处,以下是此模块特有的字段
| 键 | 描述 | 
|---|---|
| DigitalOcean 快照信息 返回:成功 示例:  | 
