community.general.digital_ocean_floating_ip_facts (0.1.4) — module

DigitalOcean Floating IPs information

Authors: Patrick Marques (@pmarques)

Install collection

Install with ansible-galaxy collection install community.general:==0.1.4


Add to requirements.yml

  collections:
    - name: community.general
      version: 0.1.4

Description

This module can be used to fetch DigitalOcean Floating IPs information.

This module was called C(digital_ocean_floating_ip_facts) before Ansible 2.9. The usage did not change.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "Gather information about all Floating IPs"
  digital_ocean_floating_ip_info:
  register: result
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "List of current floating ips"
  debug: var=result.floating_ips

Inputs

    
timeout:
    default: 30
    description:
    - The timeout in seconds used for polling DigitalOcean's API.
    type: int

oauth_token:
    aliases:
    - api_token
    description:
    - DigitalOcean OAuth token.
    - There are several other environment variables which can be used to provide this
      value.
    - i.e., - 'DO_API_TOKEN', 'DO_API_KEY', 'DO_OAUTH_TOKEN' and 'OAUTH_TOKEN'
    type: str

validate_certs:
    default: true
    description:
    - If set to C(no), the SSL certificates will not be validated.
    - This should only set to C(no) used on personally controlled sites using self-signed
      certificates.
    type: bool

Outputs

floating_ips:
  description: a DigitalOcean Floating IP resource
  returned: success and no resource constraint
  sample:
  - 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
  type: list