对象引用和访问

通过 ONTAP REST API 公开的资源实例或对象可以通过多种不同的方式进行引用和访问。

对象访问路径

在较高级别上、访问对象时有两种路径类型:

使用 UUID 访问对象

在创建每个对象时,都会为其分配唯一的标识符,在大多数情况下,该标识符为 128 位 UUID 。分配的 UUID 值是不可变的、在 ONTAP 内部用于访问和管理资源。因此、 UUID 通常提供了访问对象的最快、最稳定的方式。

对于许多资源类型、可以将 UUID 值作为 URL 中路径密钥的一部分提供以访问特定对象。例如,可以使用以下命令访问节点实例: /cluster/nodes/{uuid}

使用对象属性访问对象

除了 UUID 之外,还可以使用对象属性访问对象。在大多数情况下,使用name该属性非常方便。例如,您可以在 URL 字符串中使用以下查询参数按节点实例的名称访问该实例: /cluster/nodes?name=node_one.除了查询参数外、可以通过主对象中的属性访问异对象。

虽然可以使用 name 或其他属性来访问对象而不是 UUID ,但可能存在以下几个缺点:

特别是,如果满足以下一个或多个条件、则可能会导致性能下降:

集群与 SVM 环境

有几个 REST 端点同时支持集群和 SVM 。使用其中一个端点时,可以通过scope=[svm|cluster]该值指示 API 调用的上下文。支持双上下文的端点示例包括 IP 接口和安全角色。

注:范围值基于为每个 API 调用提供的属性具有默认值。

在对象集合上使用增补程序和删除

在资源实例上支持修补程序或删除的每个 REST 端点也支持在对象集合上使用相同的方法。唯一的要求是至少必须通过 URL 字符串中的查询参数提供一个字段。在集合上发布修补程序或删除时,这相当于在内部执行以下操作:

操作超时可通过return_timeout默认值 15 秒设置。如果在超时之前未完成,则响应将包含指向下一个对象的链接。必须使用下一个链接重新发出相同的 HTTP 方法才能继续操作。