community.digitalocean.digital_ocean_region_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_region_info。

概要

  • 此模块可用于收集有关区域的信息。

  • 在 Ansible 2.9 之前，此模块被称为 digital_ocean_region_facts。用法没有改变。

别名：digital_ocean_region_facts

要求

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

  • python >= 2.6

参数

参数

注释

baseurl

字符串

DigitalOcean API 基本 URL。

默认值："https://api.digitalocean.com/v2"

oauth_token

别名：api_token

字符串

DigitalOcean OAuth 令牌。

还有几个其他环境变量可用于提供此值。

例如， - DO_API_TOKEN、DO_API_KEY、DO_OAUTH_TOKEN 和 OAUTH_TOKEN。

超时

整数

用于轮询 DigitalOcean API 的超时时间（以秒为单位）。

默认值： 30

validate_certs

布尔值

如果设置为 no，则不会验证 SSL 证书。

只有在使用自签名证书的个人控制站点上，才应将其设置为 no。

选择

  • false

  • true ← （默认）

示例

- name: Gather information about all regions
  community.digitalocean.digital_ocean_region_info:
    oauth_token: "{{ oauth_token }}"

- name: Get Name of region where slug is known
  community.digitalocean.digital_ocean_region_info:
    oauth_token: "{{ oauth_token }}"
  register: resp_out
- debug: var=resp_out
- set_fact:
    region_slug: "{{ item.name }}"
  loop: "{{ resp_out.data | community.general.json_query(name) }}"
  vars:
    name: "[?slug==`nyc1`]"
- debug:
    var: region_slug

返回值

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

键

描述

数据

列表 / 元素=字符串

DigitalOcean 区域信息

返回： 成功

示例： [{"available": true, "features": ["private_networking", "backups", "ipv6", "metadata", "install_agent", "storage"], "name": "New York 1", "sizes": ["512mb", "s-1vcpu-1gb", "1gb", "s-3vcpu-1gb", "s-1vcpu-2gb", "s-2vcpu-2gb", "2gb", "s-1vcpu-3gb", "s-2vcpu-4gb", "4gb", "c-2", "m-1vcpu-8gb", "8gb", "s-4vcpu-8gb", "s-6vcpu-16gb", "16gb"], "slug": "nyc1"}]

作者

  • Abhijeet Kasurde (@Akasurde)