对象引用和访问

对象访问路径

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

• Primary

  对象是 API 调用的主要或直接目标。

• 外部

  对象不是 API 调用的主要引用、而是从主对象链接到的。因此，它是一个外部或下游对象、并通过主对象中的字段引用。

使用 UUID 访问对象

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

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

使用对象属性访问对象

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

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

• 名称字段不是不可变的，可以更改。如果在访问对象之前更改了对象的名称、将返回错误的对象或对象访问错误将失败。
  注：在异对象上使用 POST 或修补方法或在主对象上使用 GET 方法时可能会发生此问题。
• ONTAP 必须将名称字段转换为相应的 UUID 。这是一种间接访问，可能会成为性能问题。

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

• 使用 GET 方法
• 可以访问大量对象集合
• 使用复杂或复杂的查询

集群与 SVM 环境

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

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

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

• 基于查询的 GET 可以检索集合
• 对集合中的每个对象执行一系列修补程序或删除调用

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