# 新しいREST APIメタデータをファイルから作成
利用対象...
* Cloud API Services Platform
* Cloud Data Fabric
* Data Fabric
* Data Services Platform
* ESB
* MDM Platform
* Real-Time Big Data Platform
## 手順
1. Integrationパースペクティブの[Repository] (リポジトリー)ツリービューで、[Metadata] (メタデータ)ノードの下にある[REST API Definitions] (REST API定義)ノードを右クリックし、コンテキストメニューから[Create API definition] (API定義を作成)を選択します。
[Import API definition] (API定義のインポート)ウィザードが開きます。
![\[Import API definition\] (API定義をインポート)ダイアログボックス。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/import_api_definition.png)
2. [Import from file] (ファイルからインポート)を選択し、OAS/Swagger 2.0またはOAS 3.0からAPI形式を選び、ローカルのREST APIファイルを参照します。
APIの自動検証が実行されます。ファイルが有効な場合は、[Next] (次へ)ボタンと[Finish] (終了)ボタンが有効になります。検証に失敗すると、次へ進むことができません。ただし、検証で警告のみが表示された場合は、このダイアログに表示されるリンクを使って警告の内容を確認し、警告に従って次へ進んでよいかどうか判断してください。ほとんどのユースケースでは警告は該当せず、注意を払う必要のある情報を示しているだけあり、ダイアログから[Next] (次へ)と[Finish] (終了)のアクションへ進むことができます。
3. [Next] (次へ)をクリックして、APIのコンテンツが自動的に入力されるAPI定義のプロパティを表示します。
![\[API定義をインポート\]ダイアログボックス。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/api_definition_properties.png)
API定義のプロパティAPI定義のプロパティ
| フィールド | 説明 |
| --- | --- |
| [Name] (名前) | API定義の名前。このフィールドは編集可能です。
禁止文字を入力すると、メッセージが表示されます。 |
| [Purpose] (目的) | 目的、またはAPI定義に関する有用な情報。このフィールドは編集可能です。 |
| [Description] (説明) | 処理内容や動作のしくみのわかりやすい情報が含まれるAPI定義の説明。このフィールドは編集可能です。 |
| [Author] (作成者) | デフォルトで現在のユーザーログインを表示する、読み取り専用のフィールドです。 |
| [Locker] (ロック保持者) | デフォルトで現在のジョブのロックを保持しているユーザーがログインしていることを示す読み取り専用フィールド。このフィールドはAPIを作成する時は空で、既存のAPIのプロパティを編集する時のみデータが存在します。 |
| [Version] (バージョン) | 読み取り専用のフィールドです。Mボタンとmボタンを使って、手動でバージョンを高くできます。 |
| [Status] (ステータス) | 作成中のジョブのステータスから選択するリスト。 |
| [Path] (パス) | API定義が作成されるフォルダーから選択するリスト。 |
4. [Finish] (終了)をクリックし、作成を確定してウィザードを閉じます。
作成したAPI定義は、[Repository] (リポジトリー)ツリービューの[Metadata] (メタデータ) > [REST API Definitions] (REST API定義)ノードの下にリスト表示されています。
コンテキストメニューから、以下のことができます。
* [Edit API definition] (API定義の編集): API定義のプロパティを編集する。
* [Update API definition] (API定義のアップデート): アップデートを使用して、API定義の新バージョン/アップデートバージョンを取得する。