community.digitalocean.digital_ocean_image_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_image_info
。
概要
此模块可用于收集有关 DigitalOcean 提供的镜像的信息。
这些镜像可以是
distribution
、application
和private
类型。在 Ansible 2.9 之前,此模块称为
digital_ocean_image_facts
。用法没有改变。
别名:digital_ocean_image_facts
要求
执行此模块的主机需要以下要求。
python >= 2.6
参数
参数 |
注释 |
---|---|
DigitalOcean API 的基本 URL。 默认值: |
|
指定要检索的镜像信息的类型。 如果设置为 如果设置为 如果设置为 如果未设置为以上任何一项,则会收集与所有镜像相关的信息。 选项
|
|
DigitalOcean OAuth 令牌。 可以使用其他几个环境变量来提供此值。 例如,- |
|
用于轮询 DigitalOcean API 的超时时间(秒)。 默认值: |
|
如果设置为 只有在使用自签名证书的个人控制站点上才应将其设置为 选项
|
示例
- name: Gather information about all images
community.digitalocean.digital_ocean_image_info:
image_type: all
oauth_token: "{{ oauth_token }}"
- name: Gather information about application images
community.digitalocean.digital_ocean_image_info:
image_type: application
oauth_token: "{{ oauth_token }}"
- name: Gather information about distribution images
community.digitalocean.digital_ocean_image_info:
image_type: distribution
oauth_token: "{{ oauth_token }}"
- name: Get distribution about image with slug coreos-beta
community.digitalocean.digital_ocean_image_info:
register: resp_out
- set_fact:
distribution_name: "{{ item.distribution }}"
loop: "{{ resp_out.data | community.general.json_query(name) }}"
vars:
name: "[?slug=='coreos-beta']"
- debug:
var: distribution_name
返回值
常见的返回值已在 此处 记录,以下是此模块特有的字段
键 |
描述 |
---|---|
DigitalOcean 镜像信息 返回:成功 示例: |