Skip to main content
Active IQ Unified Manager
9.7
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

Active IQ Unified ManagerでのAPIのバージョン管理

PDF

Active IQ Unified Manager の REST API URI はバージョン番号を指定します。例えば、 /v2/datacenter/svm/svms。バージョン番号 v2（ `/v2/datacenter/svm/svms`内）は、特定のリリースで使用される API バージョンを示します。バージョン番号は、クライアントが処理できる応答を返すことで、API の変更がクライアントソフトウェアに与える影響を最小限に抑えます。

このバージョン番号の数値部分は、リリースごとに増加します。バージョン番号を含むURIは、将来のリリースにおける下位互換性を維持する一貫性のあるインターフェースを提供します。バージョン指定のない同じAPIも見つかります。例えば /datacenter/svm/svms、バージョン指定のない基本APIを示します。基本APIは常に最新バージョンのAPIです。

メモ

Swaggerインターフェイスの右上の領域で、使用するAPIのバージョンを選択できます。デフォルトでは、最新バージョンが選択されています。特定のAPIについて、Unified Managerインスタンスで使用可能な（最も大きな数字の）最新バージョンを使用することを推奨します。

すべてのリクエストにおいて、使用したいAPIバージョンを明示的に指定する必要があります。バージョン番号が指定されている場合、サービスは、アプリケーションが処理するように設計されていない応答要素を返しません。RESTリクエストでは、バージョンパラメータを含める必要があります。APIの初期バージョンは、数回のリリースを経て最終的に非推奨となります。今回のリリースでは、 `v1`バージョンのAPIは非推奨です。