Vh$zddlmZmZmZeZdZdZdZddl m Z ddl m Z m Z Gdd e Zd Zed k(rey y ) )absolute_importdivisionprint_functionu --- module: subnet short_description: Manages subnets on the cloudscale.ch IaaS service description: - Create, update and remove subnets. author: - René Moser (@resmo) version_added: "1.3.0" options: uuid: description: - UUID of the subnet. type: str cidr: description: - The cidr of the subnet. - Required if I(state=present). type: str network: description: - The name of the network the subnet is related to. - Required if I(state=present). type: dict suboptions: uuid: description: - The uuid of the network. type: str name: description: - The uuid of the network. type: str zone: description: - The zone the network allocated in. type: str gateway_address: description: - The gateway address of the subnet. If not set, no gateway is used. - Cannot be within the DHCP range, which is the lowest .101-.254 in the subnet. type: str dns_servers: description: - A list of DNS resolver IP addresses, that act as DNS servers. - If not set, the cloudscale.ch default resolvers are used. type: list elements: str reset: description: - Resets I(gateway_address) and I(dns_servers) to default values by the API. - "Note: Idempotency is not given." type: bool default: false state: description: - State of the subnet. choices: [ present, absent ] default: present type: str tags: description: - Tags associated with the subnet. Set this to C({}) to clear any tags. type: dict extends_documentation_fragment: cloudscale_ch.cloud.api_parameters aX --- - name: Ensure subnet exists cloudscale_ch.cloud.subnet: cidr: 172.16.0.0/24 network: uuid: 2db69ba3-1864-4608-853a-0771b6885a3a api_token: xxxxxx - name: Ensure subnet exists cloudscale_ch.cloud.subnet: cidr: 192.168.1.0/24 gateway_address: 192.168.1.1 dns_servers: - 192.168.1.10 - 192.168.1.11 network: name: private zone: lpg1 api_token: xxxxxx - name: Ensure a subnet is absent cloudscale_ch.cloud.subnet: cidr: 172.16.0.0/24 network: name: private zone: lpg1 state: absent api_token: xxxxxx a{ --- href: description: API URL to get details about the subnet. returned: success type: str sample: https://api.cloudscale.ch/v1/subnets/33333333-1864-4608-853a-0771b6885a3 uuid: description: The unique identifier for the subnet. returned: success type: str sample: 33333333-1864-4608-853a-0771b6885a3 cidr: description: The CIDR of the subnet. returned: success type: str sample: 172.16.0.0/24 network: description: The network object of the subnet. returned: success type: complex contains: href: description: API URL to get details about the network. returned: success type: str sample: https://api.cloudscale.ch/v1/networks/33333333-1864-4608-853a-0771b6885a3 uuid: description: The unique identifier for the network. returned: success type: str sample: 33333333-1864-4608-853a-0771b6885a3 name: description: The name of the network. returned: success type: str sample: my network zone: description: The zone the network is allocated in. returned: success type: dict sample: { 'slug': 'rma1' } version_added: 1.4.0 gateway_address: description: The gateway address of the subnet. returned: success type: str sample: "192.168.42.1" dns_servers: description: List of DNS resolver IP addresses. returned: success type: list sample: ["9.9.9.9", "149.112.112.112"] state: description: State of the subnet. returned: success type: str sample: present tags: description: Tags associated with the subnet. returned: success type: dict sample: { 'project': 'my project' } ) AnsibleModule)AnsibleCloudscaleBasecloudscale_argument_speccDeZdZfdZddZfdZfdZfdZxZS)AnsibleCloudscaleSubnetcLtt| |ddgdgdd|_y)Nsubnetscidr)rgateway_address dns_serverstags)rrr)module resource_nameresource_key_nameresource_create_param_keysresource_update_param_keys)superr __init___network)selfr __class__s n/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cloudscale_ch/cloud/plugins/modules/subnet.pyrz AnsibleCloudscaleSubnet.__init__s4 %t5#$( ( 6  c,|j |jS|jjd}|xs|d}|6|jd|z}|s|jj d|zn|dg}|jd}|xsgD]?}|d|dd |dk7r|j d|dk(s/|j |A|s%d |dz}|jj |nUt|d k(r|d }nAd |dz}|jj |n|jj dt|_jD]\}} |dvs | |j|<|jS)Nnetworkuuidz networks/%sz!Network with 'uuid' not found: %smsgnamenetworkszoneslugz!Network with 'name' not found: %srzxMultiple networks with 'name' not found: %s.Add the 'zone' to distinguish or use 'uuid' argument to specify the network.z(Either Network UUID or name is required.)r#r hrefr%) r_moduleparams_get fail_jsongetappendlendictitems) rr net_paramnet_uuidrnetworks_foundr$r"kvs r query_networkz%AnsibleCloudscaleSubnet.query_networks == $== LL'' 2 ,9V,  ii  89G &&+NQY+Y&Z v  *Nyy,H#>r 3V$0WV_V5LPYZ`Pa5a;;v&)F*;;"))'2  3"9IfxHHr)N) __name__ __module__ __qualname__rr7r9rDrH __classcell__)rs@rr r s&&-^KE*IIrr ct}|jttdtdtdttdtdtdtdtdddtdtdd td d d g t|dddd}t |}|j dd k(r|j }n|j}|jdi|y)Nstr)typer0)r r#r%)rOoptionslist)rOelementsdefaultboolF)rOrSpresentabsent)rSchoices)r rrrrrr=state))rr )rr))rXrUrYT) argument_specrequired_one_ofrequired_together required_ifsupports_check_moderX) r rDr0rr r*rVrU exit_json)rZrcloudscale_subnetresults rmainrcs,.M u  u u%u%u% %(fudC v .9x.CD$#,1B F07 }}W)"))+"**,Fvr__main__N) __future__rrrrO __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrmodule_utils.apirr r rcrIr_rrrlsaA@ A F >? B5 dI3dIN"J zFr