---
schema_version: "1"
id: 3268524ab86d6db8bfe554deb04c38daed12b1c91a8a8146bc1b4ca63c3fe39b
title: API グループインスタンスコントラクトの管理
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/api-manager/latest/api-groups-manage-api-group-instance-contracts.md
canonical_url: https://docs.mulesoft.com/jp/api-manager/latest/api-groups-manage-api-group-instance-contracts
source_site: docs.mulesoft.com
content_type: documentation
content_hash: d7f4f22ce7d2ca0a2864eb728d032ef8991d8e7fc7d586ff0234d92b31488964
description: MuleSoft Documentation Site
release: 2.x
latest: true
---
# API グループインスタンスコントラクトの管理

Exchange の API グループインスタンスへのアクセス権を付与すると、アプリケーションと API インスタンスの間にコントラクトが自動的に作成されます。その後、API Manager からそのコントラクトを管理できます。

## [](#適用済みコントラクト)適用済みコントラクト

API グループでは、アプリケーションは次のシナリオで同じ API との複数のコントラクトを持つことができます:

- アプリケーションが API へのアクセスを要求し、その要求が承認される。  
    この場合、アプリケーションと API の間に直接的コントラクトが作成されます。これは ​_API インスタンスコントラクト_​と呼ばれます。
- アプリケーションは、すでにそのアプリケーションとの直接的コントラクトがある API インスタンスで構成される、API グループインスタンスへのアクセスを要求します。  
    これは ​_API グループインスタンスコントラクト_​と呼ばれます。

アプリケーションに同じ API インスタンスとのコントラクトが複数ある場合、常に 1 つのコントラクトのみがアクティブになります。これは​_適用済みコントラクト_​と呼ばれます。

このスクリーンショットは、API インスタンスコントラクトのコントラクトレベルとコントラクト状況を示しています。

![API グループインスタンスコントラクト](/mulesoft/current/ja-jp/api-manager/latest/_images/api-groups-instance-contracts.png)

<table><tbody><tr><td><i class="conum" data-value="1"></i><b>1</b></td><td>インスタンスレベルの API インスタンスのコントラクト</td></tr><tr><td><i class="conum" data-value="2"></i><b>2</b></td><td>コントラクトが表示される API グループ</td></tr><tr><td><i class="conum" data-value="3"></i><b>3</b></td><td>現在 API インスタンスとのコントラクトがあるアプリケーション</td></tr><tr><td><i class="conum" data-value="4"></i><b>4</b></td><td>現在アクティブなコントラクト</td></tr><tr><td><i class="conum" data-value="5"></i><b>5</b></td><td>API グループレベルの API インスタンスのコントラクト</td></tr></tbody></table>

アプリケーションは、API グループ内の異なる API との複数のコントラクトを持つことができます。API グループレベルで API インスタンスコントラクトを表示できます。コントラクトは、API グループとのコントラクトがあるアプリケーションで並び替えられます。API グループ内で現在アクティブなコントラクトは、​`Applied`​ として表示されます。

アプリケーションに同じ API とのコントラクトが複数ある場合、同じ API の他のコントラクト層と比べて制限が最も少ない層が ​`Applied`​ に設定されます。承認済みのコントラクトのみが ​`Applied`​ に設定されます。取り消されたコントラクトはアクティブではなくなるため、​`Applied`​ に設定されることはありません。

## [](#適用済みコントラクトの例)適用済みコントラクトの例

API とアプリケーションの間に複数のコントラクトがある場合、コントラクトが ​`Applied`​ に設定される方法についての理解を深めるために、次の例を考えてみます。

Good Weather は、​`Contacts`​ というアプリケーションの ​`Facebook`​ API へのアクセスを要求しています。​`Contacts`​ と ​`Facebook`​ の間にコントラクトが作成されます。コンシューマーは同じアプリケーション ​`Contacts`​ を使用して、数ある中から ​`Facebook`​ API で構成される ​`Social Chatter`​ という API グループインスタンスへのアクセスを要求します。​`Contacts`​ と ​`Social Chatter`​ の間にもコントラクトが作成されます。

この場合、アプリケーション ​`Contacts`​ には 2 つのコントラクトがあります。

- API ​`Facebook`​ との直接的コントラクト
- API グループインスタンス ​`Social Chatter`​ とのコントラクトによる、API ​`Facebook`​ との間接的コントラクト

`Contacts`​ には 2 つのコントラクトがあるため、どちらのコントラクトが ​`Applied`​ に設定されるでしょうか。次の条件があるとします。

- API コントラクト層では 1 分あたり 100 要求が許可されている
- API グループコントラクトでは 1 分あたり 10 要求が許可されている

この場合、​`Contacts`​ と ​`Facebook`​ の間のコントラクトが最も制限の少ない層であるため、​`Applied`​ に設定されます。ユーザーは、API グループコントラクトを使用する場合よりも 1 分あたり 90 個多い要求を取得します。

コントラクトは API に適用されますが、API グループインスタンスには適用されません。たとえば、コンシューマーが API グループインスタンス ​`Social Chatter`​ と別のアプリケーション ​`Interests`​ の間のコントラクトを作成するとします。

- `Contacts`​ と API ​`Facebook`​ の場合、適用済みコントラクトは API コントラクト。
- `Interests`​ と API ​`Facebook`​ の場合、API グループインスタンスコントラクトがアプリケーションと API の間の唯一のコントラクトであるため、適用済みコントラクトは API グループインスタンスコントラクト。
    
    `Interests`​ には ​`Facebook`​ API との直接的コントラクトはありません。

API グループインスタンスコントラクトを表示する手順は、次のとおりです。

1. **\[Anypoint Platform\]**​ > ​**\[API Manager\]**​ に移動します。
2. **\[API Groups (API グループ)\]**​ をクリックします。
3. API グループインスタンスの詳細ページから、API グループインスタンスの ​`version:instance`​ リンクをクリックします。
4. **\[Contracts (コントラクト)\]**​ をクリックして、コントラクト情報を表示するインスタンスを展開します。
    
    ![API グループインスタンスのコントラクトの表示](/mulesoft/current/ja-jp/api-manager/latest/_images/api-group-instance-contracts.png)
    
    API グループインスタンスのコントラクトが表示されます。

API グループインスタンスコントラクトを管理する手順は、次のとおりです。

1. **\[API Manager\]**​ で、​**\[API Groups (API グループ)\]**​ をクリックします。
2. API グループインスタンスの詳細ページから、API グループインスタンスの ​`version:instance`​ リンクをクリックします。
    
    API グループインスタンスの詳細ページが表示されます。
3. **\[Contracts (コントラクト)\]**​ をクリックして、コントラクト情報を表示するインスタンスを展開します。
    
    ![API グループインスタンスのコントラクトの管理](/mulesoft/current/ja-jp/api-manager/latest/_images/api-group-instance-manage-contracts.png)
    
    API グループインスタンスのコントラクトが表示されます。
4. コントラクトを管理する API グループインスタンスで、​**\[…​\]**​ > ​**\[Revoke (取り消し)\]**​ をクリックします。