hwc_network_vpc – Creates a Huawei Cloud VPC
New in version 2.8.
Synopsis
- Represents an vpc resource.
Requirements
The below requirements are needed on the host that executes this module.
- requests >= 2.18.4
- keystoneauth1 >= 3.6.0
Parameters
| Parameter | Choices/Defaults | Comments | |
|---|---|---|---|
| cidr string / required | the range of available subnets in the vpc. | ||
| domain string / required | The name of the Domain to scope to (Identity v3, currently only domain names are supported, and not domain IDs). | ||
| id string | The id of resource to be managed. | ||
| identity_endpoint string / required | The Identity authentication URL. | ||
| name string / required | the name of vpc. | ||
| password string / required | The password to login with. | ||
| project string / required | The name of the Tenant (Identity v2) or Project (Identity v3). (currently only project names are supported, and not project IDs). | ||
| region string / required | The region to which the project belongs. | ||
| state string |
| Whether the given object should exist in vpc. | |
| timeouts dictionary | The timeouts for create/update/delete operation. | ||
| create string | Default: "10m" | The timeouts for create operation. | |
| delete string | The timeouts for delete operation. | ||
| update string | Default: "10m" | The timeouts for update operation. | |
| user string / required | The user name to login with (currently only user names are supported, and not user IDs). | ||
Notes
Note
- For authentication, you can set identity_endpoint using the
ANSIBLE_HWC_IDENTITY_ENDPOINTenv variable. - For authentication, you can set user using the
ANSIBLE_HWC_USERenv variable. - For authentication, you can set password using the
ANSIBLE_HWC_PASSWORDenv variable. - For authentication, you can set domain using the
ANSIBLE_HWC_DOMAINenv variable. - For authentication, you can set project using the
ANSIBLE_HWC_PROJECTenv variable. - For authentication, you can set region using the
ANSIBLE_HWC_REGIONenv variable. - Environment variables values will only be used if the playbook values are not set.
Examples
- name: create a vpc
hwc_network_vpc:
identity_endpoint: "{{ identity_endpoint }}"
user: "{{ user }}"
password: "{{ password }}"
domain: "{{ domain }}"
project: "{{ project }}"
region: "{{ region }}"
name: "vpc_1"
cidr: "192.168.100.0/24"
state: present
Return Values
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description | |
|---|---|---|---|
| cidr string | success | the range of available subnets in the vpc. | |
| enable_shared_snat boolean | success | show whether the shared snat is enabled. | |
| id string | success | the id of vpc. | |
| name string | success | the name of vpc. | |
| routes complex | success | the route information. | |
| destination string | success | the destination network segment of a route. | |
| next_hop string | success | the next hop of a route. | |
| status string | success | the status of vpc. | |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Huawei Inc. (@huaweicloud)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/hwc_network_vpc_module.html