dellemc.powerscale.dellemc_powerscale_subnet (1.4.0) — module

Manages subnet configuration on PowerScale

| "added in version" 1.4.0 of dellemc.powerscale"

Authors: Jennifer John (@johnj9) <ansible.team@dell.com>

preview | supported by community

Install collection

Install with ansible-galaxy collection install dellemc.powerscale:==1.4.0


Add to requirements.yml

  collections:
    - name: dellemc.powerscale
      version: 1.4.0

Description

Manages the subnet configuration on the PowerScale storage system. This includes creating, modifying, deleting and retrieving the details of the subnet.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create a subnet
  dellemc_powerscale_subnet:
      onefs_host: "{{onefs_host}}"
      port_no: "{{port_no}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      verify_ssl: "{{verify_ssl}}"
      groupnet_name: "groupnet_test"
      subnet_name: "subnet_test"
      description: "Test subnet"
      netmask: '198.10.**.***'
      gateway_priority: 1
      subnet_params:
        gateway: '198.10.**.***'
        sc_service_addrs:
          - start_range : '198.10.**.***'
            end_range: '198.10.**.***'
        sc_service_addrs_state: "add"
        mtu: 1500
        vlan_enabled: true
        vlan_id: 22
      state: 'present'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Modify a subnet
  dellemc_powerscale_subnet:
      onefs_host: "{{onefs_host}}"
      port_no: "{{port_no}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      verify_ssl: "{{verify_ssl}}"
      groupnet_name: "groupnet_test"
      subnet_name: "subnet_test"
      description: "Test subnet"
      netmask: '198.10.**.***'
      gateway_priority: 2
      subnet_params:
        gateway: '198.10.**.***'
        mtu: 1500
        vlan_enabled: true
        vlan_id: 22
      state: 'present'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Rename a subnet
  dellemc_powerscale_subnet:
      onefs_host: "{{onefs_host}}"
      port_no: "{{port_no}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      verify_ssl: "{{verify_ssl}}"
      groupnet_name: "groupnet_test"
      subnet_name: "subnet_test"
      new_subnet_name: "subnet_test_rename"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Add smart connect service ip range to subnet
  dellemc_powerscale_subnet:
      onefs_host: "{{onefs_host}}"
      port_no: "{{port_no}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      verify_ssl: "{{verify_ssl}}"
      groupnet_name: "groupnet_test"
      subnet_name: "subnet_test"
      subnet_params:
        sc_service_addrs:
          - start_range : '198.10.**.***'
            end_range: '198.10.**.***'
        sc_service_addrs_state: "add"
      state: 'present'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Remove smart connect service ip range from subnet
  dellemc_powerscale_subnet:
      onefs_host: "{{onefs_host}}"
      port_no: "{{port_no}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      verify_ssl: "{{verify_ssl}}"
      groupnet_name: "groupnet_test"
      subnet_name: "subnet_test"
      subnet_params:
        sc_service_addrs:
          - start_range : '198.10.**.***'
            end_range: '198.10.**.***'
        sc_service_addrs_state: "remove"
      state: 'present'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete a subnet
  dellemc_powerscale_subnet:
      onefs_host: "{{onefs_host}}"
      port_no: "{{port_no}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      verify_ssl: "{{verify_ssl}}"
      groupnet_name: "groupnet_test"
      subnet_name: "subnet_test"
      state: 'absent'

Inputs

    
state:
    choices:
    - absent
    - present
    description:
    - The state of the subnet after the task is performed.
    - present - indicates that the subnet should exist on the system.
    - absent - indicates that the subnet should not exist on the system.
    required: true
    type: str

netmask:
    description: Netmask of the subnet
    type: str

port_no:
    default: '8080'
    description:
    - Port number of the PowerScale cluster.It defaults to 8080 if not specified.
    required: false
    type: str

api_user:
    description:
    - username of the PowerScale cluster.
    required: true
    type: str

onefs_host:
    description:
    - IP address or FQDN of the PowerScale cluster.
    required: true
    type: str

verify_ssl:
    choices:
    - true
    - false
    description:
    - boolean variable to specify whether to validate SSL certificate or not.
    - True - indicates that the SSL certificate should be verified.
    - False - indicates that the SSL certificate should not be verified.
    required: true
    type: bool

description:
    description: A description of the subnet.
    type: str

subnet_name:
    description: Name of the subnet
    required: true
    type: str

api_password:
    description:
    - the password of the PowerScale cluster.
    required: true
    type: str

groupnet_name:
    description: Name of the groupnet
    required: true
    type: str

subnet_params:
    description:
    - Specify additional parameters to configure the subnet.
    suboptions:
      gateway:
        description: Gateway IP address.
        type: str
      mtu:
        description: MTU of the subnet.
        type: int
      sc_service_addrs:
        description: List of IP addresses that SmartConnect listens for DNS requests.
        elements: dict
        suboptions:
          end_range:
            description:
            - Specifies the end range for sc_service_addrs.
            required: true
            type: str
          start_range:
            description:
            - Specifies the start range for sc_service_addrs.
            required: true
            type: str
        type: list
      sc_service_addrs_state:
        choices:
        - add
        - remove
        description: Specifies if the sc_service_addrs range need to be added or removed
          from the subnet.
        type: str
      vlan_enabled:
        description: VLAN tagging enabled or disabled
        type: bool
      vlan_id:
        description: VLAN ID for all interfaces in the subnet.
        type: int
    type: dict

new_subnet_name:
    description: Name of the subnet when renaming an existing subnet
    type: str

gateway_priority:
    description: Gateway priority
    type: int

Outputs

changed:
  description: Whether or not the resource has changed
  returned: always
  type: bool
subnet_details:
  contains:
    addr_family:
      description: IP address format.
      type: str
    groupnet:
      description: Name of the groupnet this subnet belongs to.
      type: str
    id:
      description: Unique subnet id.
      type: str
    mtu:
      description: MTU of the subnet.
      type: int
    name:
      description: The name of the subnet.
      type: str
    pools:
      description: List of names of pools in the subnet.
      type: list
    prefixlen:
      description: Subnet prefix length.
      type: int
    sc_service_addr:
      description: The address that SmartConnect listens for DNS requests.
      type: list
  description: Subnet details
  returned: When a subnet exists
  type: complex