Documentation

profitbricks_datacenter - Create or destroy a ProfitBricks Virtual Datacenter.

New in version 2.0.

Synopsis

  • This is a simple module that supports creating or removing vDCs. A vDC is required before you can create servers. This module has a dependency on profitbricks >= 1.0.0

Requirements

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

  • profitbricks

Parameters

Parameter Choices/Defaults Comments
description
The description of the virtual datacenter.
location
    Choices:
  • us/las ←
  • de/fra
  • de/fkb
The datacenter location.
name
required
The name of the virtual datacenter.
state
    Choices:
  • present ←
  • absent
create or terminate datacenters
subscription_password
THe ProfitBricks password. Overrides the PB_PASSWORD environment variable.
subscription_user
The ProfitBricks username. Overrides the PB_SUBSCRIPTION_ID environment variable.
wait
bool
    Choices:
  • no
  • yes ←
wait for the datacenter to be created before returning
wait_timeout Default:
600
how long before wait gives up, in seconds

Examples

# Create a Datacenter
- profitbricks_datacenter:
    datacenter: Tardis One
    wait_timeout: 500

# Destroy a Datacenter. This will remove all servers, volumes, and other objects in the datacenter.
- profitbricks_datacenter:
    datacenter: Tardis One
    wait_timeout: 500
    state: absent

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

Hint

If you notice any issues in this documentation you can edit this document to improve it.