VhARdZdZdZddlmZGddeZdZedk(rey y ) aK --- module: subnet short_description: Add/Remove subnet to an OpenStack network author: OpenStack Ansible SIG description: - Add or Remove a subnet to an OpenStack network options: state: description: - Indicate desired state of the resource choices: ['present', 'absent'] default: present type: str allocation_pool_start: description: - From the subnet pool the starting address from which the IP should be allocated. type: str allocation_pool_end: description: - From the subnet pool the last IP that should be assigned to the virtual machines. type: str allocation_pools: description: - List of allocation pools to assign to the subnet. Each element consists of a 'start' and 'end' value. type: list elements: dict cidr: description: - The CIDR representation of the subnet that should be assigned to the subnet. Required when I(state) is 'present' and a subnetpool is not specified. type: str description: description: - Description of the subnet type: str disable_gateway_ip: description: - The gateway IP would not be assigned for this subnet type: bool aliases: ['no_gateway_ip'] default: 'false' dns_nameservers: description: - List of DNS nameservers for this subnet. type: list elements: str extra_attrs: description: - Dictionary with extra key/value pairs passed to the API required: false aliases: ['extra_specs'] default: {} type: dict host_routes: description: - A list of host route dictionaries for the subnet. type: list elements: dict suboptions: destination: description: The destination network (CIDR). type: str required: true nexthop: description: The next hop (aka gateway) for the I(destination). type: str required: true gateway_ip: description: - The ip that would be assigned to the gateway for this subnet type: str ip_version: description: - The IP version of the subnet 4 or 6 default: 4 type: int choices: [4, 6] is_dhcp_enabled: description: - Whether DHCP should be enabled for this subnet. type: bool aliases: ['enable_dhcp'] default: 'true' ipv6_ra_mode: description: - IPv6 router advertisement mode choices: ['dhcpv6-stateful', 'dhcpv6-stateless', 'slaac'] type: str ipv6_address_mode: description: - IPv6 address mode choices: ['dhcpv6-stateful', 'dhcpv6-stateless', 'slaac'] type: str name: description: - The name of the subnet that should be created. Although Neutron allows for non-unique subnet names, this module enforces subnet name uniqueness. required: true type: str network: description: - Name or id of the network to which the subnet should be attached - Required when I(state) is 'present' aliases: ['network_name'] type: str project: description: - Project name or ID containing the subnet (name admin-only) type: str prefix_length: description: - The prefix length to use for subnet allocation from a subnet pool type: str use_default_subnet_pool: description: - Use the default subnetpool for I(ip_version) to obtain a CIDR. type: bool aliases: ['use_default_subnetpool'] subnet_pool: description: - The subnet pool name or ID from which to obtain a CIDR type: str required: false extends_documentation_fragment: - openstack.cloud.openstack a # Create a new (or update an existing) subnet on the specified network - openstack.cloud.subnet: state: present network_name: network1 name: net1subnet cidr: 192.168.0.0/24 dns_nameservers: - 8.8.8.7 - 8.8.8.8 host_routes: - destination: 0.0.0.0/0 nexthop: 12.34.56.78 - destination: 192.168.0.0/24 nexthop: 192.168.0.1 # Delete a subnet - openstack.cloud.subnet: state: absent name: net1subnet # Create an ipv6 stateless subnet - openstack.cloud.subnet: state: present name: intv6 network_name: internal ip_version: 6 cidr: 2db8:1::/64 dns_nameservers: - 2001:4860:4860::8888 - 2001:4860:4860::8844 ipv6_ra_mode: dhcpv6-stateless ipv6_address_mode: dhcpv6-stateless a  id: description: Id of subnet returned: On success when subnet exists. type: str subnet: description: Dictionary describing the subnet. returned: On success when subnet exists. type: dict contains: allocation_pools: description: Allocation pools associated with this subnet. returned: success type: list elements: dict cidr: description: Subnet's CIDR. returned: success type: str created_at: description: Created at timestamp type: str description: description: Description type: str dns_nameservers: description: DNS name servers for this subnet. returned: success type: list elements: str dns_publish_fixed_ip: description: Whether to publish DNS records for fixed IPs. returned: success type: bool gateway_ip: description: Subnet's gateway ip. returned: success type: str host_routes: description: A list of host routes. returned: success type: str id: description: Unique UUID. returned: success type: str ip_version: description: IP version for this subnet. returned: success type: int ipv6_address_mode: description: | The IPv6 address modes which are 'dhcpv6-stateful', 'dhcpv6-stateless' or 'slaac'. returned: success type: str ipv6_ra_mode: description: | The IPv6 router advertisements modes which can be 'slaac', 'dhcpv6-stateful', 'dhcpv6-stateless'. returned: success type: str is_dhcp_enabled: description: DHCP enable flag for this subnet. returned: success type: bool name: description: Name given to the subnet. returned: success type: str network_id: description: Network ID this subnet belongs in. returned: success type: str prefix_length: description: | The prefix length to use for subnet allocation from a subnet pool. returned: success type: str project_id: description: Project id associated with this subnet. returned: success type: str revision_number: description: Revision number of the resource returned: success type: int segment_id: description: The ID of the segment this subnet is associated with. returned: success type: str service_types: description: Service types for this subnet returned: success type: list subnet_pool_id: description: The subnet pool ID from which to obtain a CIDR. returned: success type: str tags: description: Tags type: str updated_at: description: Timestamp when the subnet was last updated. returned: success type: str use_default_subnet_pool: description: | Whether to use the default subnet pool to obtain a CIDR. returned: success type: bool )OpenStackModulec .eZdZgdZed>EEdKM Mc|jd}|dk(r|duS|sy|j|||}|j||}|j||t |S)Nr,r.T)params _build_params_build_updatesr>r)r9r:r r/r&r,rAupdatess r=_system_state_changez!SubnetModule._system_state_changeasi G$ H % %##GWkB%%ff5 fg.G}r?c`|jd}|jd}|rt||gSy)Nrr )startend)rAr")r9 pool_startpool_ends r= _build_poolzSubnetModule._build_poolms6[[!89 ;;45 zx89 9r?c|jDcic]}||j|}}|j|d<|r|j|d<|r|j|d<|jdr|j|d<n|jd|d<|j |}|j Dcic] \}}| || }}}|Scc}wcc}}w)N network_id project_idsubnet_pool_idrr!) attr_paramsrAidrK_add_extra_attrsitems)r9r r/r&r<rAkvs r=rBzSubnetModule._build_paramsts6:6F6FGd$ D))GG&zz| #*::F< '2~~F# $ ;;. /)-)9)9);F% &)-5G)HF% &&&v.#)<<>C41aQ]!Q$CC HDsC2 C =C cd|vr&|dj|djd|vr,|djd|djdd|vr,|djd|djd|Dcic]}||||k7s|||}}|jd r|jrd|d <|Scc}w) Nrr#c4t|jSNsortedrSrs r=z-SubnetModule._build_updates..VAGGI5Fr?)keyc4t|jSrXrYr[s r=r]z-SubnetModule._build_updates..r^r?r!c4t|jSrXrYr[s r=r]z-SubnetModule._build_updates..&:Kr?c4t|jSrXrYr[s r=r]z-SubnetModule._build_updates..rbr?rr)sortrAr)r9r:rArTrDs r=rCzSubnetModule._build_updatess  & $ % * * , $ % * * , F " = ! & &+F & G = ! & &+F & G  ' % & + +0K + L % & + +0K + L)/JA6!9q 3I1fQi<JJ ;;+ ,1B1B$(GL !Ks C  C ct|jdt|z}|r*|jdjt ||j |jd|S)Nr*z#Duplicate key(s) {0} in extra_specsr5)setrAr7r8rr;)r9rA duplicatess r=rRzSubnetModule._add_extra_attrss^]34s6{B  NND"F4 #34  6 dkk-01 r?c4|jd}|jd}|jd}|jd}|jd}|jd}|jd}|r|r|jd i}i} d} |rE|jjj |d } | j |d <| j | d <d} |r8|jj j|fd d i| } | j | d<d} |r8|jj j|fd d i|} | j | d<|jj j|fi| } |jjr$|j|j| | | | d }|dk(r|j| | | }| )|jj jdi|} d}nO|j!| |}|r;|j#| ||jj j$| fi|} d}|j|| | j n.|dk(r)| '|jj j'| d}|j|y)Nr,r r/r&rrrz,no_gateway_ip is not allowed with gateway_ipr5F)ignore_missingrNrirMrO)changedr-T)rjr:rQr.)rAr7connidentity find_projectrQr find_networkfind_subnet_pool find_subnetansible check_mode exit_jsonrErB create_subnetrCr> update_subnet delete_subnet)r9r,network_name_or_idproject_name_or_idsubnet_pool_name_or_id subnet_namerrsubnet_pool_filtersfiltersr/r r&r:rjrArDs r=runzSubnetModule.runs G$![[3![[3!%]!;kk&) [[. ![[)=> * NNMN N  ii((556HEJ6LG07  -$+JJGL ! 4dii''445G@DI@7>@G%,JJGL ! !<$))++<<&'$'&'K)4G$ %.""..{FgF << " " NN4#<#<+$7N 8 I ''+FF~8**88B6B--ff=))&':rErKrBrCrRr~rkr?r=rr$sH 4 n-.VF  UA1v>  &$&3_6 6 0AC&59#f!F6F;fv6 "34!"'89#$F%&f'(!%":!;!=),fdf}oN-.9$i02/23M8 13JKL . G   M /K M  &=(r?rc&t}|yrX)r)modules r=mainrs ^F Hr?__main__N) DOCUMENTATIONEXAMPLESRETURNBansible_collections.openstack.cloud.plugins.module_utils.openstackrrrrrkr?r=rsMC J! Fp d_w(?w(t  zFr?