stephrobert.scaleway.lb_ip_info module – Gather information about Scaleway Load Balancer IPs

Note

This module is part of the stephrobert.scaleway collection (version 0.7.0).

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 stephrobert.scaleway. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: stephrobert.scaleway.lb_ip_info.

New in stephrobert.scaleway 0.1.0

Synopsis

  • Retrieve the full details of a Load Balancer flexible IP address.

  • List the Load Balancer flexible IP addresses held in the account (filtered by Organization ID or Project ID). It is also possible to search for a specific IP address.

Requirements

The below requirements are needed on the host that executes this module.

  • scaleway >= 2.9.0

Parameters

Parameter

Comments

access_key

string

Scaleway API access key.

api_allow_insecure

boolean

Allow the API endpoint to be reached without verifying its TLS certificate.

Falls back to the Scaleway configuration file, then to false.

Choices:

  • false

  • true

api_timeout

integer

Seconds allowed for a single API call, connection and read.

Without a limit a silent connection would hang the module forever: the Scaleway SDK issues its requests with no timeout at all.

This bounds a single call, not a whole wait. Modules that can wait for a state bound the overall wait separately.

Default: 60

api_url

string

URL of the Scaleway API endpoint.

Point it at a local emulator to exercise a playbook without credentials.

Falls back to the Scaleway configuration file, then to https://api.scaleway.com. It carries no module default on purpose: a default is never unset, so it would always override the profile.

config_file

path

Path to the Scaleway configuration file.

ip_address

string

IP address to filter for.

ip_id

string

IP address ID.

ip_type

string

IP type to filter for.

Choices:

  • "all"

  • "ipv4"

  • "ipv6"

organization_id

string

Default Organization ID used when an operation does not name one.

profile

string

Name of the profile to read in the Scaleway configuration file.

project_id

string

Default Project ID used when an operation does not name one.

secret_key

string

Scaleway API secret key.

tags

list / elements=string

Tag to filter for, only IPs with one or more matching tags will be returned.

user_agent

string

Value of the User-Agent header sent to the API.

zone

string / required

The zone you want to target

Choices:

  • "fr-par-1"

  • "fr-par-2"

  • "nl-ams-1"

  • "nl-ams-2"

  • "nl-ams-3"

  • "pl-waw-1"

  • "pl-waw-2"

  • "pl-waw-3"

Attributes

Attribute

Support

Description

check_mode

Support: full

This module only reads, so check mode changes nothing about how it runs.

diff_mode

Support: none

This module changes nothing, so it has no difference to report.

Notes

Note

  • Every option can be set from its environment variable, respectively SCW_PROFILE, SCW_CONFIG_PATH, SCW_ACCESS_KEY, SCW_SECRET_KEY, SCW_API_URL, SCW_DEFAULT_ORGANIZATION_ID and SCW_DEFAULT_PROJECT_ID.

  • Module options take precedence over environment variables, which take precedence over the configuration file.

Examples

# This module only reads: it never changes anything, and check mode
# is native.
#
# `ip_id` decides which of the two reads runs: given, the
# module returns that one resource; omitted, it lists them all,
# walking every page rather than returning the first one in silence.

- name: Get an IP address
  stephrobert.scaleway.lb_ip_info:
    zone: fr-par-1
    ip_id: 11111111-2222-3333-4444-555555555555
  register: result
- name: List IP addresses
  stephrobert.scaleway.lb_ip_info:
    zone: fr-par-1
  register: result
- name: Filter Scaleway Load Balancer IPs by tags
  stephrobert.scaleway.lb_ip_info:
    zone: fr-par-1
    tags:
    - production
  register: result

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

ips

list / elements=dictionary

List the Load Balancer flexible IP addresses held in the account (filtered by Organization ID or Project ID). It is also possible to search for a specific IP address.

Returned: when ip_id is omitted

id

string

IP address ID.

Returned: when the API returns it

ip_address

string

IP address.

Returned: when the API returns it

lb_id

string

Load Balancer ID.

Returned: when the API returns it

organization_id

string

Organization ID of the Scaleway Organization the IP address is in.

Returned: when the API returns it

project_id

string

Project ID of the Scaleway Project the IP address is in.

Returned: when the API returns it

region

string

The region the IP address is in.

Deprecated by the Scaleway API contract.

Returned: when the API returns it

reverse

string

Reverse DNS (domain name) of the IP address.

Returned: when the API returns it

tags

list / elements=string

IP tags.

Returned: when the API returns it

zone

string

The zone the IP address is in.

Returned: when the API returns it

result

dictionary

added in stephrobert.scaleway 0.4.0

Retrieve the full details of a Load Balancer flexible IP address.

The API contract names no payload field for this operation: the response body is returned as is.

Returned: when ip_id is provided

id

string

IP address ID.

Returned: when the API returns it

ip_address

string

IP address.

Returned: when the API returns it

lb_id

string

Load Balancer ID.

Returned: when the API returns it

organization_id

string

Organization ID of the Scaleway Organization the IP address is in.

Returned: when the API returns it

project_id

string

Project ID of the Scaleway Project the IP address is in.

Returned: when the API returns it

region

string

The region the IP address is in.

Deprecated by the Scaleway API contract.

Returned: when the API returns it

reverse

string

Reverse DNS (domain name) of the IP address.

Returned: when the API returns it

tags

list / elements=string

IP tags.

Returned: when the API returns it

zone

string

The zone the IP address is in.

Returned: when the API returns it

Authors

  • Stéphane Robert (@stephrobert)