Skip to main content
Active IQ Unified Manager 9.7
本产品推出了新版本。
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

使用网关 API 对 ONTAP 卷进行故障排除

贡献者

网关 API 充当一个网关,可调用 ONTAP API 来查询有关 ONTAP 存储对象的信息,并采取补救措施来解决报告的问题。

此工作流将采用一个示例用例,其中,当 ONTAP 卷接近其容量时,会引发事件。此工作流还演示了如何通过调用 Active IQ Unified Manager 和 ONTAP REST API 的组合来解决此问题描述。

备注

在运行工作流步骤之前,请确保满足以下条件:

  • 您了解网关 API 及其使用方式。有关信息,请参见 "`网关 API` " 一节。

  • 您了解 ONTAP REST API 的使用情况。有关使用ONTAP REST API的详细信息、请参见 "ONTAP REST API 自动化"

  • 您是应用程序管理员。

  • ONTAP 9.5 或更高版本支持要运行 REST API 操作的集群,并通过 HTTPS 将此集群添加到 Unified Manager 中。

下图说明了问题描述卷容量使用 ONTAP 故障排除工作流中的每个步骤。

API 网关 ONTAP 工作流

此工作流涵盖了 Unified Manager 和 ONTAP REST API 的调用点。

  1. 记下通知卷容量利用率的事件中的卷名称。

  2. 使用卷名称作为中的值 name 参数、请运行以下Unified Manager API来查询卷。

    类别 HTTP 动词 路径

    数据中心

    获取

    /datacenter/storage/volumes

  3. 从输出中检索集群 UUID 和卷 UUID 。

  4. 在 Unified Manager Web UI 上,导航到 * 常规 * > * 功能设置 * > * API 网关 * 以验证是否已启用 API 网关功能。除非已启用、否则将显示下的API gateway 类别不可用于调用。如果此功能已禁用,请启用它。

  5. 使用集群UUID运行ONTAP API /storage/volumes/{uuid} 通过API网关。当将卷 UUID 作为 API 参数传递时,查询将返回卷详细信息。

    要通过 API 网关运行 ONTAP API , Unified Manager 凭据会在内部传递以进行身份验证,您无需为单个集群访问运行额外的身份验证步骤。

    类别 HTTP 动词 路径
     Unified Manager: gateway
    ONTAP 存储

    获取

    网关API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}

    备注

    在中 /gateways/{uuid}/{path}、的值 {uuid} 必须替换为要执行REST操作的集群UUID。 {path} 必须替换为ONTAP REST URL /storage/volumes/{uuid}

    附加的URL为: /gateways/{cluster_uuid}/storage/volumes/{volume_uuid}

    运行时 GET 操作时、生成的URL为: GEThttps://<hostname>/api/gateways/<cluster_UUID>/storage/volumes/{volume_uuid}

    • 示例 cURL 命令 *

    curl -X GET "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7"
    -H "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>"
  6. 从输出中,确定要采取的大小,使用情况和补救措施。在此工作流中,所采取的补救措施是调整卷大小。

  7. 使用集群 UUID 并通过 API 网关运行以下 ONTAP API 以调整卷大小。有关网关和 ONTAP API 的输入参数的信息,请参见第 5 步。

    类别 HTTP 动词 路径
     Unified Manager: gateway
    ONTAP 存储

    patch

    网关API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}

    备注

    除了集群UUID和卷UUID之外、您还必须为输入一个值 size 用于调整卷大小的参数。确保输入值 in bytes 。例如、如果要将卷大小从100 GB增加到120 GB、请输入参数值 size 查询结束时: -d {\"size\": 128849018880}"

    • 示例 cURL 命令 *

    curl -X PATCH "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7" -H
        "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>" -d
        {\"size\": 128849018880}"

    + JSON 输出将返回作业 UUID 。

  8. 使用作业 UUID 验证作业是否成功运行。使用集群 UUID 和作业 UUID 通过 API 网关运行以下 ONTAP API 。有关网关和 ONTAP API 的输入参数的信息,请参见第 5 步。

    类别

    HTTP 动词

    路径

     Unified Manager: gateway
    ONTAP 集群

    获取

    网关API: /gateways/{uuid}/{path}

    ONTAP API: /cluster/jobs/{uuid}

    返回的 HTTP 代码与 ONTAP REST API HTTP 状态代码相同。

  9. 运行以下 ONTAP API 以查询已调整大小的卷的详细信息。有关网关和 ONTAP API 的输入参数的信息,请参见第 5 步。

    类别

    HTTP 动词

    路径

     Unified Manager: gateway
    ONTAP 存储

    获取

    网关API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}

    输出显示的卷大小增加了 120 GB 。