ansible.builtin.purefa_host (v2.7.16) — module

Install Ansible via pip

Install with pip install ansible==2.7.16

Description

Create, delete or modify hosts on Pure Storage FlashArrays.

Requirements

• python >= 2.7
• purestorage

Usage examples

Scanned by Steampunk Spotter

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

- name: Create new AIX host
  purefa_host:
    host: foo
    personaility: aix
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Scanned by Steampunk Spotter

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

- name: Delete host
  purefa_host:
    host: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

Scanned by Steampunk Spotter

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

- name: Make host bar with wwn ports
  purefa_host:
    host: bar
    protocol: fc
    wwns:
    - 00:00:00:00:00:00:00
    - 11:11:11:11:11:11:11
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Scanned by Steampunk Spotter

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

- name: Make host bar with iSCSI ports
  purefa_host:
    host: bar
    protocol: iscsi
    iqn:
    - iqn.1994-05.com.redhat:7d366003913
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Scanned by Steampunk Spotter

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

- name: Make mixed protocol host
  purefa_host:
    host: bar
    protocol: mixed
    iqn:
    - iqn.1994-05.com.redhat:7d366003914
    wwns:
    - 00:00:00:00:00:00:01
    - 11:11:11:11:11:11:12
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Scanned by Steampunk Spotter

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

- name: Map host foo to volume bar
  purefa_host:
    host: foo
    volume: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Inputs

    
iqn:
    description:
    - List of IQNs of the host if protocol is iscsi or mixed.

host:
    description:
    - The name of the host.
    required: true

wwns:
    description:
    - List of wwns of the host if protocol is fc or mixed.

state:
    choices:
    - absent
    - present
    default: present
    description:
    - Define whether the host should exist or not.
    - When removing host all connected volumes will be disconnected.

fa_url:
    description:
    - FlashArray management IPv4 address or Hostname.
    required: true
    type: str

volume:
    description:
    - Volume name to map to the host.

protocol:
    choices:
    - fc
    - iscsi
    - mixed
    default: iscsi
    description:
    - Defines the host connection protocol for volumes.

api_token:
    description:
    - FlashArray API token for admin privileged user.
    required: true
    type: str

personality:
    choices:
    - hpux
    - vms
    - aix
    - esxi
    - solaris
    - hitachi-vsp
    - oracle-vm-server
    - ''
    description:
    - Define which operating systen the host is. Recommend for ActiveCluster integration
    version_added: '2.7'
    version_added_collection: ansible.builtin