Vh ^RdZdZdZddlmZGddeZdZedk(rey y ) aD --- module: port short_description: Add/Update/Delete ports from an OpenStack cloud. author: OpenStack Ansible SIG description: - Add, Update or Remove ports from an OpenStack cloud. options: allowed_address_pairs: description: - "Allowed address pairs list. Allowed address pairs are supported with dictionary structure. e.g. allowed_address_pairs: - ip_address: 10.1.0.12 mac_address: ab:cd:ef:12:34:56 - ip_address: ..." - The port will change during update if not all suboptions are specified, e.g. when ip_address is given but mac_address is not. type: list elements: dict suboptions: ip_address: description: The IP address. type: str mac_address: description: The MAC address. type: str binding_profile: description: - Binding profile dict that the port should be created with. type: dict binding_vnic_type: description: - The type of the port that should be created choices: [normal, direct, direct-physical, macvtap, baremetal, virtio-forwarder] type: str aliases: ['vnic_type'] description: description: - Description of the port. type: str device_id: description: - Device ID of device using this port. type: str device_owner: description: - The ID of the entity that uses this port. type: str dns_domain: description: - The dns domain of the port ( only with dns-integration enabled ) type: str dns_name: description: - The dns name of the port ( only with dns-integration enabled ) type: str extra_dhcp_opts: description: - "Extra dhcp options to be assigned to this port. Extra options are supported with dictionary structure. Note that options cannot be removed only updated. e.g. extra_dhcp_opts: - ip_version: 4 opt_name: bootfile-name opt_value: pxelinux.0 - opt_name: ..." - The port will change during update if not all suboptions are specified, e.g. when opt_name is given but ip_version is not. type: list elements: dict suboptions: ip_version: description: The IP version this DHCP option is for. type: int required: true opt_name: description: The name of the DHCP option to set. type: str required: true opt_value: description: The value of the DHCP option to set. type: str required: true fixed_ips: description: - Desired IP and/or subnet for this port. Subnet is referenced by subnet_id and IP is referenced by ip_address. - The port will change during update if not all suboptions are specified, e.g. when ip_address is given but subnet_id is not. type: list elements: dict suboptions: ip_address: description: The fixed IP address to attempt to allocate. required: true type: str subnet_id: description: The subnet to attach the IP address to. type: str is_admin_state_up: description: - Sets admin state. type: bool aliases: ['admin_state_up'] mac_address: description: - MAC address of this port. type: str name: description: - Name that has to be given to the port. - This port attribute cannot be updated. type: str required: true network: description: - ID or name of the network this port belongs to. - Required when creating a new port. - Must be a name when creating a port. - This port attribute cannot be updated. type: str no_security_groups: description: - Do not associate a security group with this port. - "Deprecated. Use I(security_groups): C([]) instead of I(no_security_groups): C(true)." type: bool default: 'false' is_port_security_enabled: description: - Whether to enable or disable the port security on the network. type: bool aliases: ['port_security_enabled'] security_groups: description: - Security group(s) ID(s) or name(s) associated with the port. type: list elements: str state: description: - Should the resource be present or absent. choices: [present, absent] default: present type: str extends_documentation_fragment: - openstack.cloud.openstack a # Create a port - openstack.cloud.port: state: present auth: auth_url: https://identity.example.com username: admin password: admin project_name: admin name: port1 network: foo # Create a port with a static IP - openstack.cloud.port: state: present auth: auth_url: https://identity.example.com username: admin password: admin project_name: admin name: port1 network: foo fixed_ips: - ip_address: 10.1.0.21 # Create a port with No security groups - openstack.cloud.port: state: present auth: auth_url: https://identity.example.com username: admin password: admin project_name: admin name: port1 network: foo no_security_groups: True # Update the existing 'port1' port with multiple security groups (version 1) - openstack.cloud.port: state: present auth: auth_url: https://identity.example.com username: admin password: admin project_name: admin name: port1 security_groups: 1496e8c7-4918-482a-9172-f4f00fc4a3a5,057d4bdf-6d4d-472... # Update the existing 'port1' port with multiple security groups (version 2) - openstack.cloud.port: state: present auth: auth_url: https://identity.example.com username: admin password: admin project_name: admin name: port1 security_groups: - 1496e8c7-4918-482a-9172-f4f00fc4a3a5 - 057d4bdf-6d4d-472... # Create port of type 'direct' - openstack.cloud.port: state: present auth: auth_url: https://identity.example.com username: admin password: admin project_name: admin name: port1 network: foo binding_vnic_type: direct # Create a port with binding profile - openstack.cloud.port: state: present auth: auth_url: https://identity.example.com username: admin password: admin project_name: admin name: port1 network: foo binding_profile: pci_slot: "0000:03:11.1" physical_network: "provider" ao port: description: Dictionary describing the port. type: dict returned: On success when I(state) is C(present). contains: allowed_address_pairs: description: Allowed address pairs. returned: success type: list sample: [] binding_host_id: description: | The ID of the host where the port is allocated. In some cases, different implementations can run on different hosts. returned: success type: str sample: "b4bd682d-234a-4091-aa5b-4b025a6a7759" binding_profile: description: | A dictionary the enables the application running on the specified host to pass and receive vif port-specific information to the plug-in. returned: success type: dict sample: {} binding_vif_details: description: | A dictionary that enables the application to pass information about functions that the Networking API provides. returned: success type: dict binding_vif_type: description: The VIF type for the port. returned: success type: dict binding_vnic_type: description: | The virtual network interface card (vNIC) type that is bound to the neutron port. returned: success type: str sample: "normal" created_at: description: Timestamp when the port was created. returned: success type: str sample: "2022-02-03T13:28:25Z" data_plane_status: description: Status of the underlying data plane of a port. returned: success type: str description: description: The port description. returned: success type: str device_id: description: Device ID of this port. returned: success type: str sample: "b4bd682d-234a-4091-aa5b-4b025a6a7759" device_owner: description: Device owner of this port, e.g. C(network:dhcp). returned: success type: str sample: "network:router_interface" device_profile: description: | Device profile of this port, refers to Cyborg device-profiles: https://docs.openstack.org/api-ref/accelerator/v2/index.html# device-profiles. returned: success type: str dns_assignment: description: DNS assignment for the port. returned: success type: list dns_domain: description: DNS domain assigned to the port. returned: success type: str dns_name: description: DNS name for the port. returned: success type: str extra_dhcp_opts: description: | A set of zero or more extra DHCP option pairs. An option pair consists of an option value and name. returned: success type: list sample: [] fixed_ips: description: | IP addresses for the port. Includes the IP address and subnet ID. returned: success type: list id: description: The port ID. returned: success type: str sample: "3ec25c97-7052-4ab8-a8ba-92faf84148de" ip_allocation: description: | The ip_allocation indicates when ports use deferred, immediate or no IP allocation. returned: success type: str is_admin_state_up: description: | The administrative state of the port, which is up C(True) or down C(False). returned: success type: bool sample: true is_port_security_enabled: description: | The port security status, which is enabled C(True) or disabled C(False). returned: success type: bool sample: false mac_address: description: The MAC address of an allowed address pair. returned: success type: str sample: "00:00:5E:00:53:42" name: description: The port name. returned: success type: str sample: "port_name" network_id: description: The ID of the attached network. returned: success type: str sample: "dd1ede4f-3952-4131-aab6-3b8902268c7d" numa_affinity_policy: description: | The NUMA affinity policy defined for this port. returned: success type: str sample: "required" project_id: description: The ID of the project who owns the network. returned: success type: str sample: "aa1ede4f-3952-4131-aab6-3b8902268c7d" propagate_uplink_status: description: Whether to propagate uplink status of the port. returned: success type: bool sample: false qos_network_policy_id: description: | The ID of the QoS policy attached to the network where the port is bound. returned: success type: str sample: "1e4f3958-c0c9-4dec-82fa-ed2dc1c5cb34" qos_policy_id: description: The ID of the QoS policy attached to the port. returned: success type: str sample: "b20bb47f-5d6d-45a6-8fe7-2c1b44f0db73" resource_request: description: | The port-resource-request exposes Placement resources (i.e.: minimum-bandwidth) and traits (i.e.: vnic-type, physnet) requested by a port to Nova and Placement. returned: success type: str revision_number: description: The revision number of the resource. returned: success type: int sample: 0 security_group_ids: description: The IDs of any attached security groups. returned: success type: list status: description: The port status. Value is C(ACTIVE) or C(DOWN). returned: success type: str sample: "ACTIVE" tags: description: The list of tags on the resource. returned: success type: list sample: [] tenant_id: description: Same as I(project_id). Deprecated. returned: success type: str sample: "51fce036d7984ba6af4f6c849f65ef00" trunk_details: description: | The trunk referring to this parent port and its subports. Present for trunk parent ports if C(trunk-details) extension is loaded. returned: success type: dict updated_at: description: Timestamp when the port was last updated. returned: success type: str sample: "2022-02-03T13:28:25Z" )OpenStackModulec eZdZed/idedddeddegdd g d ed ed ededededddedddeddgdededdededddeddgd edd!d"ed#d$d#g%Zedd ggd&gd'Zd(Zd)Zd*Zd+Z d,Z d-Z y.)0 PortModuleallowed_address_pairslistdict)typeelementsbinding_profile)r binding_vnic_type)normaldirectzdirect-physicalmacvtap baremetalzvirtio-forwarder vnic_type)choicesaliases description device_id device_owner dns_domaindns_nameextra_dhcp_opts fixed_ipsis_admin_state_upbooladmin_state_up)r r mac_addressnameT)requirednetworkno_security_groupsF)defaultr is_port_security_enabledport_security_enabledsecurity_groupsstrstatepresentabsent)r#r)r(r))r!)mutually_exclusive required_ifsupports_check_modech|jd}|jd}|jd}d}|r'|jjj|d}|jjj|fi|rt |j n t }|jjr"|j|j|||dk(r7|s5|j|}|jd |jd  y|dk(rT|rR|j|}|r|j||}|jt||jd  y|d k(r&|r$|j!||jd y|d k(r|s|jdyyy) Nr!rr(Fignore_missing) network_id)changedr)T)computed)r2portr*)paramsconnr! find_network find_portridansible check_mode exit_json _will_change_createto_dict _build_update_updater_delete)selfnetwork_name_or_idport_name_or_idr(r!r4updates h/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/openstack/cloud/plugins/modules/port.pyrunzPortModule.runs![[3++f- G$ ii''44"55:G+tyy  ** D/6twzz*46D << " " NN4#4#4T5#AN B I d<<(D NN4 $ e <  > i D''-F||D&1 NN4< $ e <  > h 4 LL  NN4N ( h t NN5N )(, ci}tfddD}dD]O}j|j|s|s(j||k7s>j|||<QdD]O}j|j|s|s(j||k7s>j|||<Qjdrg}n]jdLjdDcgc]3}jjj |dj 5}}nd}|t |t d k7r||d <jjd rIjjjd r$|jtfd d D|r||d<|Scc}w)Nc3K|]G}|jvr7j|(j||k7r|j|fIywNr5.0kr4rCs rG z+PortModule._build_update..?sU+ DKKDKKN$> A$q') A +sA A) binding_host_idr data_plane_statusrrrrr$rnuma_affinity_policy)r )rrrr"r&Fr/security_group_idsdnsdns-integrationc3K|]9}j|(j||k7r|j|f;ywrLrMrNs rGrQz+PortModule._build_update..qsG(;;q>-$++a.DG2KDKKN#(s?A)rrport_attributes) rr5r6r!find_security_groupr9set has_servicefind_extensionrF)rCr4rFrYrPrUsecurity_group_name_or_ids`` rGr@zPortModule._build_updatesJ+.++% 4A{{1~% A$q';;q>T!W,%)[[^"  4K 4A{{1~% A$q';;q>T!W,%)[[^"  4 ;;+ ,!#  [[* + 726=N1O". !!55-e6EEGRH" " "&   )%&#d3G.H*II4FO0 1 99  ' 99   + +,= >  " "4(3($  (7F$ % /"s48F?ci}|j|d<|jdrg|d<n^|jdO|jdDcgc]3}|jjj |dj5c}|d<dD]$}|j||j|||<&|jj drN|jjj d r)d D]$}|j||j|||<&|jjjd i|Scc}w) Nr1r"rUr&Fr/) rr r rrrrrrr$rrrVrW)rr)r9r5r6r!rZr\r] create_port)rCr!argsr^rPs rGr>zPortModule._create{sJ$ZZ\ ;;+ ,)+D% & [[* + 726=N1O*. !!55-e6EEGRH*D% &  )A{{1~)++a.Q ) 99  'yy  //0AB/ -;;q>-"kk!nDG --tyy  ,,4t447*s8D=cb|jjj|jyrL)r6r! delete_portr9)rCr4s rGrBzPortModule._deletes %%dgg.rIcz|jd}|r'|jjj|fi|}|S)NrY)getr6r! update_port)rCr4rFrYs rGrAzPortModule._updates: **%67 0499$$00IID rIcf|dk(r|sy|dk(r|rt|j|S|dk(r|ryy)Nr)Tr*F)rr@)rCr4r(s rGr=zPortModule._will_changesA I d i D**401 1 h 4rINr`) __name__ __module__ __qualname__r argument_spec module_kwargsrHr@r>rBrAr=r`rIrGrrsu"@&)(<)4}6F&V6&6:FV4F5E4FGF 4 !"#$ F;%&"&6rvsNX tV pQ f_ddN  zFrI