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 基地址。

默认值： "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)