使用 API 管理数据中心内的存储对象
建议更改
PDF
REST API 下的 `datacenter`类别使您能够管理数据中心中的存储对象，例如集群、节点、聚合、存储虚拟机、卷、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 使您能够过滤特定存储对象（例如集群、卷或存储 VM）的结果。 |
数据中心存储对象的 API
| HTTP 动词 | 路径 | 描述 |
|---|---|---|
|
|
您可以使用此方法查看整个数据中心的ONTAP集群的详细信息。 API 返回信息，例如集群的 IPv4 或 IPv6 地址、有关节点的信息（例如节点健康状况、性能容量和高可用性 (HA) 对），并指示集群是否为全 SAN 阵列。 |
|
|
返回数据中心集群上安装的许可证的详细信息。您可以根据所需条件过滤结果。返回许可证密钥、集群密钥、到期日期和许可证范围等信息。您可以输入许可证密钥来检索特定许可证的详细信息。 |
|
|
您可以通过此方法查看数据中心内节点的详细信息。您可以查看有关集群、节点健康状况、性能容量和节点的高可用性 (HA) 对的信息。 |
|
|
您可以通过此方式查看数据中心内CIFS共享的详细信息。除了集群、SVM 和卷详细信息之外，还会返回有关访问控制列表 (ACL) 的信息。 |
|
|
您可以使用此方法查看受支持的 NFS 服务的导出策略的详细信息。 您可以查询集群或存储虚拟机的导出策略，并重复使用导出策略密钥来配置 NFS 文件共享。有关在工作负载上分配和重用导出策略的更多信息，请参阅“配置 CIFS 和 NFS 文件共享”。 |
|
|
您可以使用此方法查看数据中心中的聚合集合或特定聚合，以便在其上配置工作负载或进行监控。返回集群和节点详细信息、使用的性能容量、可用和已用空间以及存储效率等信息。 |
|
|
可以通过此方法查看整个数据中心的LUN集合。您可以查看有关 LUN 的信息，例如集群和 SVM 详细信息、QoS 策略和 igroup。 |
|
|
您可以使用此方法查看适用于数据中心内存储对象的所有QoS策略的详细信息。返回集群和 SVM 详细信息、固定或自适应策略详细信息以及适用于该策略的对象数量等信息。 |
|
|
您可以使用此方法查看数据中心内所有FlexVol卷或FlexGroup卷的 qtree 详细信息。返回集群和 SVM 详细信息、 FlexVol volume和导出策略等信息。 |
|
|
您可以使用此方法查看数据中心中的卷集合。返回有关卷的信息，例如 SVM 和集群详细信息、QoS 和导出策略，以及卷的类型是读写、数据保护还是负载共享。 对于FlexVol和FlexClone卷，您可以查看有关相应聚合的信息。对于FlexGroup卷，查询返回组成聚合的列表。 |
|
|
您可以分配授权访问特定 LUN 目标的启动器组 (igroup)。如果存在现有的 igroup，您可以分配它。您还可以创建 igroup 并将其分配给 LUN。 您可以分别使用这些方法来查询、创建、删除和修改 igroup。 注意事项：
|
|
|
您可以使用这些方法来查看、创建、删除和修改存储虚拟机（存储 VM）。
|
|
|
注意事项： |
如果您在环境中启用了基于 SLO 的工作负载配置，则在创建存储虚拟机时，请确保它支持配置 LUN 及其文件共享所需的所有协议，例如 CIFS 或 SMB、NFS、FCP 和 iSCSI。如果存储虚拟机不支持所需的服务，则配置工作流程可能会失败。建议在存储虚拟机上也启用相应类型工作负载的服务。
如果您已在环境中启用基于 SLO 的工作负载配置，则无法删除已配置存储工作负载的存储虚拟机。当您删除已配置 CIFS 或 SMB 服务器的存储虚拟机时，此 API 还会删除 CIFS 或 SMB 服务器以及本地 Active Directory 配置。但是，CIFS 或 SMB 服务器名称仍会保留在 Active Directory 配置中，您必须将其从 Active Directory 服务器中手动删除。
数据中心网络元素的 API
数据中心类别中的以下 API 检索有关您环境中的端口和网络接口的信息，特别是 FC 端口、FC 接口、以太网端口和 IP 接口。
| HTTP 动词 | 路径 | 描述 |
|---|---|---|
|
|
检索有关数据中心环境中所有以太网端口的信息。使用端口键作为输入参数，您可以查看该特定端口的信息。检索信息，例如集群详细信息、广播域、端口详细信息（例如状态、速度和类型）以及端口是否启用。 |
|
|
您可以使用此方法查看数据中心环境中 FC 接口的详细信息。使用接口键作为输入参数，您可以查看该特定接口的信息。检索集群详细信息、主节点详细信息和主端口详细信息等信息。 |
|
|
检索有关数据中心环境中节点中使用的所有 FC 端口的信息。使用端口键作为输入参数，您可以查看该特定端口的信息。检索集群详细信息、端口描述、支持的协议和端口状态等信息。 |
|
|
您可以使用此方法查看数据中心环境中 IP 接口的详细信息。使用接口键作为输入参数，您可以查看该特定接口的信息。检索集群详细信息、IP 空间详细信息、主节点详细信息、是否启用故障转移等信息。 |