跳到主要内容

用于管理数据中心的 API

datacenter 类别下的 REST API 提供有关数据中心内的集群、节点、聚合、卷、LUN、文件共享、名称空间和其他元素的信息。这些 API 可用于查询、添加、删除或修改数据中心内的配置。

这些 API 中的大多数都是 GET 调用,为跨集群的聚合提供筛选、排序和分页支持。它们在运行时会从数据库返回数据。因此,新创建的对象需要先在下一个获取周期中发现,然后才会出现在响应中。

如果要查询特定对象的详细信息,需要输入该对象的 Unique 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 可以筛选特定存储对象(例如集群、卷或存储虚拟机)的结果。
HTTP 动词Path(路径)Description(描述)
GET

/datacenter/cluster/clusters

/datacenter/cluster/clusters/{key}

可以使用此方法查看整个数据中心的 ONTAP 集群的详细信息。

GET

/datacenter/cluster/nodes

/datacenter/cluster/nodes/{key}

可以使用此方法查看数据中心内的节点的详细信息。

GET

/datacenter/protocols/cifs/shares

/datacenter/protocols/cifs/shares/{key}

可以使用此方法查看数据中心内的 CIFS 共享的详细信息。

GET

/datacenter/protocols/nfs/export-policies

/datacenter/protocols/nfs/export-policies/{key}

可以使用此方法查看受支持的 NFS 服务的导出策略的详细信息。

可以查询集群或存储虚拟机的导出策略,然后重用导出策略键值来配置 NFS 文件共享。有关分配和重用关于工作负载的导出策略的更多信息,请参阅“配置 CIFS 和 NFS 文件共享”。

GET

/datacenter/storage/aggregates

/datacenter/storage/aggregates/{key}

可以使用此方法查看整个数据中心内的聚合集合,以便在这些聚合上配置工作负载或对聚合进行监控。

GET

/datacenter/storage/luns

/datacenter/storage/luns/{key}

可以使用此方法查看整个数据中心内的 LUN 集合。

GET

/datacenter/storage/qos/policies

/datacenter/storage/qos/policies/{key}

可以使用此方法查看数据中心内所有 QoS 策略的详细信息,并根据需要应用这些策略。

GET

/datacenter/storage/qtrees

/datacenter/storage/qtrees/{key}

可以使用此方法查看整个数据中心的 Qtree 详细信息。

GET

/datacenter/storage/volumes

/datacenter/storage/volumes/{key}

可以使用此方法查看数据中心内的卷集合。

GET

POST

DELETE

PATCH

/datacenter/protocols/san/igroups

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

可以分配授权访问特定 LUN 目标的发起方组(igroup)。如果当前已有 igroup,则可以直接分配它。也可以创建 igroup 并将其分配给 LUN。

可以使用这些方法分别查询、创建、删除和修改 igroup。

注意事项:

  • POST:在创建 igroup 时,可以指定要在其上分配访问权限的存储虚拟机。
  • DELETE:需要提供 igroup 键值作为输入参数才能删除特定的 igroup。如果已经将某个 igroup 分配给 LUN,则无法删除该 igroup。
  • PATCH:需要提供 igroup 键值作为输入参数才能修改特定的 igroup。此外,还必须输入要更新的属性及其值。

GET

POST

DELETE

PATCH

/datacenter/svm/svms

/datacenter/svm/svms/{key}

可以使用这些方法查看、创建、删除和修改存储虚拟机。

注意事项:

  • POST:必须输入要创建的存储虚拟机对象作为输入参数。可以创建一个自定义存储虚拟机,然后为其分配必需的属性。
    如果针对具体环境启用了基于 SLO 的工作负载配置,则在创建存储虚拟机时,请确保该存储虚拟机支持用于配置 LUN 和文件共享的所有必要协议,例如 SMB/CIFS、NFS、FCP 和 iSCSI。如果存储虚拟机不支持所需的服务,则配置工作流程可能会失败。建议在存储虚拟机上也启用适用于各种工作负载类型的服务。
  • DELETE:需要提供存储虚拟机键值才能删除特定的存储虚拟机。
    如果针对具体环境启用了基于 SLO 的工作负载配置,则无法删除已配置了存储工作负载的存储虚拟机。删除配置了 CIFS/SMB 服务器的存储虚拟机时,此 API 还会删除 CIFS/SMB 服务器以及本地 Active Directory 配置。但是,CIFS/SMB 服务器名称仍保留在 Active Directory 配置中,必须从 Active Directory 服务器中手动删除。
  • PATCH:需要提供存储虚拟机键值才能修改特定的存储虚拟机。还需要输入要更新的属性及其值。