ibm.storage_virtualize.ibm_svc_info 模块 – 此模块从 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_info。
ibm.storage_virtualize 1.0.0 中的新增功能
概要
收集指定的 IBM Storage Virtualize 系列系统实体的列表。这些包括节点、池、卷、主机、主机集群、FC 端口、iSCSI 端口、目标端口 FC、FC 一致性组、vdiskcopy、I/O 组、FC 映射、FC 连接性、NVMe 光纤网、阵列和系统的列表。
参数
参数 |
注释 |
|---|---|
Storage Virtualize 系统的 hostname 或管理 IP。 |
|
指定获取除 gather_subset 的选项之外的任何 Storage Virtualize 实体的信息。 必须指定确切的命令才能使用 command_list（即 lssystemcert、lstimezones、lsportset 等）。 输出将以这种方式存储（即 lssystemcert -> Systemcert，lstimezones -> Timezones 等）。 |
|
Storage Virtualize 系统的域。 当 hostname 用于参数 *clustername* 时有效。 |
|
指定（key=value）组合，有助于返回满足条件的对象的子集。 |
|
用于指定需要信息的 Storage Virtualize 实体的字符串变量列表。 all - 模块支持的所有 Storage Virtualize 实体的列表。 vol - 列出 VDisk 的信息。 pool - 列出 mdiskgrps 的信息。 node - 列出节点的信息。 iog - 列出 I/O 组的信息。 host - 列出主机的信息。 hostvdiskmap - 列出映射到主机“objectname”的所有 VDisk。 vdiskhostmap - 列出 VDisk“objectname”映射到的所有主机。 hc - 列出主机集群的信息。 fc - 列出 FC 连接性的信息。 fcport - 列出 FC 端口的信息。 targetportfc - 列出设置 FC 分区和显示主机 I/O 端口的当前故障转移状态所需的 WWPN 信息。 fcmap - 列出 FC 映射的信息。 rcrelationship - 列出远程复制关系的信息。 fcconsistgrp - 显示闪存复制一致性组的简洁列表或详细视图。 rcconsistgrp - 显示远程复制一致性组的简洁列表或详细视图。 iscsiport - 列出 iSCSI 端口的信息。 vdiskcopy - 列出卷复制的信息。 array - 列出阵列 MDisk 的信息。 system - 显示存储系统信息。 cloudaccount - 列出所有已配置的云帐户。 cloudaccountusage - 列出有关已配置的云存储帐户的使用信息。 cloudimportcandidate - 列出有关在云帐户中存储了数据的系统的信息。 ldapserver - 列出所有已配置的轻量级目录访问协议 (LDAP) 服务器的最新详细信息。 drive - 列出配置信息和驱动器重要产品数据 (VPD)。 user - 列出系统上创建的所有用户。 usergroup - 列出系统上创建的用户组。 ownershipgroup - 显示系统中可用的所有权组。 partnership - 列出与本地系统关联的所有集群系统（系统）。 replicationpolicy - 列出系统上的所有复制策略。 cloudbackup - 列出启用了云快照的卷和云帐户中具有云快照的卷。 cloudbackupgeneration - 列出指定卷上可用的任何卷快照。 *objectname* 是必需参数。 snapshotpolicy - 列出系统上的所有快照策略。 snapshotpolicyschedule - 列出系统上的所有快照计划。 volumegroup - 列出系统上的所有卷组。 volumepopulation - 列出有关克隆或精简克隆类型的卷的填充信息。 volumegrouppopulation - 列出有关克隆或精简克隆类型的卷组的信息。 volumegroupsnapshotpolicy - 列出与系统上卷组关联的快照策略属性。 volumesnapshot - 列出所有卷快照。 dnsserver - 列出系统中任何域名系统 (DNS) 服务器的信息。 systemcertificate - 列出有关当前系统安全套接字层 (SSL) 证书的信息。 truststore - 列出当前的证书存储。 sra - 用于检查安全远程协助状态和上次登录时间的命令。 syslogserver - 列出在集群系统上配置的 syslog 服务器。 emailserver - 列出在系统上配置的电子邮件服务器。 emailuser - 列出所有电子邮件收件人、单个电子邮件收件人或指定类型（本地或支持）的电子邮件收件人的电子邮件事件通知设置。 provisioningpolicy - 列出系统上可用的配置策略。 volumegroupsnapshot - 列出系统上可用的快照对象。 callhome - 显示发送到云中服务器的呼叫中心信息的状态。 ip - 列出当前配置的 IP 地址。 portset - 列出系统上当前配置的端口集。 safeguardedpolicy - 列出系统上可用的受保护策略。 mdisk - 显示系统可见的托管磁盘 (MDisk) 的简洁列表或详细视图。 safeguardedpolicyschedule - 显示与受保护策略关联的受保护备份计划。 eventlog - 显示系统事件日志的简洁视图 enclosurestats - 列出所有机箱统计信息的最近值（平均值）。 enclosurestatshistory - 列出所有机箱统计信息的历史值，包括功耗、华氏温度和摄氏温度。 driveclass - 列出系统中的所有驱动器类别 security - 显示当前系统安全套接字层 (SSL) 或传输层安全性 (TLS) 安全和密码规则设置 partition - 显示与存储相关的所有存储分区信息。 volumegroupreplication - 显示卷组的所有复制信息。 plugin - 显示已注册插件的信息。 quorum - 显示系统用于存储仲裁数据的所有仲裁设备。 enclosure - 显示机箱的摘要。 snmpserver - 显示系统上配置的 SNMP 服务器的简洁列表或详细视图 testldapserver - 测试轻量级目录访问协议 (LDAP) 服务器。 availablepatch - 显示与 SVC 版本兼容的补丁。 patch - 显示特定节点上的所有补丁列表。 systempatches - 显示系统所有节点上安装的补丁。 选择
|
|
调试日志文件的路径。 |
|
如果指定，则仅返回具有objectname的实例。 如果未指定，则返回所有实例。 如果指定了objectname：“all”，则显示 gather_subset 和 command_list 中指定的所有对象的所有实例的详细输出。 对于需要将 objectname 作为强制参数的实体，objectname：“all”将抛出错误。 |
|
Storage Virtualize 系统的 REST API 密码。 如果未使用token来验证用户，则需要username和password参数。 |
|
用于验证 Storage Virtualize 系统上用户的身份验证令牌。 要生成令牌，请使用 ibm_svc_auth 模块。 |
|
Storage Virtualize 系统的 REST API 用户名。 如果未使用token来验证用户，则需要username和password参数。 |
|
验证证书。 选择
|
注释
注意
此模块支持
check_mode。如果未指定gather_subset和command_list，则 ibm_svc_info 将列出有关默认对象的信息。
不包含lsroute和lsarraylba命令。
示例
- name: Get volume info
ibm.storage_virtualize.ibm_svc_info:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/ansible.log
gather_subset: vol
- name: Get volume info
ibm.storage_virtualize.ibm_svc_info:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/ansible.log
objectname: volumename
gather_subset: vol
- name: Get pool info
ibm.storage_virtualize.ibm_svc_info:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/ansible.log
gather_subset: pool
- name: Get population information about volumes and volumegroups of type clone or thinclone
ibm.storage_virtualize.ibm_svc_info:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/ansible.log
gather_subset: ['volumepopulation','volumegrouppopulation']
- name: Get all info related to volume 'Volume1'
ibm.storage_virtualize.ibm_svc_info:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/ansible.log
gather_subset: vol
objectname: Volume1
- name: Get detailed info of all volumes.
ibm.storage_virtualize.ibm_svc_info:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/ansible.log
gather_subset: vol
objectname: all
- name: Get detailed info for objects returned by lsvdiskcopy using command_list.
ibm.storage_virtualize.ibm_svc_info:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/ansible.log
command_list: lsvdiskcopy
objectname: all
- name: Get detailed info of multiple objects using gather_subset and command_list.
ibm.storage_virtualize.ibm_svc_info:
clustername: "{{clustername}}"
domain: "{{domain}}"
username: "{{username}}"
password: "{{password}}"
log_path: /tmp/ansible.log
gather_subset: [vol, host]
command_list: [lsvdiskcopy, lssite]
objectname: all
返回值
常见的返回值记录在此处，以下是此模块独有的字段
键 |
描述 |
|---|---|
当gather_subset=array或gather_subset=all时，将填充数据 列出阵列 MDisk 的信息 返回：成功 示例： |
|
当gather_subset=availablepatch或gather_subset=all时，将填充数据 显示用户系统上与 SVC 版本兼容的补丁。 返回：成功 示例： |
|
当gather_subset=callhome或gather_subset=all时，将填充数据 显示发送到云中服务器的呼叫回家的信息状态 返回：成功 示例： |
|
当gather_subset=cloudaccount或gather_subset=all时，将填充数据 列出所有配置的云帐户 返回：成功 示例： |
|
当gather_subset=cloudaccountusage或gather_subset=all时，将填充数据 列出有关配置的云存储帐户的使用信息 返回：成功 示例： |
|
当gather_subset=cloudbackup或gather_subset=all时，将填充数据 列出启用了云快照的卷以及云帐户中具有云快照的卷 返回：成功 示例： |
|
当gather_subset=cloudbackupgeneration时，将填充数据 列出指定卷上可用的任何卷快照 返回：成功 示例： |
|
当gather_subset=cloudimportcandidate或gather_subset=all时，将填充数据 列出有关云帐户中存储了数据的系统的信息 返回：成功 示例： |
|
当gather_subset=dnsserver或gather_subset=all时，将填充数据 列出系统中任何域名系统 (DNS) 服务器的信息 返回：成功 示例： |
|
当gather_subset=drive或gather_subset=all时，将填充数据 列出配置信息和驱动器重要产品数据 (VPD) 返回：成功 示例： |
|
当gather_subset=driveclass或gather_subset=all时，将填充数据 列出系统中的所有驱动器类别 返回：成功 示例： |
|
当gather_subset=emailserver或gather_subset=all时，将填充数据 列出系统上配置的电子邮件服务器 返回：成功 示例： |
|
当gather_subset=emailuser或gather_subset=all时，将填充数据 列出所有电子邮件收件人、单个电子邮件收件人或指定类型（本地或支持）的电子邮件收件人的电子邮件事件通知设置 返回：成功 示例： |
|
当gather_subset=enclosure或gather_subset=all时，将填充数据 显示机箱的摘要。 返回：成功 示例： |
|
当gather_subset=enclosurestats或gather_subset=all时，将填充数据 列出所有机箱统计信息的最近值（平均值）。 返回：成功 示例： |
|
当gather_subset=enclosurestatshistory或gather_subset=all时，将填充数据 列出所有机箱统计信息的历史值，包括功耗、华氏温度和摄氏温度。 返回：成功 示例： |
|
当gather_subset=eventlog或gather_subset=all时，将填充数据 列出有关系统事件日志的信息 返回：成功 示例： |
|
当gather_subset=fc或gather_subset=all时，将填充数据 列出 FC 连接的信息 返回：成功 示例： |
|
当gather_subset=fcconsistgrp或gather_subset=all时，将填充数据 显示闪存复制一致性组的简洁列表或详细视图 返回：成功 示例： |
|
当gather_subset=fcmap或gather_subset=all时，将填充数据 列出 FC 映射的信息 返回：成功 示例： |
|
当gather_subset=fcport或gather_subset=all时，将填充数据 列出 FC 端口的信息 返回：成功 示例： |
|
当gather_subset=host或gather_subset=all时，将填充数据 列出主机的信息 返回：成功 示例： |
|
当gather_subset=hc或gather_subset=all时，将填充数据 列出主机集群的信息 返回：成功 示例： |
|
当gather_subset=hostvdiskmap或gather_subset=all时，将填充数据 列出映射到主机“objectname”的所有 VDisk 返回：成功 示例： |
|
当gather_subset=iog或gather_subset=all时，将填充数据 列出 I/O 组的信息 返回：成功 示例： |
|
当gather_subset=ip或gather_subset=all时，将填充数据 列出当前配置的 IP 地址 返回：成功 示例： |
|
当gather_subset=iscsiport或gather_subset=all时，将填充数据 列出 iSCSI 端口的信息 返回：成功 示例： |
|
当gather_subset=ldapserver或gather_subset=all时，将填充数据 列出所有已配置的轻量级目录访问协议 (LDAP) 服务器的最新详细信息 返回：成功 示例： |
|
当gather_subset=mdisk或gather_subset=all时，将填充数据 显示系统可见的托管磁盘 (MDisk) 的简洁列表或详细视图 返回：成功 示例： |
|
当gather_subset=node或gather_subset=all时，将填充数据 列出节点的信息 返回：成功 示例： |
|
当gather_subset=ownershipgroup或gather_subset=all时，将填充数据 显示系统中可用的所有权组 返回：成功 示例： |
|
当gather_subset=partition或gather_subset=all时，将填充数据 显示所有存储分区 返回：成功 示例： |
|
当gather_subset=partnership或gather_subset=all时，将填充数据 列出与本地系统关联的所有集群系统（系统） 返回：成功 示例： |
|
当gather_subset=patch或gather_subset=all时，将填充数据 显示系统中特定节点上的所有补丁列表。 返回：成功 示例： |
|
当gather_subset=plugin或gather_subset=all时，将填充数据 显示所有已注册的插件 返回：成功 示例： |
|
当gather_subset=pool或gather_subset=all时，将填充数据 列出 mdiskgrps 的信息 返回：成功 示例： |
|
当gather_subset=portset或gather_subset=all时，将填充数据 列出系统上当前配置的端口集 返回：成功 示例： |
|
当gather_subset=provisioningpolicy或gather_subset=all时，将填充数据 列出系统上可用的配置策略 返回：成功 示例： |
|
当gather_subset=quorum或gather_subset=all时，将填充数据 列出系统用于存储仲裁数据的仲裁设备。 返回：成功 示例： |
|
当gather_subset=rcconsistgrp或gather_subset=all时，将填充数据 显示远程复制一致性组的简洁列表或详细视图 返回：成功 示例： |
|
当gather_subset=rcrelationship或gather_subset=all时，将填充数据 列出远程复制关系的信息 返回：成功 示例： |
|
当gather_subset=replicationpolicy或gather_subset=all时，将填充数据 列出系统上的所有复制策略 返回：成功 示例： |
|
当gather_subset=safeguardedpolicy或gather_subset=all时，将填充数据 列出系统上可用的受保护策略 返回：成功 示例： |
|
当gather_subset=safeguardedpolicyschedule或gather_subset=all时，将填充数据 显示与受保护策略关联的受保护备份计划 返回：成功 示例： |
|
当gather_subset=security或gather_subset=all时，将填充数据 显示系统的当前安全设置 返回：成功 示例： |
|
当gather_subset=snapshotpolicy或gather_subset=all时，将填充数据 列出系统上的所有快照策略 返回：成功 示例： |
|
当gather_subset=snapshotpolicyschedule或gather_subset=all时，将填充数据 列出系统上的所有快照计划 返回：成功 示例： |
|
当gather_subset=snmpserver或gather_subset=all时，将填充数据 显示系统上配置的SNMP服务器的简洁列表或详细视图 返回：成功 示例： |
|
当gather_subset=sra或gather_subset=all时，将填充数据 检查安全远程协助状态和上次登录时间的命令 返回：成功 示例： |
|
当gather_subset=syslogserver或gather_subset=all时，将填充数据 列出在集群系统上配置的syslog服务器 返回：成功 示例： |
|
当gather_subset=system或gather_subset=all时，将填充数据 显示存储系统信息 返回：成功 示例： |
|
当gather_subset=systemcertificate或gather_subset=all时，将填充数据 列出有关当前系统安全套接字层 (SSL) 证书的信息 返回：成功 示例： |
|
当gather_subset=systempatches或gather_subset=all时，将填充数据 显示安装在系统中所有节点上的补丁 返回：成功 示例： |
|
当gather_subset=targetportfc或gather_subset=all时，将填充数据 列出设置 FC 分区所需的 WWPN 信息，并显示主机 I/O 端口的当前故障转移状态 返回：成功 示例： |
|
当gather_subset=testldapserver时，将填充数据 测试轻量级目录访问协议 (LDAP) 服务器。 返回：成功 示例： |
|
当gather_subset=truststore或gather_subset=all时，将填充数据 列出当前的证书存储 返回：成功 示例： |
|
当gather_subset=user或gather_subset=all时，将填充数据 列出在系统上创建的所有用户 返回：成功 示例： |
|
当gather_subset=usergroup或gather_subset=all时，将填充数据 列出在系统上创建的用户组 返回：成功 示例： |
|
当gather_subset=vdiskcopy或gather_subset=all时，将填充数据 列出卷复制的信息 返回：成功 示例： |
|
当gather_subset=vdiskhostmap或gather_subset=all时，将填充数据 列出 VDisk “objectname” 映射到的所有主机 返回：成功 示例： |
|
当gather_subset=vol或gather_subset=all时，将填充数据 列出 VDisk 的信息 返回：成功 示例： |
|
当gather_subset=volumegroup或gather_subset=all时，将填充数据 列出系统上的所有卷组 返回：成功 示例： |
|
当gather_subset=volumegrouppopulation或gather_subset=all时，将填充数据 列出有关克隆或精简克隆类型卷组的信息，包括源和正在进行的还原 返回：成功 示例： |
|
当gather_subset=volumegroupreplication或gather_subset=all时，将填充数据 显示卷组的所有复制 返回：成功 示例： |
|
当gather_subset=volumegroupsnapshot或gather_subset=all时，将填充数据 列出基于卷组的系统上可用的快照对象 返回：成功 示例： |
|
当gather_subset=volumegroupsnapshotpolicy或gather_subset=all时，将填充数据 列出系统上的视图快照对象 返回：成功 示例： |
|
当gather_subset=volumepopulation或gather_subset=all时，将填充数据 列出有关克隆或精简克隆类型卷的信息 返回：成功 示例： |
|
当gather_subset=volumesnapshot或gather_subset=all时，将填充数据 列出所有卷快照 返回：成功 示例： |