ibm.ds8000.ds8000_host_port (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

Manage host ports for a DS8000 host.

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: Create and assign some host ports to the host
  ibm.ds8000.ds8000_host_port:
    hostname: "{{ ds8000_host }}"
    username: "{{ ds8000_username }}"
    password: "{{ ds8000_password }}"
    name: host_name_test
    state: present
    force: no
    host_port:
      - 10000000C9A1BAB2
      - 10000000C9A1BAB3

Scanned by Steampunk Spotter

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

- name: Assign some host ports to the host even though they are already assigned to another host
  ibm.ds8000.ds8000_host_port:
    hostname: "{{ ds8000_host }}"
    username: "{{ ds8000_username }}"
    password: "{{ ds8000_password }}"
    name: host_name_test
    state: present
    force: yes
    host_port: 10000000C9A1BAB2

Scanned by Steampunk Spotter

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

- name: Delete some host ports from the DS8000 storage
  ibm.ds8000.ds8000_host_port:
    hostname: "{{ ds8000_host }}"
    username: "{{ ds8000_username }}"
    password: "{{ ds8000_password }}"
    state: absent
    host_port: 10000000C9A1BAB2

Inputs

    
name:
    description:
    - The name of the DS8000 host to work with.
    - Required when I(state=present).
    type: str

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

force:
    default: false
    description:
    - Optional when I(state=present).
    - If C(yes), if a host port is assigned to another host, it will transfer it to the
      host specified.
    - If C(no), if a host port is assigned to another host, it will not transfer it to
      the host specified.
    type: bool

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Specify the state the DS8000 host port should be in.
    type: str

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

host_port:
    description:
    - List of host port WWPNs to assign to a specific host on the DS8000 storage system.
    elements: str
    required: true
    type: list

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