C# またはパートナー センター REST API を使用してパートナー PartnerID を確認する

適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター

PartnerID を確認する方法。

ここで示す手法では、パートナー センターからパートナーの Microsoft AI Cloud パートナー プログラム プロファイルを要求することで、PartnerID を検証します。 要求が成功した場合、識別子は有効と見なされます。

前提条件

• パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。

• 確認するパートナー PartnerID。 この値を省略すると、要求によって、サインインしているパートナーの Microsoft AI Cloud パートナー プログラム プロファイルが取得されます。

C#

パートナーの PartnerID を確認するには、最初に IAggregatePartner.Profiles プロパティから パートナー プロファイルコレクション操作へのインターフェイスを 取得します。 次に、MpnProfile プロパティから Microsoft AI Cloud パートナー プログラムプロファイル操作へのインターフェイスを取得します。 最後に、PartnerID を使用して Get メソッドまたは GetAsync メソッドを呼び出して、Microsoft AI Cloud Partner Program プロファイルを取得します。 Get または GetAsync 呼び出しから PartnerID を省略した場合、要求はサインインしているパートナーの Microsoft AI クラウド パートナー プログラム プロファイルの取得を試みます。

// IAggregatePartner partnerOperations;
// string partnerMpnId;

var partnerProfile = partnerOperations.Profiles.MpnProfile.Get(partnerMpnId);

サンプル: コンソール テスト アプリ。 プロジェクト: パートナー センター SDK サンプル クラス: VerifyPartnerMpnId.cs

REST 要求

要求の構文

認証方法	要求 URI
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

URI パラメーター

パートナーを識別するには、次のクエリ パラメーターを指定します。 このクエリ パラメーターを省略すると、要求はサインインしているパートナーの Microsoft AI Cloud パートナー プログラム プロファイルを返します。

名前	タイプ	Required	説明
mpn-id	int	いいえ	パートナーを識別する PartnerID。

要求ヘッダー

詳細については、「パートナー センター REST ヘッダー」を参照してください。

リクエストの本文

なし。

要求の例

GET https://api.partnercenter.microsoft.com/v1/profiles/mpn?mpnId=9999999 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 560df6b9-6e53-4954-aed7-133477ac1194
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

重要

2023 年 6 月の時点で、最新のパートナー センター .NET SDK リリース 3.4.0 がアーカイブされるようになりました。 SDK リリースは、有用な情報が記載された readme ファイルと一緒に GitHub からダウンロードできます。

パートナーの皆様には、パートナー センター REST API を引き続き使用することをお勧めします。

REST 応答

成功した場合、応答本文にはパートナーの MpnProfile リソースが含まれます。

応答の成功とエラーのコード

各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。

応答の例 (成功)

HTTP/1.1 200 OK
Content-Length: 159
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: e39e0ddf-3fd0-4b7e-bb4e-8aebe242d3ee
MS-CV: s2GvkNgZsUSadxQX.0
MS-ServerId: 030011719
Date: Thu, 13 Apr 2017 18:13:40 GMT

{
    "partnerName": "Microsoft Partner", 
    "mpnId": "4391507",
    "profileType": "MpnProfile",
    "links": {
        "self": {
            "uri": "/profiles/mpn",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "MpnProfile"
    }
}

応答の例 (失敗)

HTTP/1.1 404 Not Found
Content-Length: 124
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: 560df6b9-6e53-4954-aed7-133477ac1194
MS-CV: sLRFZMWm+EKuL47u.0
MS-ServerId: 102030524
Date: Thu, 13 Apr 2017 18:26:51 GMT

{
    "code": 3000,
    "description": "Partner Organization with partner_id 9999999 could not be found",
    "data": [],
    "source": "PartnerFD"
}