通过 ONTAP REST API 公开的资源实例或对象可以通过多种不同的方式进行引用和访问。
在较高级别上、访问对象时有两种路径类型:
对象是 API 调用的主要或直接目标。
对象不是 API 调用的主要引用、而是从主对象链接到的。因此,它是一个外部或下游对象、并通过主对象中的字段引用。
在创建每个对象时,都会为其分配唯一的标识符,在大多数情况下,该标识符为 128 位 UUID 。分配的 UUID 值是不可变的、在 ONTAP 内部用于访问和管理资源。因此、 UUID 通常提供了访问对象的最快、最稳定的方式。
对于许多资源类型、可以将 UUID 值作为 URL 中路径密钥的一部分提供以访问特定对象。例如,可以使用以下命令访问节点实例: /cluster/nodes/{uuid}
除了 UUID 之外,还可以使用对象属性访问对象。在大多数情况下,使用name该属性非常方便。例如,您可以在 URL 字符串中使用以下查询参数按节点实例的名称访问该实例: /cluster/nodes?name=node_one.除了查询参数外、可以通过主对象中的属性访问异对象。
虽然可以使用 name 或其他属性来访问对象而不是 UUID ,但可能存在以下几个缺点:
特别是,如果满足以下一个或多个条件、则可能会导致性能下降:
有几个 REST 端点同时支持集群和 SVM 。使用其中一个端点时,可以通过scope=[svm|cluster]该值指示 API 调用的上下文。支持双上下文的端点示例包括 IP 接口和安全角色。
在资源实例上支持修补程序或删除的每个 REST 端点也支持在对象集合上使用相同的方法。唯一的要求是至少必须通过 URL 字符串中的查询参数提供一个字段。在集合上发布修补程序或删除时,这相当于在内部执行以下操作:
操作超时可通过return_timeout默认值 15 秒设置。如果在超时之前未完成,则响应将包含指向下一个对象的链接。必须使用下一个链接重新发出相同的 HTTP 方法才能继续操作。