community.digitalocean.digital_ocean_floating_ip_info 模块 – DigitalOcean 浮动 IP 信息

注意

此模块是 community.digitalocean 集合（版本 1.27.0）的一部分。

如果您正在使用 ansible 包，则可能已安装此集合。 它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.digitalocean。 您需要满足其他要求才能使用此模块，请参阅 要求 以了解详细信息。

要在 Playbook 中使用它，请指定：community.digitalocean.digital_ocean_floating_ip_info。

概要

  • 此模块可用于获取 DigitalOcean 浮动 IP 信息。

  • 在 Ansible 2.9 之前，此模块名为 digital_ocean_floating_ip_facts。 用法没有改变。

别名：digital_ocean_floating_ip_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。

timeout

整数

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

默认值： 30

validate_certs

布尔值

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

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

选项

  • false

  • true ← (默认)

注释

注意

  • 使用 DigitalOcean API 的第 2 版。

示例

- name: "Gather information about all Floating IPs"
  community.digitalocean.digital_ocean_floating_ip_info:
  register: result

- name: "List of current floating ips"
  debug:
    var: result.floating_ips

返回值

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

键

描述

floating_ips

列表 / 元素=字符串

DigitalOcean 浮动 IP 资源

返回：成功并且没有资源约束

示例： [{"droplet": null, "ip": "45.55.96.47", "locked": false, "region": {"available": true, "features": ["private_networking", "backups", "ipv6", "metadata"], "name": "New York 3", "sizes": ["512mb", "1gb", "2gb", "4gb", "8gb", "16gb", "32gb", "48gb", "64gb"], "slug": "nyc3"}}]

作者

  • Patrick Marques (@pmarques)