# 複数のバージョンでの作業

Talend Cloud API Designerでは、新しいバージョンで変更を準備している間に、同じAPIコントラクトの複数のバージョンを保守管理します。

* 既存のAPIバージョンを本番環境で維持しつつ、重要な変更や画期的な変更を新しいバージョンに導入できます。
* 単一の場所から、APIバージョンをトランザクションして管理します。
* 既存バージョンに影響を及ぼさずにAPI変更を処理します。

APIの新しいバージョンを作成すると、すべてのコンテンツが新しいバージョンにコピーされます。こうすると、最新バージョンを、前のバージョンに影響を与えることなく独立してアップデートできます。

編集可能なのは最新バージョンのみだえり、それからのみ新しいバージョンを作成できます。旧バージョンは読み取り専用です。

Talend Cloud API Designerホームページには、所有するすべてのAPIと共有するAPIの全バージョンが表示されます。 ![Talend Cloud API Designerのホームページ。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/api-designer-homepage.png)

## 新しいAPIバージョンの作成

既存のAPI定義の新しいバージョンを作成

### 始める前に

情報メモ注: You can create a new version only from the latest version. Older versions are read-only and cannot be edited or used to create a new version.

APIの所有者、または最新のAPIバージョンの編集者である必要があります。

### 手順

1. ホームページで、新しいバージョンを作成するAPIに移動します。

   必要であればリストを名前でフィルタリングします。
2. 最新のバージョンを開いて[Preview] (プレビュー)を表示し、[Create a new version] (新しいバージョンを作成)をクリックします。

   ![\[Create a new version\] (新しいバージョンを作成)ボタンのビュー。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/create_new_version.png)
3. 新しいバージョンを入力します。
4. [Create] (作成)をクリックします。

### タスクの結果

新しいバージョンのAPIが最新バージョンと同じコンテンツで作成されます。デフォルトではモックとドキュメンテーションが無効になっています。

## APIバージョンの削除

### 始める前に

APIの所有者か編集者であること。

### 手順

1. ホームページで、削除したいバージョンの横にある![\[Menu\] (メニュー)](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/apis_menu.png)をクリックし、[Delete] (削除)をクリックします。

   情報メモ注: You cannot delete a version if its documentation is published on API Portal. You need to unpublish it or mark it as unpublished before deleting it. For more information, see [Managing your API documentation](https://help.qlik.com/talend/en-US/api-designer-user-guide/Cloud/managing-api-documentation).
2. [Delete] (削除)をクリックして確定します。

### タスクの結果

選択されたバージョンで削除されます。API全体を削除する場合は、それぞれのバージョンを削除する必要があります。

## バージョンコンテンツのインポート

既存のコントラクトからコンテンツを API バージョンにインポートし、現在のコンテンツを置き換えるか、統合します。

### 始める前に

APIの所有者、または最新のAPIバージョンの編集者である必要があります。読み取り専用バージョンはこのアクションをサポートしていません

### このタスクについて

この機能を使用すると、新しいバージョンを作成せずに外部のコントラクトファイルからバージョンを更新できます。インポート中もバージョン識別子は保持されます。

これは、Talend Cloud API Designerで新しいAPIを作成する[定義のインポート](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Cloud/importing-definition "既存のAPI定義のインポートをTalend Cloud API Designerにインポートします。")とは異なります。

### 手順

1. 更新対象となるバージョンの[Import version content] (バージョンコンテンツのインポート)を開きます。

   この操作には、次の場所からアクセスできます。
   * ホームページで、対象のバージョンの横にある![\[Menu\] (メニュー)](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/apis_menu.png)をクリックし、[Import version content] (バージョンコンテンツのインポート)をクリックします。

     ![メニューボタンの\[Import version content\] (バージョンコンテンツのインポート)オプション。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/import-version-content-2.png)
   * [Preview] (プレビュー)で、![\[Menu\] (メニュー)](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/apis_menu.png)をクリックしてから、[Import version content] (バージョンコンテンツのインポート)をクリックします。

     ![バージョンホームページの\[Import version content\] (バージョンコンテンツのインポート)オプション。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/import-version-content-3.png)
   * バージョンエディターで、[Edit] (編集) > [Import version content] (バージョンコンテンツのインポート)をクリックします。

     ![バージョンエディターの\[Import version content\] (バージョンコンテンツのインポート)オプション。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/import-version-content.png)
2. インポートするコントラクトの形式とソースを選択します。

   コントラクトは、ローカルファイル、URL、またはダイアログボックスに直接貼り付けたテキストからインポートできます。
3. [Behavior] (動作) で、インポートしたコンテンツの適用方法を選択します。
   * 置換: 現在のすべてのコンテンツをインポートしたコントラクトで上書きします。API名、バージョン識別子、仕様バージョンは保持されます。
   * マージ: インポートしたコンテンツを既存のバージョンコンテンツと統合します。API名とバージョン識別子は保持されます。インポートしたエレメントが既存のエレメントと同じ名前を持つ場合、そのエレメントは\_mergeサフィックスを付けて名前が変更されます(例: User\_merge)。重複するベースURLおよびメディアタイプはスキップされます。

   ![\[Import version content\] (バージョンコンテンツをインポート)ダイアログボックス。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/import-version-content-dialobox.png)
4. [Import] (インポート)をクリックします。

### タスクの結果

更新されたコンテンツが適用された状態で、バージョンエディターが開きます。