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_ENDPOINT
env variable.For authentication, you can set user using the
ANSIBLE_HWC_USER
env variable.For authentication, you can set password using the
ANSIBLE_HWC_PASSWORD
env variable.For authentication, you can set domain using the
ANSIBLE_HWC_DOMAIN
env variable.For authentication, you can set project using the
ANSIBLE_HWC_PROJECT
env variable.For authentication, you can set region using the
ANSIBLE_HWC_REGION
env 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]