You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

profitbricks_datacenter - Create or destroy a ProfitBricks Virtual Datacenter.¶

New in version 2.0.

Synopsis
Requirements (on host that executes module)
Options
Examples
- Status

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 (on host that executes module)¶

profitbricks

Options ¶

parameter	required	default	choices	comments
description	no			The description of the virtual datacenter.
location	no	us/las	us/las de/fra de/fkb	The datacenter location.
name	yes			The name of the virtual datacenter.
state	no	present	present absent	create or terminate datacenters
subscription_password	no			THe ProfitBricks password. Overrides the PB_PASSWORD environment variable.
subscription_user	no			The ProfitBricks username. Overrides the PB_SUBSCRIPTION_ID environment variable.
wait	no	yes	yes no	wait for the datacenter to be created before returning
wait_timeout	no	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.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.