community.general.digital_ocean_size_facts (0.1.4) — module

Gather information about DigitalOcean Droplet sizes

Authors: Abhijeet Kasurde (@Akasurde)

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 gather information about droplet sizes.

This module was called C(digital_ocean_size_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 droplet sizes
  digital_ocean_size_info:
    oauth_token: "{{ oauth_token }}"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Get droplet Size Slug where vcpus is 1
  digital_ocean_size_info:
    oauth_token: "{{ oauth_token }}"
  register: resp_out
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- debug: var=resp_out
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- set_fact:
    size_slug: "{{ item.slug }}"
  loop: "{{ resp_out.data|json_query(name) }}"
  vars:
    name: "[?vcpus==`1`]"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- debug: var=size_slug

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

data:
  description: DigitalOcean droplet size information
  returned: success
  sample:
  - available: true
    disk: 20
    memory: 512
    price_hourly: 0.00744
    price_monthly: 5.0
    regions:
    - ams2
    - ams3
    - blr1
    - fra1
    - lon1
    - nyc1
    - nyc2
    - nyc3
    - sfo1
    - sfo2
    - sgp1
    - tor1
    slug: 512mb
    transfer: 1.0
    vcpus: 1
  type: list