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

租户管理 API 版本控制

02/14/2024 贡献者

PDF

租户管理 API 使用版本控制来支持无中断升级。

例如、此请求URL指定API版本4。

https://hostname_or_ip_address/api/v4/authorize

如果所做的更改与旧版本不兼容、则API的主要版本会发生碰撞。如果对_are compender_与旧版本进行了更改、则API的次要版本会发生碰撞。兼容的更改包括添加新端点或新属性。

以下示例说明了如何根据所做更改的类型对 API 版本进行递增。

API 的更改类型	旧版本	新版本
与旧版本兼容	2.1	2.2
与旧版本不兼容	2.1	3.0

首次安装StorageGRID软件时、仅会启用最新版本的API。但是，在升级到 StorageGRID 的新功能版本时，您仍可以访问至少一个 StorageGRID 功能版本的旧版 API 。

您可以配置受支持的版本。请参见Swagger API文档中的*config*部分 "网格管理 API" 有关详细信息 …在更新所有API客户端以使用较新版本后、您应停用对较旧版本的支持。

已过时的请求将通过以下方式标记为已弃用：

响应标头为 "depression: true"
JSON 响应正文包含 "depressioned" ： true

NMS.log 中会添加一个已弃用的警告。例如：

Received call to deprecated v2 API at POST "/api/v2/authorize"

确定当前版本支持哪些 API 版本

使用 GET /versions 返回受支持API主要版本列表的API请求。此请求位于Swagger API文档的*config*部分。

GET https://{{IP-Address}}/api/versions
{
  "responseTime": "2023-06-27T22:13:50.750Z",
  "status": "success",
  "apiVersion": "4.0",
  "data": [
    2,
    3,
    4
  ]
}

指定请求的 API 版本

您可以使用path参数指定API版本 (/api/v4)或标题 (Api-Version: 4）。如果同时提供这两个值，则标头值将覆盖路径值。

curl https://[IP-Address]/api/v4/grid/accounts

curl -H "Api-Version: 4" https://[IP-Address]/api/grid/accounts

租户管理 API 版本控制

Creating your file...

确定当前版本支持哪些 API 版本

指定请求的 API 版本