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

使用 API 预配 LUN

PDF

您可以使用Active IQ Unified Manager提供的配置 API 在存储虚拟机 (SVM) 上配置 LUN。此配置工作流程详细说明了在创建 LUN 之前检索 SVM、性能服务级别和存储效率策略的密钥的步骤。

下图说明了 LUN 配置工作流程中的步骤。

创建 LUN
备注

此工作流程假定ONTAP集群已添加到 Unified Manager，并且已获取集群密钥。该工作流还假设已在集群上创建了 SVM。

  1. 获取要在其上创建 LUN 的 SVM 的 SVM 密钥，如_验证集群上的 SVM_ 工作流主题中所述。

  2. 通过运行以下 API 并从响应中检索密钥来获取性能服务级别的密钥。

    类别 HTTP 动词 路径

    存储提供商

    GET

    /storage-provider/performance-service-levels
    备注

    您可以通过设置 system_defined`输入参数 `true。从输出中获取要在 LUN 上应用的性能服务级别的密钥。

  3. 或者，通过运行以下 API 并从响应中检索密钥，获取要在 LUN 上应用的存储效率策略的存储效率策略密钥。

    类别 HTTP 动词 路径

    存储提供商

    GET

    /storage-provider/storage-efficiency-policies

  4. 确定是否已创建启动程序组 (igroup) 来授予对要创建的 LUN 目标的访问权限。

    类别 HTTP 动词 路径

    数据中心

    GET

    /datacenter/protocols/san/igroups /datacenter/protocols/san/igroups/{key}

    您必须输入参数值来指示 igroup 有权访问的 SVM。此外，如果您想查询特定的 igroup，请输入 igroup 名称（键）作为输入参数。

  5. 在输出中，如果您可以找到要授予访问权限的 igroup，请获取密钥。否则创建 igroup。

    类别 HTTP 动词 路径

    数据中心

    POST

    /datacenter/protocols/san/igroups

    您必须输入要创建的 igroup 的详细信息作为输入参数。这是一个同步调用，您可以在输出中验证 igroup 的创建。如果出现错误，则会显示一条消息，以便您排除故障并重新运行 API。

  6. 创建 LUN。

    类别 HTTP 动词 路径

    存储提供商

    POST

    /storage-provider/luns

    要创建 LUN，请确保已将检索到的值添加为强制输入参数。

    备注

    存储效率策略是创建 LUN 的可选参数。

    示例 cURL

    您必须输入要创建的 LUN 的所有详细信息作为输入参数。

    JSON 输出显示一个作业对象键，您可以使用它来验证您创建的 LUN。

  7. 使用查询作业中返回的作业对象键来验证 LUN 的创建：

    类别 HTTP 动词 路径

    管理服务器

    GET

    /management-server/jobs/{key}

    在响应的末尾，您会看到创建的 LUN 的密钥。

  8. 通过使用返回的密钥运行以下 API 来验证 LUN 的创建：

    类别 HTTP 动词 路径

    存储提供商

    GET

    /storage-provider/luns/{key}

    JSON 输出示例

    您可以看到 `/storage-provider/luns`内部调用每个函数所需的所有 API 并创建对象。例如，它调用 `/storage-provider/performance-service-levels/`用于在 LUN 上分配性能服务级别的 API。

    == LUN 创建或映射失败的故障排除步骤

完成此工作流程后，您可能仍会看到 LUN 创建失败。即使成功创建了 LUN，由于创建 LUN 的节点上 SAN LIF 或访问端点不可用，LUN 与 igroup 的映射也可能会失败。如果发生故障，您将看到以下消息：

The nodes <node_name> and <partner_node_name> have no LIFs configured with the iSCSI or FCP protocol for Vserver <server_name>. Use the access-endpoints API to create a LIF for the LUN.

请按照以下故障排除步骤来解决此故障。

  1. 在您尝试创建 LUN 的 SVM 上创建支持 ISCSI/FCP 协议的访问端点。

    类别 HTTP 动词 路径

    存储提供商

    POST

    /storage-provider/access-endpoints

    示例 cURL

    您必须输入要创建的访问端点的详细信息作为输入参数。

    备注

    确保在输入参数中已添加指示 LUN 主节点的地址和指示主节点的伙伴节点的 ha_address。当您运行此操作时，它会在主节点和伙伴节点上创建访问端点。

  2. 使用 JSON 输出中返回的作业对象键查询作业，以验证它是否已成功运行以在 SVM 上添加访问端点，以及是否已在 SVM 上启用 iSCSI/FCP 服务。

    类别 HTTP 动词 路径

    管理服务器

    GET

    /management-server/jobs/{key}

    JSON 输出示例

    在输出的最后，您可以看到创建的访问端点的密钥。在下面的输出中，“name”：“accessEndpointKey”值表示在 LUN 的主节点上创建的访问端点，其密钥为 9c964258-14ef-11ea-95e2-00a098e32c28。 “name”：“accessEndpointHAKey”值表示在主节点的伙伴节点上创建的访问端点，其密钥为9d347006-14ef-11ea-8760-00a098e3215f。

  3. 修改 LUN 以更新 igroup 映射。有关工作流程修改的更多信息，请参阅“修改存储工作负载”。

    类别 HTTP 动词 路径

    存储提供商

    修补

    /storage-provider/lun/{key}

    在输入中，指定要用来更新 LUN 映射的 igroup 键以及 LUN 键。

    示例 cURL

    JSON 输出显示一个 Job 对象键，您可以使用它来验证映射是否成功。

  4. 通过查询 LUN 键来验证 LUN 映射。

    类别 HTTP 动词 路径

    存储提供商

    GET

    /storage-provider/luns/{key}

    JSON 输出示例

    在输出中，您可以看到 LUN 已成功映射到最初配置的 igroup（键 d19ec2fa-fec7-11e8-b23d-00a098e32c28）。