間接リセラーの一覧を取得する

2024-04-01

適用対象: パートナーセンター

サインインしているパートナーの間接リセラーの一覧を取得する方法。

前提条件

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

C#

サインインしているパートナーがリレーションシップを持つ間接リセラーの一覧を取得するには、まず partnerOperations.Relationships プロパティからリレーションシップコレクション操作へのインターフェイスを取得します。次に、Get メソッドまたは Get_Async メソッドを呼び出し、PartnerRelationshipType 列挙型のメンバーを渡してリレーションシップの種類を識別します。間接リセラーを取得するには、IsIndirectCloudSolutionProviderOf を使用する必要があります。

// IAggregatePartner partnerOperations;

var indirectResellers = partnerOperations.Relationships.Get(PartnerRelationshipType.IsIndirectCloudSolutionProviderOf);

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

REST 要求

要求の構文

認証方法	要求 URI
GET	{baseURL}/v1/relationships?relationship_type=IsIndirectCloudSolutionProviderOf HTTP/1.1

URI パラメーター

リレーションシップの種類を識別するには、次のクエリパラメーターを使用します。

名前	タイプ	Required	説明
relationship_type	string	はい	値は PartnerRelationshipType で見つかったいずれかのメンバー名の文字列表現です。パートナーがプロバイダーとしてサインインしていて、関係を確立した間接リセラーの一覧を取得する場合は、IsIndirectCloudSolutionProviderOf を使用します。パートナーがリセラーとしてサインインしていて、関係を確立した間接プロバイダーの一覧を取得する場合は、IsIndirectResellerOf を使用します。

要求ヘッダー

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

要求本文

なし。

要求の例

GET https://api.partnercenter.microsoft.com/v1/relationships?relationship_type=IsIndirectCloudSolutionProviderOf HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 144391a4-fb06-41ae-b684-3308ce4706bd
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST 応答

成功した場合、応答本文には、リセラーを識別するための PartnerRelationship リソースのコレクションが含まれます。

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

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

応答の例

HTTP/1.1 200 OK
Content-Length: 298
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 144391a4-fb06-41ae-b684-3308ce4706bd
MS-CV: b21Ll1miM0yFMPQQ.0
MS-ServerId: 030020643
Date: Wed, 05 Apr 2017 21:08:44 GMT

{
    "totalCount": 2,
    "items": [{
            "id": "484e548c-f5f3-4528-93a9-c16c6373cb59",
            "name": "First Up Consultants",
            "relationshipType": "is_indirect_cloud_solution_provider_of",
            "state": "Active",
            "mpnId": "4847383",
            "location": "US",
            "attributes": {
                "objectType": "PartnerRelationship"
            }
        }, {
            "id": "b01b1487-b36e-4e6d-9b5e-0b58974c4b28",
            "name": "ReleCloud",
            "relationshipType": "is_indirect_cloud_solution_provider_of",
            "state": "Active",
            "mpnId": "4847433",
            "location": "BR",
            "attributes": {
                "objectType": "PartnerRelationship"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}