New in version 2.3.
parameter | required | default | choices | comments |
---|---|---|---|---|
description |
no | Additional description of the network domain. | ||
location |
yes | The target datacenter. | ||
mcp_password |
no | The password used to authenticate to the CloudControl API. If not specified, will fall back to MCP_PASSWORD from environment variable or ~/.dimensiondata .Required if mcp_user is specified. | ||
mcp_user |
no | The username used to authenticate to the CloudControl API. If not specified, will fall back to MCP_USER from environment variable or ~/.dimensiondata . | ||
name |
yes | The name of the network domain to create. | ||
region |
no | na |
|
The target region. |
service_plan |
no | ESSENTIALS |
|
The service plan, either “ESSENTIALS” or “ADVANCED”. MCP 2.0 Only. |
state |
no | present |
|
Should the resource be present or absent. |
validate_certs |
no | True | If false , SSL certificates will not be validated.This should only be used on private instances of the CloudControl API that use self-signed certificates. | |
wait |
no | Should we wait for the task to complete before moving onto the next. | ||
wait_poll_interval |
no | 2 | The amount of time (in seconds) to wait between checks for task completion. Only applicable if wait=true. | |
wait_time |
no | 600 | The maximum amount of time (in seconds) to wait for the task to complete. Only applicable if wait=true. |
# Create an MCP 1.0 network - dimensiondata_network: region: na location: NA5 name: mynet # Create an MCP 2.0 network - dimensiondata_network: region: na mcp_user: my_user mcp_password: my_password location: NA9 name: mynet service_plan: ADVANCED # Delete a network - dimensiondata_network: region: na location: NA1 name: mynet state: absent
Common return values are documented here Return Values, the following are the fields unique to this module:
name | description | returned | type | sample | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
network | Dictionary describing the network. | On success when I(state=present). | dictionary | |||||||||||||||||||||||||||||||||||||||||
contains: |
|
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.