dellemc.powerflex.sdc (2.3.0) — module

Install collection

Install with ansible-galaxy collection install dellemc.powerflex:==2.3.0

Add to requirements.yml

  collections:
    - name: dellemc.powerflex
      version: 2.3.0

Description

Managing SDCs on PowerFlex storage system includes getting details of SDC and renaming SDC.

Requirements

• A Dell PowerFlex storage system version 3.6 or later.
• Ansible-core 2.14 or later.
• PyPowerFlex 1.10.0.
• Python 3.9, 3.10 or 3.11.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Get SDC details using SDC ip
  dellemc.powerflex.sdc:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    sdc_ip: "{{sdc_ip}}"
    state: "present"

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Rename SDC using SDC name
  dellemc.powerflex.sdc:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    sdc_name: "centos_sdc"
    sdc_new_name: "centos_sdc_renamed"
    state: "present"

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Modify performance profile of SDC using SDC name
  dellemc.powerflex.sdc:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    sdc_name: "centos_sdc"
    performance_profile: "Compact"
    state: "present"

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Remove SDC using SDC name
  dellemc.powerflex.sdc:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    sdc_name: "centos_sdc"
    state: "absent"

Inputs

    
port:
    default: 443
    description:
    - Port number through which communication happens with PowerFlex host.
    type: int

state:
    choices:
    - present
    - absent
    description:
    - State of the SDC.
    required: true
    type: str

sdc_id:
    description:
    - ID of the SDC.
    - Specify either I(sdc_name), I(sdc_id) or I(sdc_ip) for get/rename operation.
    - Mutually exclusive with I(sdc_name) and I(sdc_ip).
    type: str

sdc_ip:
    description:
    - IP of the SDC.
    - Specify either I(sdc_name), I(sdc_id) or I(sdc_ip) for get/rename operation.
    - Mutually exclusive with I(sdc_id) and I(sdc_name).
    type: str

timeout:
    default: 120
    description:
    - Time after which connection will get terminated.
    - It is to be mentioned in seconds.
    required: false
    type: int

hostname:
    aliases:
    - gateway_host
    description:
    - IP or FQDN of the PowerFlex host.
    required: true
    type: str

password:
    description:
    - The password of the PowerFlex host.
    required: true
    type: str

sdc_name:
    description:
    - Name of the SDC.
    - Specify either I(sdc_name), I(sdc_id) or I(sdc_ip) for get/rename operation.
    - Mutually exclusive with I(sdc_id) and I(sdc_ip).
    type: str

username:
    description:
    - The username of the PowerFlex host.
    required: true
    type: str

sdc_new_name:
    description:
    - New name of the SDC. Used to rename the SDC.
    type: str

validate_certs:
    aliases:
    - verifycert
    default: true
    description:
    - Boolean variable to specify whether or not to validate SSL certificate.
    - C(true) - Indicates that the SSL certificate should be verified.
    - C(false) - Indicates that the SSL certificate should not be verified.
    type: bool

performance_profile:
    choices:
    - Compact
    - HighPerformance
    description:
    - Define the performance profile as I(Compact) or I(HighPerformance).
    - The high performance profile configures a predefined set of parameters for very
      high performance use cases.
    type: str

Outputs

changed:
  description: Whether or not the resource has changed.
  returned: always
  sample: 'false'
  type: bool
sdc_details:
  contains:
    id:
      description: The ID of the SDC.
      type: str
    mapped_volumes:
      contains:
        id:
          description: The ID of the volume.
          type: str
        name:
          description: The name of the volume.
          type: str
        volumeType:
          description: Type of the volume.
          type: str
      description: The details of the mapped volumes.
      type: list
    name:
      description: Name of the SDC.
      type: str
    osType:
      description: OS type of the SDC.
      type: str
    sdcApproved:
      description: Indicates whether an SDC has approved access to the system.
      type: bool
    sdcIp:
      description: IP of the SDC.
      type: str
  description: Details of the SDC.
  returned: When SDC exists
  sample:
    id: 07335d3d00000006
    installedSoftwareVersionInfo: R3_6.0.0
    kernelBuildNumber: null
    kernelVersion: 3.10.0
    links:
    - href: /api/instances/Sdc::07335d3d00000006
      rel: self
    - href: /api/instances/Sdc::07335d3d00000006/relationships/ Statistics
      rel: /api/Sdc/relationship/Statistics
    - href: /api/instances/Sdc::07335d3d00000006/relationships/ Volume
      rel: /api/Sdc/relationship/Volume
    - href: /api/instances/System::4a54a8ba6df0690f
      rel: /api/parent/relationship/systemId
    mapped_volumes: []
    mdmConnectionState: Disconnected
    memoryAllocationFailure: null
    name: LGLAP203
    osType: Linux
    peerMdmId: null
    perfProfile: HighPerformance
    sdcApproved: true
    sdcApprovedIps: null
    sdcGuid: F8ECB844-23B8-4629-92BB-B6E49A1744CB
    sdcIp: N/A
    sdcIps: null
    sdcType: AppSdc
    sdrId: null
    socketAllocationFailure: null
    softwareVersionInfo: R3_6.0.0
    systemId: 4a54a8ba6df0690f
    versionInfo: R3_6.0.0
  type: dict