community.general.online inventory – Scaleway (previously Online SAS or Online.net) inventory source

Note

This inventory plugin is part of the community.general collection (version 10.7.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.online.

Synopsis

  • Get inventory hosts from Scaleway (previously Online SAS or Online.net).

Parameters

Parameter

Comments

groups

list / elements=string

List of groups.

Choices:

  • "location"
  • "offer"
  • "rpn"

hostnames

list / elements=string

List of preference about what to use as an hostname.

Choices:

  • "public_ipv4" ← (default)
  • "private_ipv4"
  • "hostname"

Default: ["public_ipv4"]

oauth_token

string / required

Online OAuth token.

Configuration:

plugin

string / required

token that ensures this is a source file for the ‘online’ plugin.

Choices:

  • "online"
  • "community.general.online"

Note

Configuration entries listed above for each entry type (Ansible variable, environment variable, and so on) have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up. The entry types are also ordered by precedence from low to high priority order. For example, an ansible.cfg entry (further up in the list) is overwritten by an Ansible variable (further down in the list).

Examples

# online_inventory.yml file in YAML format
# Example command line: ansible-inventory --list -i online_inventory.yml

plugin: community.general.online
hostnames:
  - public_ipv4
groups:
  - location
  - offer
  - rpn

Authors

  • Remy Leone (@remyleone)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/online_inventory.html