简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

基本操作特征

10/27/2023 贡献者

虽然 REST 建立了一组通用的技术和最佳实践，但每个 API 的详细信息可能因设计选择而异。在使用 ONTAP Select Deploy API 之前，您应了解 API 的详细信息和操作特征。

虚拟机管理程序主机与 ONTAP Select 节点

虚拟机管理程序 host_ 是托管 ONTAP Select 虚拟机的核心硬件平台。在虚拟机管理程序主机上部署 ONTAP Select 虚拟机并使其处于活动 ONTAP Select 状态时，该虚拟机将被视为 _vp 节点 _ 。在 Deploy REST API 版本 3 中，主机和节点对象是独立的。这样就可以建立一对多关系，其中一个或多个 ONTAP Select 节点可以在同一虚拟机管理程序主机上运行。

对象标识符

创建每个资源实例或对象时，系统会为其分配一个唯一标识符。这些标识符在 ONTAP Select Deploy 的特定实例中具有全局唯一性。发出创建新对象实例的API调用后、关联的ID值将返回到中的调用方 location HTTP响应的标题。在引用资源实例时，您可以提取此标识符并在后续调用中使用它。

对象标识符的内容和内部结构可以随时更改。仅当引用关联对象时，才应根据需要在适用的 API 调用上使用标识符。

请求标识符

每个成功的 API 请求都会分配一个唯一标识符。此标识符将在中返回 request-id 关联HTTP响应的标头。您可以使用请求标识符来统称单个特定 API 请求响应事务的活动。例如，您可以根据请求 ID 检索事务的所有事件消息。

同步和异步调用

服务器执行从客户端收到的 HTTP 请求的主要方式有两种：

同步
服务器立即执行请求、并使用状态代码200、201或204进行响应。
异步
服务器接受请求并使用状态代码202进行响应。这表示服务器已接受客户端请求并启动后台任务来完成此请求。最终成功或失败不会立即出现，必须通过其他 API 调用来确定。

确认已完成长时间运行的作业

通常、任何可能需要很长时间才能完成的操作都会使用异步处理
服务器上的后台任务。通过Deploy REST API、每个后台任务都由锚定
作业对象、用于跟踪任务并提供当前状态等信息。作业对象，
创建后台任务后、HTTP响应将返回其唯一标识符。

您可以直接查询作业对象以确定关联 API 调用的成功或失败。
有关追加信息，请参见 asynchronous processing using the Job objection 。

除了使用作业对象之外、还可以通过其他方法确定的成功或失败
请求，包括：

事件消息
您可以使用随原始响应返回的请求ID检索与特定API调用关联的所有事件消息。事件消息通常包含成功或失败的指示，在调试错误情况时也很有用。
资源状态
有几个资源保持状态或状态值、您可以查询这些状态或值来间接确定请求的成功或失败。

安全性

Deploy API 使用以下安全技术：

传输层安全性
通过网络在Deploy服务器和客户端之间发送的所有流量都会通过TLS进行加密。不支持在未加密的通道上使用 HTTP 协议。支持 TLS 1.2 版。
HTTP身份验证
基本身份验证用于每个API事务。每个请求都会添加一个 HTTP 标头，其中包含 base64 字符串中的用户名和密码。