Exchange への API 仕様とフラグメントのパブリッシュ

API 仕様またはフラグメントを Anypoint Exchange にパブリッシュして、他のチームメンバーがそれらを見つけて使用できるようにします。

始める前に

API 仕様またはフラグメントをパブリッシュする前に次の操作を実行します。

『Web またはデスクトップ IDE をセットアップしてアクセスします』。
『API 仕様』または『フラグメントを作成します』。
『ビジネスグループ』に精通します。

API 仕様を Anypoint Code Builder から Exchange にパブリッシュすると、IDE でビジネスグループの名前が要求されます。『ビジネスグループ』を参照してください。

Exchange に API 仕様をパブリッシュする

Exchange に API 仕様をパブリッシュする手順は、次のとおりです。

Anypoint Code Builder で API 仕様を開きます。
コマンドパレットを開きます。
手順を表示
- キーボードショートカットを使用する。
  
  Mac: Cmd+Shift+p
  
  Windows: Ctrl+Shift+p
- デスクトップ IDE で、[View (表示)] > [Command Palette (コマンドパレット)] を選択する。
- クラウド IDE で、 (メニュー) アイコンをクリックし、[View (表示)] > [Command Palette (コマンドパレット)] を選択する。

「publish」と入力し、次のコマンドを選択します。

MuleSoft: Publish API Specification to Exchangecommand

コマンドパレット内で強調表示されている MuleSoft: Publish API Specification to Exchange

確認を促されたら、[Allow (許可)] をクリックし、プロンプトに従って Anypoint Platform にサインインします。
[Select a Business Group (ビジネスグループを選択)] で、プロジェクトのビジネスグループを見つけて選択します。

詳細は、始める前にを参照してください。
[Set Project Name (プロジェクト名を設定)] で、プロジェクト名を確認または入力して、Enter キーを押します。
各項目を確認または変更して、Enter キーを押します。
- Artifact ID (アーティファクト ID) (OAS-Example など)。
- Asset version (アセットバージョン) (1.0.0 など)。
- API version (API バージョン) (v1 など)。
パブリッシュをキャンセルするには、Escape キーを押します。

ステータスバーに進行状況が表示されます。完了したら、API 仕様が Exchange に正常にパブリッシュされたことを示すメッセージが表示されます。
API を実装するように促されたら、次のいずれかを選択します。
- インテグレーションに API 仕様をスキャフォールディングしないようにするには、[No (いいえ)] を選択します。
- 新しいプロジェクトに API 仕様をスキャフォールディングするには、[Yes (はい)] を選択します。
  手順を表示
  表示された項目に実装プロジェクトの名前を入力します。
  
  プロジェクトのディレクトリに移動し、[Select target folder (対象フォルダーを選択)] をクリックします。
  
  プロジェクトの Mule Runtime (Mule) バージョンを選択します。
  
  Mule でサポートされる Java バージョンを選択します。
  
  スキャフォールディングプロセスが完了したら、[Explorer] で src/main/mule ディレクトリからプロジェクトのスキャフォールディング済みインターフェースを表示します。
  
  スキャフォールディングが失敗する場合は、『実装エラー』を参照してください。
  
  [Explorer] から新しいプロジェクトの mule-artifact.json ファイルを開いて、Mule バージョンと Java バージョンを確認することもできます。次に例を示します。
  
  { "minMuleVersion": "4.6.2", "javaSpecificationVersions": [ "11" ] }
  XML
  
  mule-artifact.json ファイルはプロジェクトディレクトリのルートレベルにあります。

Exchange で API を見つける

API 仕様をパブリッシュしたら、Anypoint Exchange でその API 仕様を見つけることができます。

Anypoint Platform に移動し、ログイン情報を使用してログインします。
手順を表示
US クラウド (非 EU ホスト): Anypoint Platform (US)

EU クラウド (EU ホスト): Anypoint Platform (EU)
Anypoint Exchange に移動します。
手順を表示
US クラウド (非 EU ホスト): Exchange (US)

EU クラウド (EU ホスト): Exchange (EU)
API 仕様が組織のアセットとして表示されます。次に例を示します。

API を選択し、その概要に移動して、前のタスクで定義したすべてのエンドポイントを表示できます。

Exchange に GraphQL API 仕様をパブリッシュする

GraphQL API 仕様を Exchange にパブリッシュする手順は、次のとおりです。

Anypoint Platform に移動し、ログイン情報を使用してログインします。
手順を表示
US クラウド (非 EU ホスト): Anypoint Platform (US)

EU クラウド (EU ホスト): Anypoint Platform (EU)
Anypoint Exchange に移動します。
手順を表示
US クラウド (非 EU ホスト): Exchange (US)

EU クラウド (EU ホスト): Exchange (EU)
[Publish new asset (新規アセットをパブリッシュ)] をクリックします。
[Publish a new asset (新規アセットをパブリッシュ)] フォームに情報を入力します。
1. [Name (名前)] にアセットの名前を入力します。
2. [Asset types (アセットタイプ)] では、[GraphQL API] を選択します。
3. [Method (方法)] では、[Upload a GraphQL API Schema (GraphQL API スキーマをアップロード)] を選択します。
4. [File upload (ファイルアップロード)] では、[Choose file (ファイルを選択)] をクリックして目的の .graphql スキーマファイルを探します。
5. バージョン番号を変更するには、[Advanced (詳細)] をクリックします。
6. [Lifecycle state (ライフサイクル状態)] では、[Stable (安定)] を選択します。
[Publish (パブリッシュ)] をクリックします。

次の例のように、GraphQL API 仕様が Exchange で利用できるようになりました。