入门
使用API管理数据中心中的存储对象
建议更改
PDF
通过 " d" 类别下的 REST API ，您可以管理数据中心中的存储对象，例如集群，节点，聚合， Storage VM ， 卷， LUN ，文件共享和命名空间。这些 API 可用于查询对象的配置，而其中一些 API 可用于执行添加，删除或修改这些对象的操作。
其中大多数 API 都是 GET 调用，可提供跨集群聚合以及筛选，排序和分页支持。运行这些 API 时，它们会从数据库返回数据。因此，下一个采集周期需要发现新创建的对象，以便显示在响应中。
如果要查询特定对象的详细信息，则需要输入该对象的唯一 ID 才能查看其详细信息。例如，有关存储对象的指标和分析信息，请参见 "查看性能指标"。
curl -X GET "https://<hostname>/api/datacenter/cluster/clusters/4c6bf721-2e3f-11e9-a3e2-00a0985badbb" -H "accept: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
|
Swagger API 界面上提供了 cURL 命令，示例，请求和 API 响应。您可以按 Swagger 上指示的特定参数筛选结果并对结果进行排序。通过这些 API ，您可以筛选集群，卷或 Storage VM 等特定存储对象的结果。 |
数据中心中存储对象的 API
| HTTP 动词 | 路径 | Description |
|---|---|---|
|
` 数据中心 / 集群 / 集群` ` 数据中心 / 集群 / 集群 // ｛ key ｝` |
您可以使用此方法查看整个数据中心的 ONTAP 集群的详细信息。API 将返回有关节点的信息，例如集群的 IPv4 或 IPv6 地址，节点运行状况，性能容量和高可用性（ HA ）对等信息，并指示集群是否全是 SAN 阵列。 |
|
` 数据中心 / 集群 / 许可 / 许可证 /datacenter/ 集群 / 许可 / 许可证 /\ ｛ key ｝` |
返回数据中心集群上安装的许可证的详细信息。您可以根据所需条件筛选结果。将返回许可证密钥，集群密钥，到期日期和许可证范围等信息。您可以输入许可证密钥以检索特定许可证的详细信息。 |
|
` 数据中心 / 集群 / 节点` ` 数据中心 / 集群 / 节点 // ｛ key ｝` |
您可以使用此方法查看数据中心中节点的详细信息。您可以查看有关节点的集群，节点运行状况，性能容量和高可用性（ HA ）对的信息。 |
|
` 数据中心 / 协议 /CIFS/shares` ` 数据中心 / 协议 /CIFS/shares/\ ｛ key ｝` |
您可以使用此方法查看数据中心中 CIFS 共享的详细信息。除了集群， SVM 和卷详细信息之外，还会返回有关访问控制列表（ ACL ）的信息。 |
|
` 数据中心 / 协议 /NFS/export-policies` ` /datacenter/protocols/nfs/export-policies/\ ｛ key ｝` |
您可以使用此方法查看受支持 NFS 服务的导出策略的详细信息。 您可以查询集群或 Storage VM 的导出策略，并重复使用导出策略密钥来配置 NFS 文件共享。有关在工作负载上分配和重复使用导出策略的详细信息，请参见 "`配置 CIFS 和 NFS 文件共享` " 。 |
|
` 数据中心 / 存储 / 聚合` ` 数据中心 / 存储 / 聚合 /\ ｛ key ｝` |
您可以使用此方法查看数据中心或特定聚合中的聚合集合，以便在这些聚合上配置工作负载或进行监控。将返回集群和节点详细信息，已用性能容量，可用和已用空间以及存储效率等信息。 |
|
` 数据中心 / 存储 /LUN` ` 数据中心 / 存储 /LUN/\ ｛ key ｝` |
您可以使用此方法查看整个数据中心中的 LUN 集合。您可以查看有关 LUN 的信息，例如集群和 SVM 详细信息， QoS 策略和 igroup 。 |
|
` 数据中心 / 存储 /QoS/Policies` ` 数据中心 / 存储 /QoS/Policies/\ ｛ key ｝` |
您可以使用此方法查看适用于数据中心中存储对象的所有 QoS 策略的详细信息。返回的信息包括集群和SVM详细信息、固定或自适应策略详细信息以及适用于该策略的对象数量。 |
|
` 数据中心 / 存储 /qtree` ` 数据中心 / 存储 /qtree/ ｛ key ｝` |
您可以使用此方法查看整个数据中心内所有 FlexVol 卷或 FlexGroup 卷的 qtree 详细信息。将返回集群和 SVM 详细信息， FlexVol 卷和导出策略等信息。 |
|
` 数据中心 / 存储 / 卷` ` 数据中心 / 存储 / 卷 / ｛ key ｝` |
您可以使用此方法查看数据中心中的卷集合。返回有关卷的信息，例如 SVM 和集群详细信息， QoS 和导出策略，卷的类型是读写，数据保护还是负载共享。 对于 FlexVol 和 FlexClone 卷，您可以查看有关相应聚合的信息。对于 FlexGroup 卷，查询将返回成分卷聚合的列表。 |
|
` 数据中心 / 协议 /SAN/igroup` ` 数据中心 / 协议 /SAN/igroup/ ｛ key ｝` |
您可以分配有权访问特定 LUN 目标的启动程序组（ igroup ）。如果存在现有 igroup ，您可以对其进行分配。您也可以创建 igroup 并将其分配给 LUN 。 您可以使用这些方法分别查询，创建，删除和修改 igroup 。 需要注意的事项：
|
|
` 数据中心 /SVM/SVM` ` 数据中心 /SVM/SVM/\ ｛ key ｝` |
您可以使用这些方法查看，创建，删除和修改 Storage Virtual Machine （ Storage VM ）。
|
|
|
需要注意的事项： |
如果您已在环境中启用基于 SLO 的工作负载配置，则在创建 Storage VM 时，请确保它支持在其上配置 LUN 和文件共享所需的所有协议，例如 CIFS 或 SMB ， NFS ， FCP ， 和 iSCSI 。如果 Storage VM 不支持所需的服务，则配置工作流可能会失败。建议同时在 Storage VM 上为相应类型的工作负载启用服务。
如果您已在环境中启用基于 SLO 的工作负载配置，则无法删除已配置存储工作负载的 Storage VM 。删除已配置 CIFS 或 SMB 服务器的 Storage VM 时，此 API 还会删除 CIFS 或 SMB 服务器以及本地 Active Directory 配置。但是， CIFS 或 SMB 服务器名称仍位于 Active Directory 配置中，您必须从 Active Directory 服务器手动删除此配置。
用于数据中心网络元素的 API
数据中心类别中的以下 API 可检索有关环境中的端口和网络接口的信息，尤其是 FC 端口， FC 接口，以太网端口和 IP 接口。
| HTTP 动词 | 路径 | Description |
|---|---|---|
|
` 数据中心 / 网络 / 以太网 / 端口` ` 数据中心 / 网络 / 以太网 / 端口 / ｛ key ｝` |
检索有关数据中心环境中所有以太网端口的信息。使用端口密钥作为输入参数，您可以查看该特定端口的信息。信息，例如集群详细信息，广播域，端口详细信息，例如状态，速度， 检索类型以及端口是否已启用。 |
|
` 数据中心 / 网络 /fc/ 接口` ` 数据中心 / 网络 /fc/ 接口 / ｛ key ｝` |
您可以使用此方法查看数据中心环境中 FC 接口的详细信息。使用接口密钥作为输入参数，您可以查看该特定接口的信息。系统将检索集群详细信息，主节点详细信息和主端口详细信息等信息。 |
|
` 数据中心 / 网络 /FC/端口` ` 数据中心 / 网络 /fc/ 端口 / ｛ key ｝` |
检索有关数据中心环境中节点中使用的所有 FC 端口的信息。使用端口密钥作为输入参数，您可以查看该特定端口的信息。系统将检索集群详细信息，端口问题描述，支持的协议以及端口状态等信息。 |
|
` 数据中心 / 网络 /IP/ 接口` ` 数据中心 / 网络 /IP/interfaces/｛ key ｝` |
您可以使用此方法查看数据中心环境中 IP 接口的详细信息。使用接口密钥作为输入参数，您可以查看该特定接口的信息。系统将检索集群详细信息， IP 空间详细信息，主节点详细信息以及是否已启用故障转移等信息。 |