# Datacenter ## datacenter This is a simple module that supports creating or removing datacenters. A datacenter is required before you can create servers. This module has a dependency on ionoscloud >= 6.0.2 ### Example Syntax ```yaml name: Create datacenter ionoscloudsdk.ionoscloud.datacenter: name: 'AnsibleAutoTestCompute' description: 'Ansible Compute test description' location: 'gb/lhr' wait: true register: datacenter_response name: Update datacenter no change 1 ionoscloudsdk.ionoscloud.datacenter: datacenter: 'AnsibleAutoTestCompute' name: 'AnsibleAutoTestCompute' description: 'Ansible Compute test description CHANGED' state: update allow_replace: false register: datacenter_response_no_change2 name: Remove datacenter ionoscloudsdk.ionoscloud.datacenter: datacenter: '' name: 'AnsibleAutoTestCompute' state: absent wait: true register: deleted_datacenter ``` ### Returned object ```json { "changed": false, "failed": false, "action": "create", "datacenter": { "entities": { "lans": { "links": null, "href": "https://api.ionos.com/cloudapi/v6/datacenters/9683f0c0-e311-4194-bddc-a99bb2babf82/lans", "id": "9683f0c0-e311-4194-bddc-a99bb2babf82/lans", "items": null, "limit": null, "offset": null, "type": "collection" }, "loadbalancers": { "links": null, "href": "https://api.ionos.com/cloudapi/v6/datacenters/9683f0c0-e311-4194-bddc-a99bb2babf82/loadbalancers", "id": "9683f0c0-e311-4194-bddc-a99bb2babf82/loadbalancers", "items": null, "limit": null, "offset": null, "type": "collection" }, "natgateways": { "links": null, "href": "https://api.ionos.com/cloudapi/v6/datacenters/9683f0c0-e311-4194-bddc-a99bb2babf82/natgateways", "id": "9683f0c0-e311-4194-bddc-a99bb2babf82/natgateways", "items": null, "limit": null, "offset": null, "type": "collection" }, "networkloadbalancers": { "links": null, "href": "https://api.ionos.com/cloudapi/v6/datacenters/9683f0c0-e311-4194-bddc-a99bb2babf82/networkloadbalancers", "id": "9683f0c0-e311-4194-bddc-a99bb2babf82/networkloadbalancers", "items": null, "limit": null, "offset": null, "type": "collection" }, "servers": { "links": null, "href": "https://api.ionos.com/cloudapi/v6/datacenters/9683f0c0-e311-4194-bddc-a99bb2babf82/servers", "id": "9683f0c0-e311-4194-bddc-a99bb2babf82/servers", "items": null, "limit": null, "offset": null, "type": "collection" }, "volumes": { "links": null, "href": "https://api.ionos.com/cloudapi/v6/datacenters/9683f0c0-e311-4194-bddc-a99bb2babf82/volumes", "id": "9683f0c0-e311-4194-bddc-a99bb2babf82/volumes", "items": null, "limit": null, "offset": null, "type": "collection" } }, "href": "https://api.ionos.com/cloudapi/v6/datacenters/9683f0c0-e311-4194-bddc-a99bb2babf82", "id": "9683f0c0-e311-4194-bddc-a99bb2babf82", "metadata": { "created_by": "", "created_by_user_id": "", "created_date": "2023-05-30T11:24:38+00:00", "etag": "f157640f8bc27aba358aed5cfbd74bf2", "last_modified_by": "", "last_modified_by_user_id": "", "last_modified_date": "2023-05-30T11:24:38+00:00", "state": "AVAILABLE" }, "properties": { "cpu_architecture": [ { "cpu_family": "INTEL_SKYLAKE", "max_cores": 4, "max_ram": 20480, "vendor": "GenuineIntel" } ], "description": "Ansible Compute test description", "features": [ "cloud-init-private-image", "vm-autoscaling", "ssd", "vnf-nat", "k8s", "ssd-storage-zoning", "nic-hot-plug", "vnf-lb", "monitoring", "nic-hot-unplug", "pcc", "contract-identities", "disk-vio-hot-unplug", "disk-vio-hot-plug", "cloud-init", "flow-logs", "cpu-hot-plug", "core-vps", "k8s-cidr-s3-support", "private-loadbalancer", "mem-hot-plug", "vnf-alb" ], "location": "gb/lhr", "name": "AnsibleAutoTestCompute", "sec_auth_protection": false, "version": 2 }, "type": "datacenter" } } ``` #### For more examples please check out the tests [here](https://github.com/ionos-cloud/module-ansible/tree/master/tests/compute-engine). ***NOTE:*** **If you are using a versions 7.0.0 and up**: modules can replace resources if certain set parameters differ from the results found in the API! ### Parameters that can trigger a resource replacement: * location ## state: **present** ```yaml name: Create datacenter ionoscloudsdk.ionoscloud.datacenter: name: 'AnsibleAutoTestCompute' description: 'Ansible Compute test description' location: 'gb/lhr' wait: true register: datacenter_response ``` #### Available parameters for state **present**:
NameRequiredDescription
name
str		TrueThe name of the resource.
description
str		FalseA description for the datacenter, such as staging, production.
location
str		TrueThe physical location where the datacenter will be created. This will be where all of your servers live. Property cannot be modified after datacenter creation (disallowed in update requests).
Options: ['us/las', 'us/ewr', 'de/fra', 'de/fkb', 'de/txl', 'gb/lhr', 'es/vit', 'fr/par', 'us/mci']
allow_replace
bool		FalseBoolean indicating if the resource should be recreated when the state cannot be reached in another way. This may be used to prevent resources from being deleted from specifying a different value to an immutable property. An error will be thrown instead
Default: False
api_url
str		FalseThe Ionos API base URL.
certificate_fingerprint
str		FalseThe Ionos API certificate fingerprint.
username
str		FalseThe Ionos username. Overrides the IONOS_USERNAME environment variable.
password
str		FalseThe Ionos password. Overrides the IONOS_PASSWORD environment variable.
token
str		FalseThe Ionos token. Overrides the IONOS_TOKEN environment variable.
wait
bool		FalseWait for the resource to be created before returning.
Default: True
Options: [True, False]
wait_timeout
int		FalseHow long before wait gives up, in seconds.
Default: 600
state
str		FalseIndicate desired state of the resource.
Default: present
Options: ['present', 'absent', 'update']
## state: **absent** ```yaml name: Remove datacenter ionoscloudsdk.ionoscloud.datacenter: datacenter: '' name: 'AnsibleAutoTestCompute' state: absent wait: true register: deleted_datacenter ``` #### Available parameters for state **absent**:
NameRequiredDescription
datacenter
str		TrueThe ID or name of the virtual datacenter.
api_url
str		FalseThe Ionos API base URL.
certificate_fingerprint
str		FalseThe Ionos API certificate fingerprint.
username
str		FalseThe Ionos username. Overrides the IONOS_USERNAME environment variable.
password
str		FalseThe Ionos password. Overrides the IONOS_PASSWORD environment variable.
token
str		FalseThe Ionos token. Overrides the IONOS_TOKEN environment variable.
wait
bool		FalseWait for the resource to be created before returning.
Default: True
Options: [True, False]
wait_timeout
int		FalseHow long before wait gives up, in seconds.
Default: 600
state
str		FalseIndicate desired state of the resource.
Default: present
Options: ['present', 'absent', 'update']
## state: **update** ```yaml name: Update datacenter no change 1 ionoscloudsdk.ionoscloud.datacenter: datacenter: 'AnsibleAutoTestCompute' name: 'AnsibleAutoTestCompute' description: 'Ansible Compute test description CHANGED' state: update allow_replace: false register: datacenter_response_no_change2 ``` #### Available parameters for state **update**:
NameRequiredDescription
name
str		FalseThe name of the resource.
description
str		FalseA description for the datacenter, such as staging, production.
location
str		FalseThe physical location where the datacenter will be created. This will be where all of your servers live. Property cannot be modified after datacenter creation (disallowed in update requests).
Options: ['us/las', 'us/ewr', 'de/fra', 'de/fkb', 'de/txl', 'gb/lhr', 'es/vit', 'fr/par', 'us/mci']
datacenter
str		TrueThe ID or name of the virtual datacenter.
allow_replace
bool		FalseBoolean indicating if the resource should be recreated when the state cannot be reached in another way. This may be used to prevent resources from being deleted from specifying a different value to an immutable property. An error will be thrown instead
Default: False
api_url
str		FalseThe Ionos API base URL.
certificate_fingerprint
str		FalseThe Ionos API certificate fingerprint.
username
str		FalseThe Ionos username. Overrides the IONOS_USERNAME environment variable.
password
str		FalseThe Ionos password. Overrides the IONOS_PASSWORD environment variable.
token
str		FalseThe Ionos token. Overrides the IONOS_TOKEN environment variable.
wait
bool		FalseWait for the resource to be created before returning.
Default: True
Options: [True, False]
wait_timeout
int		FalseHow long before wait gives up, in seconds.
Default: 600
state
str		FalseIndicate desired state of the resource.
Default: present
Options: ['present', 'absent', 'update']
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ionos.com/ansible/api/compute-engine/modules/datacenter.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.