ibm.storage_virtualize.ibm_svc_host 模块 – 此模块管理 IBM Storage Virtualize 系列系统上的主机

注意

此模块是 ibm.storage_virtualize 集合 (版本 2.5.0) 的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install ibm.storage_virtualize。

要在 playbook 中使用它，请指定：ibm.storage_virtualize.ibm_svc_host。

ibm.storage_virtualize 1.0.0 中的新增功能

概要 

用于管理 ‘mkhost’、‘chhost’ 和 ‘rmhost’ 主机命令的 Ansible 接口。

参数 

参数	注释
clustername 字符串 / 必需	Storage Virtualize 系统的hostname 或管理 IP。
domain 字符串	Storage Virtualize 系统的域。当hostname 用于参数clustername时有效。
draftpartition 字符串在 ibm.storage_virtualize 2.5.0 中添加	指定要分配给主机的草稿分区名称。当 state=present 时有效，用于修改主机。支持从 Storage Virtualize 系列系统 8.6.3.0 或更高版本。
fcwwpn 字符串	要添加到主机的启动器 WWPN 的列表。必须提供完整的 WWPN 列表。参数 fcwwpn 和 iscsiname 是互斥的。当 state=present 时为必需，用于创建或修改光纤通道 (FC) 主机。
hostcluster 字符串在 ibm.storage_virtualize 1.5.0 中添加	指定要将主机对象添加到的主机集群的名称。在将主机对象添加到主机集群之前，必须存在主机集群。参数 hostcluster 和 nohostcluster 是互斥的。当 state=present 时有效，用于创建或修改主机。
iogrp 字符串	指定主机可以从中访问卷的一组或多个输入/输出 (I/O) 组。一旦指定，此参数将无法修改。当 state=present 时有效，用于创建主机。
iscsiname 字符串	要添加到主机的启动器 IQN 的列表。 IQN 用逗号分隔。必须提供完整的 IQN 列表。参数 fcwwpn 和 iscsiname 是互斥的。当 state=present 时有效，用于创建主机。
log_path 字符串	调试日志文件的路径。
name 字符串 / 必需	为新主机对象指定名称或标签。
nodraftpartition 布尔值在 ibm.storage_virtualize 2.5.0 中添加	如果指定为 `True`，则从草稿分区中删除主机对象。参数 draftpartition 和 nodraftpartition 是互斥的。当 state=present 时有效，用于修改现有主机。支持从 Storage Virtualize 系列系统 8.6.3.0 或更高版本。选项 `false` `true`
nohostcluster 布尔值在 ibm.storage_virtualize 1.5.0 中添加	如果指定为 `True`，则从主机集群中删除主机对象。参数 hostcluster 和 nohostcluster 是互斥的。当 state=present 时有效，用于修改现有主机。选项 `false` `true`
nopartition 布尔值在 ibm.storage_virtualize 2.1.0 中添加	如果指定为 `True`，则从存储分区中删除主机对象。参数 partition 和 nopartition 是互斥的。当 state=present 时有效，用于修改现有主机。支持从 Storage Virtualize 系列系统 8.6.1.0 或更高版本。选项 `false` `true`
nqn 字符串在 ibm.storage_virtualize 1.12.0 中添加	要添加到主机的启动器 NQN 的列表。每个 NQN 用逗号分隔。必须提供完整的 NQN 列表。当 protocol=rdmanvme 或 tcpnvme 时为必需，用于创建。当 state=present 时有效，用于创建或修改主机。
old_name 字符串在 ibm.storage_virtualize 1.9.0 中添加	指定重命名时主机的旧名称。当 state=present 时有效，用于重命名现有主机。
partition 字符串在 ibm.storage_virtualize 2.1.0 中添加	指定要与主机关联的存储分区。当 state=present 时有效，用于创建或修改主机。支持从 Storage Virtualize 系列系统 8.6.1.0 或更高版本。
password 字符串	Storage Virtualize 系统的 REST API 密码。如果不使用 token 对用户进行身份验证，则需要参数 username 和 password。
portset 字符串在 ibm.storage_virtualize 1.12.0 中添加	指定要与主机关联的端口集。当 state=present 时有效，用于创建或修改主机。
protocol 字符串	指定主机用于与存储系统通信的协议。仅支持 ‘scsi’ 协议。当 state=present 时有效，用于创建主机。选项 `"scsi"` `"rdmanvme"` `"tcpnvme"` `"fcnvme"`
site 字符串	指定主机的站点名称。当 state=present 时有效，用于创建或修改主机。
state 字符串 / 必需	创建或更新 (`present`) 或删除 (`absent`) 主机。选项 `"absent"` `"present"`
token 字符串在 ibm.storage_virtualize 1.5.0 中添加	用于验证 Storage Virtualize 系统上的用户的身份验证令牌。要生成令牌，请使用 ibm.storage_virtualize.ibm_svc_auth 模块。
type 字符串	指定主机类型。当 state=present 时有效，用于创建或修改主机。
username 字符串	Storage Virtualize 系统的 REST API 用户名。如果不使用 token 对用户进行身份验证，则需要参数 username 和 password。
validate_certs 布尔值	验证证书。选项 `false` ← (默认) `true`

注意 

注意

此模块支持 check_mode。

示例 

- name: Define a new iSCSI host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host4test
    state: present
    iscsiname: iqn.1994-05.com.redhat:2e358e438b8a
    iogrp: 0:1:2:3
    protocol: scsi
    type: generic
    site: site-name
    portset: portset0
- name: Add a host to an existing host cluster
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host4test
    state: present
    hostcluster: hostcluster0
- name: Define a new FC host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host4test
    state: present
    fcwwpn: 100000109B570216:1000001AA0570266
    iogrp: 0:1:2:3
    protocol: scsi
    type: generic
    site: site-name
- name: Rename an existing host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{ clustername }}"
    domain: "{{ domain }}"
    username: "{{ username }}"
    password: "{{ password }}"
    old_name: "host4test"
    name: "new_host_name"
    state: "present"
- name: Create an iSCSI host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host_name
    iscsiname: iqn.1994-05.com.redhat:2e358e438b8a,iqn.localhost.hostid.7f000001
    state: present
- name: Create a tcpnvme host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host_name
    protocol: tcpnvme
    nqn: nqn.2014-08.org.nvmexpress:NVMf:uuid:644f51bf-8432-4f59-bb13-5ada20c06397
    state: present
- name: Delete a host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: new_host_name
    state: absent
- name: Add existing host to draft partition
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host_name
    state: prersent
    draftpartition: partition_name
- name: Remove a host from a draft partition
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host_name
    state: present
    nodraftpartition: True
- name: Create a fcnvme host
  ibm.storage_virtualize.ibm_svc_host:
    clustername: "{{clustername}}"
    domain: "{{domain}}"
    username: "{{username}}"
    password: "{{password}}"
    log_path: /tmp/playbook.debug
    name: host_name
    protocol: fcnvme
    nqn: nqn.2014-08.org.nvmexpress:b2071fa4-4356-410f-a4ae-7ebfab5b0e90
    portset: portset_name
    state: present

作者

Sreshtant Bohidar (@Sreshtant-Bohidar)
Rohit Kumar (@rohitk-github)
Sandip G. Rajbanshi (@Sandip-Rajbanshi)
Lavanya C R(@Lavanya-C-R1)