New in version 2.3.
Parameter | Choices/Defaults | Comments |
---|---|---|
description | Additional description of the network domain. | |
location required | The target datacenter. | |
mcp_password | 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 | The username used to authenticate to the CloudControl API. If not specified, will fall back to MCP_USER from environment variable or ~/.dimensiondata . | |
name required | The name of the network domain to create. | |
region |
na | The target region. |
service_plan |
| The service plan, either "ESSENTIALS" or "ADVANCED". MCP 2.0 Only. |
state |
| Should the resource be present or absent. |
validate_certs | Default: yes | 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 | Default: no | Should we wait for the task to complete before moving onto the next. |
wait_poll_interval | Default: 2 | The amount of time (in seconds) to wait between checks for task completion. Only applicable if wait=true. |
wait_time | Default: 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, the following are the fields unique to this module:
Key | Returned | Description | |
---|---|---|---|
network complex | On success when state=present. | Dictionary describing the network. | |
status string | Network status. (MCP 2.0 only) Sample: NORMAL | ||
multicast boolean | Multicast enabled? (MCP 1.0 only) | ||
description string | Network description. Sample: My network description | ||
private_net string | Private network subnet. (MCP 1.0 only) Sample: 10.2.3.0 | ||
name string | Network name. Sample: My network | ||
id string | Network ID. Sample: 8c787000-a000-4050-a215-280893411a7d | ||
location string | Datacenter location. Sample: NA3 |
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
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.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/dimensiondata_network_module.html