跳到主要内容

DM 系列 Unified Manager 中的 API 版本

DM 系列 Unified Manager 中的 REST API URI 用于指定版本号。例如,/v2/datacenter/svm/svms/v2/datacenter/svm/svms 中的版本号 v2 指示特定发行版中使用的 API 版本。通过发回客户端可以处理的响应,版本号可以最大限度减小 API 更改对客户端软件的影响。

该版本号的数字部分相对于发行版而言是递增的。包含版本号的 URI 提供了一致的界面,有助于在以后的发行版中保持向后兼容性。还可以找到不包含版本的相同 API,例如 /datacenter/svm/svms,这表示不包含版本的基础 API。基础 API 始终是 API 的最新版本。

在 Swagger 界面的右上角,可以选择要使用的 API 版本。默认情况下会选择最高版本。建议使用 Unified Manager 实例中可用的特定 API 的最高版本(相对于增量整数)。

对于所有请求,必须显式请求要使用的 API 版本。指定版本号后,服务不会返回应用程序不打算处理的响应元素。在 REST 请求中,应当包含 version 参数。一些发行版最终将弃用 API 的早期版本。在此发行版中,API 的 v1 版本已弃用。