ibm.ds8000.ds8000_pool_info (1.1.0) — module

Install collection

Install with ansible-galaxy collection install ibm.ds8000:==1.1.0

Add to requirements.yml

  collections:
    - name: ibm.ds8000
      version: 1.1.0

Description

Return information pertaining to DS8000 pools.

If the optional parameters are not set, information on all pools on the DS8000 storage system will be returned.

Requirements

• pyds8k >= 1.5.0
• python >= 3.6

Usage examples

Scanned by Steampunk Spotter

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

- name: get pool id P0
  ibm.ds8000.ds8000_pool_info:
    hostname: "{{ ds8000_host }}"
    username: "{{ ds8000_username }}"
    password: "{{ ds8000_password }}"
    id: P0

Scanned by Steampunk Spotter

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

- name: get all the pools
  ibm.ds8000.ds8000_pool_info:
    hostname: "{{ ds8000_host }}"
    username: "{{ ds8000_username }}"
    password: "{{ ds8000_password }}"

Inputs

    
id:
    aliases:
    - pool
    description:
    - The pool id.
    type: str

port:
    default: 8452
    description:
    - The port number of the DS8000 storage system HMC.
    type: int

hostname:
    description:
    - The hostname or IP address of the DS8000 storage system HMC.
    required: true
    type: str

password:
    description:
    - The password for the DS8000 storage system I(username).
    required: true
    type: str

username:
    description:
    - The username for the DS8000 storage system.
    required: true
    type: str

validate_certs:
    default: true
    description:
    - Controls validation of SSL chain of trust.
    - Set to C(no) to allow connection when SSL certificates are not trusted.
    type: bool

Outputs

pools:
  contains:
    MTM:
      description: The pool device type and the machine type.
      sample: 2107-900
      type: str
    VOLSER:
      description:
      - The pool serial number.
      - A pool serial number is 6 bytes of data, displayed as 6 characters.
      sample: 0X5000
      type: str
    allocmethod:
      description: The extent allocation method.
      sample: managed
      type: str
    cap:
      description: The pool capacity.
      sample: 17592186044416
      type: int
    cap_gb:
      description: The pool capcity in GB.
      sample: 16384
      type: int
    cap_gib:
      description: The pool capacity in GiB.
      sample: 17592.2
      type: float
    capalloc:
      description: The allocated real capacity number.
      sample: 4624471818240
      type: int
    datatype:
      description: The pool data type.
      sample: FB 512T
      type: str
    easytier:
      description: The state of management by Easy Tier.
      sample: managed
      type: str
    id:
      description: The pool ID.
      sample: P0
      type: str
    lss:
      description: The lss ID the pool belongs to.
      sample: A0
      type: str
    name:
      description: The pool name.
      sample: ansible
      type: str
    pool:
      description: The pool ID the pool belongs to.
      sample: P0
      type: str
    real_cap:
      description: The real capacity used by the pool.
      sample: 4624471818240
      type: int
    state:
      description: The pool state.
      sample: normal
      type: str
    stgtype:
      description: The storage type of the pool.
      sample: fb
      type: str
    tieralloc:
      contains:
        allocated:
          description: The capacity allocated to the tier.
          sample: 4944866312192
          type: int
        tier:
          description: The tier class.
          sample: SSD
          type: str
      description: A list of dictionaries describing the tier allocation.
      elements: dict
      type: list
    tp:
      description: The thin provisioning method.
      sample: ese
      type: str
    virtual_cap:
      description: The virtual capacity allocated to the pool.
      sample: 17592186044416
      type: int
  description: A list of dictionaries describing the pools.
  elements: dict
  returned: success
  sample: "[\n      {\n          \"MTM\": \"2107-900\",\n          \"VOLSER\": \"\"\
    ,\n          \"allocmethod\": \"managed\",\n          \"cap\": \"17592186044416\"\
    ,\n          \"cap_gb\": \"16384\",\n          \"cap_gib\": \"17592.2\",\n   \
    \       \"capalloc\": \"4632323555328\",\n          \"datatype\": \"FB 512T\"\
    ,\n          \"easytier\": \"managed\",\n          \"id\": \"A000\",\n       \
    \   \"lss\": \"A0\",\n          \"name\": \"ansible\",\n          \"pool\": \"\
    P0\",\n          \"real_cap\": \"4632323555328\",\n          \"state\": \"normal\"\
    ,\n          \"stgtype\": \"fb\",\n          \"tieralloc\": [\n            {\n\
    \              \"allocated\": \"4549091786752\",\n              \"tier\": \"SSD\"\
    \n            },\n            {\n              \"allocated\": \"5234491392\",\n\
    \              \"tier\": \"\"\n            }\n          ],\n          \"tp\":\
    \ \"ese\",\n          \"virtual_cap\": \"17592186044416\"\n      }\n  ]\n"
  type: list