支持的 Unified Manager CLI 命令
存储管理员可以使用 CLI 命令对存储对象（例如，集群、聚合、卷、Qtree 和 LUN）执行查询。可以使用 CLI 命令查询 Unified Manager 内部数据库和 ONTAP 数据库。还可以在脚本中使用 CLI 命令，这些脚本在操作开始或结束时执行，或者在触发警报时执行。
必须在所有命令之前加上 um cli login 命令以及用于身份认证的有效用户名和密码。
| CLI 命令 | 描述 | 输出 |
|---|---|---|
| um cli login -u <username> [-p <password>] | 登录 CLI。出于安全考虑，应该在“-u”选项后面仅输入用户名。以这种方式使用时，将提示输入密码，并且不会在历史记录或过程表中捕获该密码。 会话自登录时间起三个小时后到期，此后用户必须再次登录。 | 显示相应的消息。 |
| um cli logout | 注销 CLI。 | 显示相应的消息。 |
| um help | 显示所有第一级子命令。 | 显示所有第一级子命令。 |
| um run cmd [ -t <timeout> ] <cluster> <command> | 在一个或多个主机上运行命令的最简单方法。主要用于警报脚本以在 ONTAP 上获取或执行操作。可选的 timeout 参数用于设置该命令在客户端上完成的最大时间限制（以秒为单位）。默认值为 0（永远等待）。 | 与从 ONTAP 收到一样。 |
| um run query <sql command> | 执行 SQL 查询。仅允许从数据库读取的查询。不支持任何更新、插入或删除操作。 | 结果以表格形式显示。如果返回一个空集，或者有任何语法错误或错误请求，则将显示相应的错误消息。 |
| um datasource add -u <username> -P <password> [ -t <protocol> ] [ -p <port> ] <hostname-or-ip> | 将数据源添加到受管存储系统列表中。数据源描述如何与存储系统建立连接。添加数据源时，必须指定选项 -u（用户名）和 -P（密码）。选项 -t（协议）指定用于与集群通信的协议（http 或 https）。如果未指定协议，则将尝试使用这两种协议。选项 -p（端口）指定用于与集群通信的端口。如果未指定端口，则将尝试使用相应协议的默认值。该命令只能由存储管理员执行。 | 提示用户接受证书并打印相应的消息。 |
| um datasource list [ <datasource-id>] | 显示受管存储系统的数据源。 | 以表格格式显示以下值：ID Address Port, Protocol Acquisition Status, Analysis Status, Communication status, Acquisition Message, and Analysis Message。 |
| um datasource modify [ -h <hostname-or-ip> ] [ -u <username> ] [ -P <password> ] [ -t <protocol> ] [ -p <port> ] <datasource-id> | 修改一个或多个数据源选项。只能由存储管理员执行。 | 显示相应的消息。 |
| um datasource remove <datasource-id> | 从 Unified Manager 删除数据源（集群）。 | 显示相应的消息。 |
| um option list [ <option> .. ] | 列出您可以使用 set 命令配置的所有选项。 | 以表格格式显示以下值：Name, Value, Default Value, and Requires Restart. |
| um option set <option-name>=<option-value> [ <option-name>=<option-value> ... ] | 设置一个或多个选项。该命令只能由存储管理员执行。 | 显示相应的消息。 |
| um version | 显示 Unified Manager 软件版本。 | Version ("9.6") |
| um lun list [-q] [ -ObjectType <object-id>] | 按指定对象筛选后列出 LUN。-q 由所有命令用于不显示标头。ObjectType 可以是 lun、qtree、cluster、volume、quota 或 svm。 例如：um lun list -cluster 1 在此示例中，“-cluster”是 objectType，而“1”是 objectId。该命令列出标识为 1 的集群中的所有 LUN。 | 以表格格式显示以下值：ID and LUN path。 |
| um svm list [-q] [ -ObjectType <object-id>] | 按指定对象筛选后列出存储虚拟机。ObjectType 可以是 lun、qtree、cluster、volume、quota 或 svm。 例如：um svm list -cluster 1 在此示例中，“-cluster”是 objectType，而“1”是 objectId。该命令列出标识为 1 的集群中的所有存储虚拟机。 | 以表格格式显示以下值：Name and Cluster ID。 |
| um qtree list [-q] [ -ObjectType <object-id>] | 按指定对象筛选后列出 Qtree。-q 由所有命令用于不显示标头。ObjectType 可以是 lun、qtree、cluster、volume、quota 或 svm。 例如：um qtree list -cluster 1 在此示例中，“-cluster”是 objectType，而“1”是 objectId。该命令列出标识为 1 的集群中的所有 Qtree。 | 以表格格式显示以下值：Qtree ID and Qtree Name。 |
| um disk list [-q] [-ObjectType <object-id>] | 按指定对象筛选后列出磁盘。ObjectType 可以是 disk、aggr、node 或 cluster。 例如：um disk list -cluster 1 在此示例中，“-cluster”是 objectType，而“1”是 objectId。该命令列出标识为 1 的集群中的所有磁盘。 | 以表格格式显示以下值：ObjectType and object-id. |
| um cluster list [-q] [-ObjectType <object-id>] | 按指定对象筛选后列出集群。ObjectType 可以是 disk、aggr、node、cluster、lun、qtree、volume、quota 或 svm。 例如： um cluster list -aggr 1 在此示例中，“-aggr”是 objectType，而“1”是 objectId。该命令列出标识为 1 的聚合所属的集群。 | 以表格格式显示以下值：Name, Full Name, Serial Number, Datasource Id, Last Refresh Time, and Resource Key. |
| um cluster node list [-q] [-ObjectType <object-id>] | 按指定对象筛选后列出集群节点。ObjectType 可以是 disk、aggr、node 或 cluster。 例如：um cluster node list -cluster 1 在此示例中，“-cluster”是 objectType，而“1”是 objectId。该命令列出标识为 1 的集群中的所有节点。 | 以表格格式显示以下值：Name and Cluster ID. |
| um volume list [-q] [-ObjectType <object-id>] | 按指定对象筛选后列出卷。ObjectType 可以是 lun、qtree、cluster、volume、quota、svm 或 aggregate。 例如：um volume list -cluster 1 在此示例中，“-cluster”是 objectType，而“1”是 objectId。该命令列出标识为 1 的集群中的所有卷。 | 以表格格式显示以下值：Volume ID and Volume Name. |
| um quota user list [-q] [-ObjectType <object-id>] | 按指定对象筛选后列出配额用户。ObjectType 可以是 qtree、cluster、volume、quota 或 svm。 例如：um quota user list -cluster 1 在此示例中，“-cluster”是 objectType，而“1”是 objectId。该命令列出标识为 1 的集群中的所有配额用户。 | 以表格格式显示以下值：ID, Name, SID and Email. |
| um aggr list [-q] [-ObjectType <object-id>] | 按指定对象筛选后列出聚合。ObjectType 可以是 disk、aggr、node、cluster 或 volume。 例如：um aggr list -cluster 1 在此示例中，“-cluster”是 objectType，而“1”是 objectId。该命令列出标识为 1 的集群中的所有聚合。 | 以表格格式显示以下值：Aggr ID, and Aggr Name. |
| um event ack <event-ids> | 确认一个或多个事件。 | 显示相应的消息。 |
| um event resolve <event-ids> | 解决一个或多个事件。 | 显示相应的消息。 |
| um event assign -u <username> <event-id> | 将事件分配给用户。 | 显示相应的消息。 |
| um event list [ -s <source> ] [ -S <event-state-filter-list>.. ] [ <event-id> .. ] | 列出系统或用户生成的事件。根据源、状态和标识筛选事件。 | 以表格格式显示以下值：Source, Source type, Name, Severity, State, User and Timestamp. |
| um backup restore -f <backup_file_path_and_name> | 使用 .7z 文件恢复 MySQL 数据库备份。 | 显示相应的消息。 |