このページは Apigee と Apigee ハイブリッドに適用されます。
バージョンは、明確に定義された API のインターフェースです。これにより、アプリケーションの安定した利用が可能になります。1 つの API に複数のバージョンを用意できます。
API は複数のデプロイメントを持つことができます。各デプロイメントは異なるバージョンを持つことができます。
バージョンは、編集権限を持つユーザーが API を登録するときに API と関連付けられます。また、デプロイメントを追加または編集するときにデプロイメントと関連付けられます。
![[Versions] タブ。クリックして画像を拡大](https://cloud.google.com/static/apigee/docs/api-hub/images/versions-tab.png?hl=ja)
API Registry スキーマを表示する
次に、API Hub API、バージョン、デプロイメント、仕様の関係を示します。
| リファレンス | 項目 | 説明 |
|---|---|---|
 |
レジストリ | レジストリは、API カタログとしてサービスを提供する API のコレクションです。 |
 |
バージョン | 1 つの API に複数のバージョンを作成することもできます。バージョンは、クライアントが API の呼び出しに使用できる、安定したインターフェースに対応している必要があります。これらのバージョンのいずれかを推奨バージョンとして指定できます。semver の観点では、バージョンをメジャー バージョンにすることをおすすめします。 |
 |
デプロイ | API は、複数のステージング環境やリージョンなど、複数のデプロイメントを持つことができます。デプロイメントとは、ユーザーが API にアクセスできる場所（アドレス）です。これらのデプロイメントの 1 つが推奨デプロイメントになります。 |
 |
仕様 | API バージョンは、正式な API 仕様に従って記述することを推奨しますが、必須ではありません。これらの仕様は、多くの場合に異なる API 仕様の形式を使用しています。これらの仕様形式のいずれかをメインにできます。つまり、このバージョンの他の仕様がこの仕様から派生しています。 |
 |
リビジョン |
|
バージョンを追加する
バージョンを追加するには:
Google Cloud コンソールで、[API Hub] ページに移動します。
デフォルトでは、[APIs] リストページが表示されます。
- [APIs] リストから API 行をクリックします。デフォルトでは、[Overview] タブが表示されます。
- [Versions] タブを選択します。
- [Add version] をクリックします。
- 詳細を指定します。
- ID を入力します。小文字、数字、ハイフン（-）のみ使用できます。たとえば、v1、v1、1、1-0-0 などです。
- バージョンを入力します。任意の文字を使用できます。
- [API ライフサイクル ステージ] を選択します。
- 終了予定:
- リストから [予定] を選択します。
- [予定] が [最小日付] の場合は、日付を指定します。
- [予定] が [確定した日付] の場合は、[日付] を指定します。
- [保存] または [キャンセル] をクリックします。
バージョンを編集する
バージョンを編集するには:
Cloud コンソールで、[API Hub] ページに移動します。
デフォルトでは、[APIs] リストページが表示されます。
- [APIs] リストから API 行をクリックします。デフォルトでは、[Overview] タブが表示されます。
- [Versions] タブを選択します。
- バージョンの横にある （その他）> [編集] をクリックします。
- 必要に応じて変更を行います。
- [保存] または [キャンセル] をクリックします。
バージョンを削除する
バージョンを削除するには:
Cloud コンソールで、[API Hub] ページに移動します。
デフォルトでは、[APIs] リストページが表示されます。
- [APIs] リストから API 行をクリックします。デフォルトでは、[Overview] タブが表示されます。
- [Versions] タブを選択します。
- バージョンの横にある （その他） > [削除] をクリックします。
- 確認のプロンプトで [削除] または [キャンセル] をクリックします。