API グループインスタンスコントラクトの管理

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

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

アプリケーションは、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 つのコントラクトがあります。

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

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

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

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

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