グリッド管理APIのバージョン管理

グリッド管理APIは、バージョン管理を使用して無停止アップグレードをサポートします。

たとえば、次の要求URLではバージョン3のAPIが指定されています。

https://hostname_or_ip_address/api/v3/authorize

グリッド管理APIで後方互換性のない変更が行われた場合は、APIのメジャー バージョンが上がります。たとえば、APIに対して互換性のない変更が行われると、バージョンが2.1から3.0に上がります。グリッド管理APIで後方互換性のある変更が行われた場合は、マイナー バージョンが上がります。後方互換性のある変更には、新しいエンドポイントやプロパティの追加などがあります。たとえば、APIに対して互換性のある変更が行われると、バージョンが3.0から3.1に上がります。

StorageGRIDソフトウェアを初めてインストールした場合は、グリッド管理APIの最新のバージョンのみが有効になっています。ただし、StorageGRIDを新しいフィーチャー リリースにアップグレードした場合、少なくともStorageGRIDのフィーチャー リリース1つ分の間は、古いAPIバージョンにも引き続きアクセスできます。

GET https://{{IP-Address}}/api/versions
{
  "responseTime": "2019-01-10T20:41:00.845Z",
  "status": "success",
  "apiVersion": "3.0",
  "data": [
    2,
    3
  ]
}