dellemc / dellemc.powerstore / 1.3.0 / module / dellemc_powerstore_network Manage networks on Dell EMC PowerStore. | "added in version" 1.3.0 of dellemc.powerstore" Authors: Akash Shendge (@shenda1) <ansible.team@dell.com> preview | supported by communitydellemc.powerstore.dellemc_powerstore_network (1.3.0) — module
Install with ansible-galaxy collection install dellemc.powerstore:==1.3.0
collections: - name: dellemc.powerstore version: 1.3.0
Managing networks on PowerStore Storage System includes getting details of network, modifying attributes of network and adding/removing IP ports to/from storage network.
- name: Get network details using ID dellemc_powerstore_network: array_ip: "{{array_ip}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" network_id: "NW1" state: "present"
- name: Get network details using name dellemc_powerstore_network: array_ip: "{{array_ip}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" network_name: "Default Management Network" state: "present"
- name: Rename the storage network dellemc_powerstore_network: array_ip: "{{array_ip}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" network_name: "Default Storage Network" new_name: "iSCSI Network" wait_for_completion: True state: "present"
- name: Replace the IP's in the management network and re-register VASA vendor provider dellemc_powerstore_network: array_ip: "{{array_ip}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" network_id: "NW1" addresses: - current_address: "100.230.x.x" new_address: "100.230.x.x" - current_address: "100.230.x.x" new_address: "100.230.x.x" - current_address: "100.230.x.x" new_address: "100.230.x.x" new_cluster_mgmt_address: "100.230.x.x" vasa_provider_credentials: username: "vmadmin" password: "{{vm_password}}" state: "present"
- name: Map port to the storage network dellemc_powerstore_network: array_ip: "{{array_ip}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" network_id: "NW6" ports: - "IP1" port_state: "present-in-network" state: "present"
- name: Unmap port from the storage network dellemc_powerstore_network: array_ip: "{{array_ip}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" network_id: "NW6" ports: - "IP1" port_state: "absent-in-network" state: "present"
- name: Replace the IP's in the management network and re-register VASA vendor provider for X model dellemc_powerstore_network: array_ip: "{{array_ip1}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" network_id: "NW1" vlan_id: 0 gateway: "100.231.x.x" mtu: 1500 prefix_length: 24 addresses: - current_address: "100.230.x.x" new_address: "100.231.x.x" - current_address: "100.230.x.x" new_address: "100.231.x.x" - current_address: "100.230.x.x" new_address: "100.231.x.x" - current_address: "100.230.x.x" new_address: "100.231.x.x" - current_address: "100.230.x.x" new_address: "100.231.x.x" new_cluster_mgmt_address: "100.231.x.x" vasa_provider_credentials: username: "vmadmin" password: "{{vm_password}}" esxi_credentials: - "node_id": "N1" "password": "{{node_password}}" - "node_id": "N2" "password": "{{node_password}}" state: "present"
mtu: description: - Maximum Transmission Unit (MTU) packet size set on network interfaces, in bytes. type: int user: description: - The username of the PowerStore host. required: true type: str ports: description: - Ports to be mapped/unmapped to/from the storage network. elements: str type: list state: choices: - absent - present description: - Define whether the network exist or not. required: true type: str gateway: description: - Network gateway in IPv4 or IPv6 format, corresponding to the network's IP version. - Specify empty string to remove the gateway. type: str vlan_id: description: - The ID of the VLAN. type: int array_ip: description: - IP or FQDN of the PowerStore management system. required: true type: str new_name: description: - New name of the network. type: str password: description: - The password of the PowerStore host. required: true type: str addresses: description: - IP addresses to add/remove in IPv4 or IPv6 format. elements: dict suboptions: current_address: description: - Existing IPv4/IPv6 address. type: str new_address: description: - New IPv4/IPv6 address. type: str type: list network_id: description: - The ID of the network. type: str port_state: choices: - present-in-network - absent-in-network description: - Specifies whether port should mapped/unmapped from the storage network. type: str verifycert: choices: - true - false description: - Boolean variable to specify whether to validate SSL certificate or not. - True - indicates that the SSL certificate should be verified. Set the environment variable REQUESTS_CA_BUNDLE to the path of the SSL certificate. - False - indicates that the SSL certificate should not be verified. required: true type: bool network_name: description: - The name of the network. - This parameter is added in 2.0.0.0. - Specify either network_name or network_id for any operation. type: str prefix_length: description: - Network prefix length. type: int esxi_credentials: description: - Credentials required for re-registering the ESXi hosts in the vCenter. - It should be passed only when ESXi host addresses or management network VLAN / prefix / gateway are changed during the reconfiguration of the PowerStore X model appliances. - This parameter is applicable only for PowerStore X model. - This parameter will be ignored if passed for PowerStore T model. elements: dict suboptions: node_id: description: - Node identifier corresponding to the ESXi host. required: true type: str password: description: - ESXi host root password. required: true type: str type: list wait_for_completion: default: false description: - Flag to indicate if the operation should be run synchronously or asynchronously. True signifies synchronous execution. By default, modify operation will run asynchronously. type: bool new_cluster_mgmt_address: description: - New cluster management IP address in IPv4 or IPv6 format, corresponding to the network's IP version. type: str storage_discovery_address: description: - New storage discovery IP address in IPv4 or IPv6 format, corresponding to the network's IP version. - Specify empty string to remove the storage discovery IP address. type: str vasa_provider_credentials: description: - Credentials required for re-registering the VASA vendor provider during the reconfiguration of the cluster management IP address. suboptions: password: description: - VASA vendor provider password. required: true type: str username: description: - VASA vendor provider user name. required: true type: str type: dict
changed: description: Whether or not the resource has changed. returned: always type: bool job_details: contains: id: description: The ID of the job. type: str description: The job details. returned: When asynchronous task is performed. type: complex network_details: contains: cluster_details: contains: appliance_count: description: Number of appliances configured in this cluster. type: int id: description: The unique identifier of the cluster. type: str management_address: description: The floating management IP address for the cluster in IPv4 or IPv6 format. type: str name: description: The name of the cluster. type: str storage_discovery_address: description: The floating storage discovery IP address for the cluster in IPv4 or IPv6 format. type: str description: The details of the cluster. type: complex gateway: description: The gateway of the network. type: str id: description: The ID of the network. type: str ip_version: description: IP protocol version type: str member_ips: contains: address: description: IP address value, in IPv4 or IPv6 format. type: str appliance_id: description: Unique identifier of the appliance to which the IP address belongs. type: str id: description: Unique identifier of the IP address. type: str ip_port_id: description: Unique identifier of the port that uses this IP address to provide access to storage network services, such as iSCSI. This attribute can be set only for an IP address used by networks of type Storage. type: str name: description: Name of the IP address. type: str network_id: description: Unique identifier of the network to which the IP address belongs. type: str node_id: description: Unique identifier of the cluster node to which the IP address belongs. type: str purposes: description: IP address purposes. type: list description: Properties of the IP pool address. type: complex mtu: description: Maximum Transmission Unit (MTU) packet size set on network interfaces, in bytes. type: int name: description: The name of the network. type: str prefix_length: description: Network prefix length. type: int purposes: description: Purposes of the network. type: list type: description: Network type type: str vcenter_details: contains: address: description: IP address of vCenter host, in IPv4, IPv6, or hostname format. type: str id: description: Unique identifier of the vCenter instance. type: str instance_uuid: description: UUID instance of the vCenter. type: str username: description: User name to login to vCenter. type: str vendor_provider_status: description: General status of the VASA vendor provider in vCenter. type: str description: Details of the vcenter. type: complex vlan_id: description: VLAN identifier. type: int description: The network details. returned: When network exists. type: complex