パートナー センターで Azure アプリをオンボードするためのパートナー センター申請 API

  • [アーティクル]

パートナー センター申請 API を使用して、プログラムにより Azure プランをクエリし、申請を作成し、公開します。 この API は、お使いのアカウントで多くのプランを管理していて、これらのプランの申請プロセスを自動化および最適化したい場合に役立ちます。

API 前提条件

Azure 製品向けのパートナー センター API を使用するには、以下のいくつかのプログラム資産が必要です。

  • Microsoft Entra アプリケーション。
  • Microsoft Entra アクセス トークン。

手順 1: パートナー センター申請 API を使用するための前提条件を満たす

パートナー センター申請 API を呼び出すコードの記述を開始する前に、次の前提条件を満たしていることを確認してください。

Microsoft Entra アプリケーションをパートナー センター アカウントに関連付ける方法

Microsoft Store 申請 API を使用するには、Microsoft Entra アプリケーションをパートナー センター アカウントに関連付け、アプリケーションのテナント ID とクライアント ID を取得し、キーを生成する必要があります。 Microsoft Entra アプリケーションは、パートナー センター申請 API を呼び出すアプリまたはサービスを表します。 API に渡す Microsoft Entra アクセス トークンを取得するには、テナント ID、クライアント ID、キーが必要です。

Note

このタスクは 1 度だけ実行する必要があります。 テナント ID、クライアント ID、およびキーを取得したら、新しい Microsoft Entra アクセス トークンを作成する必要がある場合は、いつでもそれらを再利用できます。

  1. パートナー センターで、 組織のパートナー センター アカウントを組織の Microsoft Entra ディレクトリに関連付けます。
  2. 次に、パートナー センターの [アカウント設定] セクションの [ユーザー] ページから、パートナー センター アカウントの申請にアクセスするために使用するアプリまたはサービスを表す Microsoft Entra アプリケーションを追加します。 このアプリケーションにマネージャー ロールを確実に割り当てます。 アプリケーションが Microsoft Entra ディレクトリにまだ存在しない場合は、パートナー センターで新しい Microsoft Entra アプリケーションを作成できます。
  3. [ユーザー] ページに戻り、Microsoft Entra アプリケーションの名前をクリックしてアプリケーション設定に移動し、テナント ID とクライアント ID の値をコピーします。
  4. [新しいキーを追加] をクリックします。 次の画面で、キーの値を書き留めます。 このページを離れると、この情報にアクセスすることはできなくなります。 詳細については、「Microsoft Entra アプリケーションのキーを管理する」を参照してください。

手順 2: Microsoft Entra アクセス トークンを取得する

パートナー センター申請 API のメソッドを呼び出す前に、まず、API の各メソッドの Authorization ヘッダーに渡す Microsoft Entra アクセス トークンを取得する必要があります。 アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。 トークンの有効期限が切れたら、トークンを更新して、将来の API 呼び出しで使用できるようにします。

アクセス トークンを取得するには、「クライアント資格情報を使用したサービス間の呼び出し」の指示に従って、HTTP POST を https://login.microsoftonline.com/<tenant_id>/oauth2/token エンドポイントに送信します。 要求のサンプルを次に示します。

JSONCopy

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource= https://api.partner.microsoft.com

POST URI の tenant_id 値と client_id および client_secret パラメーターには、前のセクションでパートナー センターから取得した、アプリケーションのテナント ID、クライアント ID、キーを指定します。 resource パラメーターには、https://api.partner.microsoft.com を指定します。

手順 3: Microsoft Store 申請 API を使用する

Microsoft Entra アクセス トークンを取得したら、パートナー センター申請 API でメソッドを呼び出すことができます。 申請を作成または更新するには、通常はパートナー センター申請 API 内で複数のメソッドを特定の順序で呼び出します。 それぞれのシナリオと各メソッドの構文については、インジェスト API Swagger を参照してください。

https://ingestionapi-swagger.azureedge.net/#/

次のステップ