dellemc.powerscale.dellemc_powerscale_synciqrules (1.4.0) — module

Manage SyncIQ performance rules on PowerScale

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

Authors: Spandita Panigrahi (@panigs7) <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

Managing SyncIQ performance rules on PowerScale includes create a SyncIQ performance rule, modify a SyncIQ performance rule, get details of a SyncIQ performance rule, delete a SyncIQ performance rule


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
  - name: Create SyncIQ performance rule
    dellemc_powerscale_synciqrules:
      onefs_host: "{{onefs_host}}"
      verify_ssl: "{{verify_ssl}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      description: "Create a rule"
      enabled: True
      schedule:
        begin: "00:00"
        end: "13:30"
        days_of_week:
            - "monday"
            - "tuesday"
            - "sunday"
      rule_type: "cpu"
      limit: "80"
      state: "present"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
  - name: Modify SyncIQ performance rule
    dellemc_powerscale_synciqpolicy:
      onefs_host: "{{onefs_host}}"
      verify_ssl: "{{verify_ssl}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      sync_rule_id: "cpu-0"
      limit: "85"
      description: "Modify the performance rule"
      state: "present"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
  - name: Get SyncIQ performance rule details
    dellemc_powerscale_synciqpolicy:
      onefs_host: "{{onefs_host}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      verify_ssl: "{{verify_ssl}}"
      sync_rule_id: "cpu-0"
      state: "present"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
  - name: Delete SyncIQ performance rule
    dellemc_powerscale_synciqpolicy:
      onefs_host: "{{onefs_host}}"
      api_user: "{{api_user}}"
      api_password: "{{api_password}}"
      verify_ssl: "{{verify_ssl}}"
      sync_rule_id: "cpu-0"
      enabled: True
      schedule:
        begin: "00:00"
        end: "13:30"
        days_of_week:
            - "monday"
            - "tuesday"
            - "sunday"
      rule_type: "bandwidth"
      limit: "85"
      state: "absent"

Inputs

    
limit:
    description:
    - It tells the amount the specified system resource type is limited by this rule.
    - Units are kb/s for bandwidth, files/s for file-count, processing percentage used
      for cpu, or percentage of maximum available workers.
    - This is a mandatory parameter while creating/deleting a performance rule.
    type: int

state:
    choices:
    - absent
    - present
    description:
    - The state option is used to determine whether the performance rule exists or not.
    required: true
    type: str

enabled:
    description:
    - Indicates whether the performance rule is currently in effect during its specified
      interval
    - This mandatory while creating/deleting a performance rule.
    type: bool

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

schedule:
    description:
    - A schedule defining when during a week this performance rule is in effect.
    - It is mandatory to enter schedule while creating/deleting a performance rule.
    suboptions:
      begin:
        description:
        - Start time for this schedule, during its specified days.
        - It is of the format hh:mm (24 hour format).
        type: str
      days_of_week:
        choices:
        - monday
        - tuesday
        - wednesday
        - thursday
        - friday
        - saturday
        - sunday
        description:
        - The days in a week when the performance rule is effective.
        elements: str
        type: list
      end:
        description:
        - End time for this schedule, during its specified days.
        - It is of the format hh:mm (24 hour format).
        type: str
    type: dict

rule_type:
    choices:
    - bandwidth
    - file_count
    - cpu
    - worker
    description:
    - The type of system resource this rule limits.
    - This is mandatory parameter while creating/deleting a performance rule
    - This cannot be modified.
    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:
    - User entered description of the performance rule.
    type: str

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

sync_rule_id:
    description:
    - This is an auto generated ID at the time of creation of SyncIQ performance rule.
    - For get/modify/delete operations sync_rule_id is required.
    - The ID of a performance rule is not absolute to a particular existing rule configuration.
      The IDs are auto-sequenced during creation/deletion of a performance rule.
    type: str

Outputs

changed:
  description: Whether or not the resource has changed
  returned: always
  type: bool
sync_rule_details:
  contains:
    description:
      description: Description of the performance rule.
      type: str
    enabled:
      description: Indicates whether performance rule is enabled
      type: bool
    id:
      description: ID of the performance rule.
      type: str
    limit:
      description: Amount the specified system resource type is limited by this rule
      type: int
    schedule:
      description: Duration when performance rule is effective
      type: str
    type:
      description: Type of performance rule
      type: str
  description: Details of the SyncIQ performance rule
  returned: When SyncIQ performance rule exists
  type: complex