yadro.tatlin_uni.tatlin_sp_host module – Create and modify host

Note

This module is part of the yadro.tatlin_uni collection (version 1.0.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install yadro.tatlin_uni.

To use it in a playbook, specify: yadro.tatlin_uni.tatlin_sp_host.

New in version 1.0.0: of yadro.tatlin_uni

Synopsis

• This module is intended for creating new host or change specific parameters for existing host

• Supports check mode

Parameters

Parameter	Comments
auth string	The type of authentication Required if new host is creating and port_type=eth Forbidden if port_type=dc Forbidden to change Choices: none oneway mutual
connection dictionary / required	connection describes Tatlin Storage Processor (SP) connection configuration. Only session connection supported. Authorization is executed automatically with corresponding endpoint. ‘auth/login’ by default. Client receives x-auth-token and uses it for following requests.
base_url string / required	Tatlin REST API entrypoint.
password string	Tatlin user password.
timeout integer	Tatlin REST API request timeout. Default: 60
username string	Tatlin username to login.
validate_certs boolean	Responsible for SSL certificates validation. If set to False certificates won’t validated. Choices: no yes ← (default)
mutual_password string	The password of the user for iscsi connection to host Required if auth=mutual
mutual_username string	The name of the user for iscsi connection to host Required if auth=mutual
name string / required	Name of the host
password string	The password of the user for iscsi connection to Tatlin Required if auth=oneway or auth=mutual
port_type string	The port type of the host server Required if new host is creating Choices: eth fc
ports list / elements=string	The identifiers of the hosts` ports (wwpn or iqn)
tags list / elements=string	The tags of the host
username string	The name of the user for iscsi connection to Tatlin Required if auth=oneway or auth=mutual

Examples

---
- name: Set host
  yadro.tatlin_uni.tatlin_sp_host:
    connection: "{{ connection }}"
    name: newhost
    port_type: eth
    ports:
      - some_iqn1
      - some_iqn2
    tags:
      - tag1
      - tag2
    auth: mutual
    username: name1
    password: pass1
    mutual_username: name2
    mutual_password: name2

- name: Test host | Update tags
  yadro.tatlin_uni.tatlin_sp_host:
    connection: "{{ connection }}"
    name: newhost
    tags:
      - tag2
      - tag3

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Description
error string	Error details if raised Returned: on error
msg string	Operation status message Returned: always

Authors

• Sergey Kovalev (@kvlvs)

Collection links

Issue Tracker Repository (Sources)