community.general.scaleway_database_backup module – Scaleway database backups management module

Note

This module is part of the community.general collection (version 9.4.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 community.general.

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

New in community.general 1.2.0

Synopsis

Parameters

Parameter

Comments

api_timeout

aliases: timeout

integer

HTTP timeout to Scaleway API in seconds.

Default: 30

api_token

aliases: oauth_token

string / required

Scaleway OAuth token.

api_url

aliases: base_url

string

Scaleway API URL.

Default: "https://api.scaleway.com"

database_name

string

Name used to identify the database.

Required for present and restored states.

Ignored when state=absent or state=exported.

expires_at

string

Expiration datetime of the database backup (ISO 8601 format).

Ignored when state=absent, state=exported or state=restored.

id

string

UUID used to identify the database backup.

Required for absent, exported and restored states.

instance_id

string

UUID of the instance associated to the database backup.

Required for present and restored states.

Ignored when state=absent or state=exported.

name

string

Name used to identify the database backup.

Required for present state.

Ignored when state=absent, state=exported or state=restored.

query_parameters

dictionary

List of parameters passed to the query string.

Default: {}

region

string / required

Scaleway region to use (for example fr-par).

Choices:

  • "fr-par"

  • "nl-ams"

  • "pl-waw"

state

string

Indicate desired state of the database backup.

present creates a backup.

absent deletes the backup.

exported creates a download link for the backup.

restored restores the backup to a new database.

Choices:

  • "present" ← (default)

  • "absent"

  • "exported"

  • "restored"

validate_certs

boolean

Validate SSL certs of the Scaleway API.

Choices:

  • false

  • true ← (default)

wait

boolean

Wait for the instance to reach its desired state before returning.

Choices:

  • false ← (default)

  • true

wait_sleep_time

integer

Time to wait before every attempt to check the state of the backup.

Default: 3

wait_timeout

integer

Time to wait for the backup to reach the expected state.

Default: 300

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

Examples

- name: Create a backup
  community.general.scaleway_database_backup:
      name: 'my_backup'
      state: present
      region: 'fr-par'
      database_name: 'my-database'
      instance_id: '50968a80-2909-4e5c-b1af-a2e19860dddb'

- name: Export a backup
  community.general.scaleway_database_backup:
      id: '6ef1125a-037e-494f-a911-6d9c49a51691'
      state: exported
      region: 'fr-par'

- name: Restore a backup
  community.general.scaleway_database_backup:
      id: '6ef1125a-037e-494f-a911-6d9c49a51691'
      state: restored
      region: 'fr-par'
      database_name: 'my-new-database'
      instance_id: '50968a80-2909-4e5c-b1af-a2e19860dddb'

- name: Remove a backup
  community.general.scaleway_database_backup:
      id: '6ef1125a-037e-494f-a911-6d9c49a51691'
      state: absent
      region: 'fr-par'

Return Values

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

Key

Description

metadata

dictionary

Backup metadata.

Returned: when state=present, state=exported, or state=restored

Sample: {"metadata": {"created_at": "2020-08-06T12:42:05.631049Z", "database_name": "my-database", "download_url": null, "download_url_expires_at": null, "expires_at": null, "id": "a15297bd-0c4a-4b4f-8fbb-b36a35b7eb07", "instance_id": "617be32e-6497-4ed7-b4c7-0ee5a81edf49", "instance_name": "my-instance", "name": "backup_name", "region": "fr-par", "size": 600000, "status": "ready", "updated_at": "2020-08-06T12:42:10.581649Z"}}

Authors

  • Guillaume Rodriguez (@guillaume_ro_fr)