メイン コンテンツをスキップする 補完的コンテンツへスキップ

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

最終更新日時: 2026-11-10

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

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

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

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

Talend Cloud API Designerホームページには、所有するすべてのAPIと共有するAPIの全バージョンが表示されます。
Talend Cloud API Designerのホームページ。

新しい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] (新しいバージョンを作成)ボタンのビュー。
  3. 新しいバージョンを入力します。
  4. [Create] (作成)をクリックします。

タスクの結果

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

APIバージョンの削除

始める前に

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

手順

  1. ホームページで、削除したいバージョンの横にある[Menu] (メニュー)をクリックし、[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.
  2. [Delete] (削除)をクリックして確定します。

タスクの結果

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

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

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

始める前に

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

このタスクについて

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

これは、Talend Cloud API Designerで新しいAPIを作成する定義のインポートとは異なります。

手順

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

    この操作には、次の場所からアクセスできます。

    • ホームページで、対象のバージョンの横にある[Menu] (メニュー)をクリックし、[Import version content] (バージョンコンテンツのインポート)をクリックします。
      メニューボタンの[Import version content] (バージョンコンテンツのインポート)オプション。
    • [Preview] (プレビュー)で、[Menu] (メニュー)をクリックしてから、[Import version content] (バージョンコンテンツのインポート)をクリックします。
      バージョンホームページの[Import version content] (バージョンコンテンツのインポート)オプション。
    • バージョンエディターで、[Edit] (編集) > [Import version content] (バージョンコンテンツのインポート)をクリックします。
      バージョンエディターの[Import version content] (バージョンコンテンツのインポート)オプション。
  2. インポートするコントラクトの形式とソースを選択します。
    コントラクトは、ローカルファイル、URL、またはダイアログボックスに直接貼り付けたテキストからインポートできます。
  3. [Behavior] (動作) で、インポートしたコンテンツの適用方法を選択します。
    • 置換: 現在のすべてのコンテンツをインポートしたコントラクトで上書きします。API名、バージョン識別子、仕様バージョンは保持されます。
    • マージ: インポートしたコンテンツを既存のバージョンコンテンツと統合します。API名とバージョン識別子は保持されます。インポートしたエレメントが既存のエレメントと同じ名前を持つ場合、そのエレメントは_mergeサフィックスを付けて名前が変更されます(例: User_merge)。重複するベースURLおよびメディアタイプはスキップされます。
    [Import version content] (バージョンコンテンツをインポート)ダイアログボックス。
  4. [Import] (インポート)をクリックします。

タスクの結果

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

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。