Uzyskaj partnerów klienta

Artykuł
12/16/2024

Dotyczy: Centrum Partnerskie

Jak uzyskać listę odsprzedawców pośrednich lub dostawców pośrednich, którzy mają relację z określonym klientem.

Warunki wstępne

Należy aktywnie zarejestrować się w programie CSP jako dostawca pośredni lub odsprzedawca pośredni.
Poświadczenia zgodnie z opisem w uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń aplikacji i użytkownika.
Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w centrum partnerskim . Wybierz obszar roboczy Klienci na stronie głównej Centrum partnerskiego. Wybierz klienta z listy Klientów , a następnie wybierz Konto. Na stronie Konto klienta wyszukaj identyfikator Microsoft w sekcji szczegóły konta klienta . Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).

C#

Aby pobrać listę odsprzedawców pośrednich lub dostawców pośrednich, z którymi określony klient ma relację, najpierw uzyskaj dostęp do operacji zbioru klientów dla tego klienta z właściwości partnerOperations.Customers, podając identyfikator klienta w celu jego zidentyfikowania. Następnie wywołaj metodę Relationships.Get lub Get_Async, aby uzyskać listę odsprzedawców pośrednich.

// IAggregatePartner partnerOperations;
// string customerId;

 var partnerRelationships = partnerOperations.Customers[customerId].Relationships.Get();

Żądanie REST

Oto informacje o żądaniu REST i odpowiedzi.

Składnia żądania

Metoda	URI żądania
GET	{baseURL}/v1/customers/{customer-id}/relacje HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru ścieżki, aby zidentyfikować klienta.

Nazwa	Typ	Wymagane	Opis
identyfikator klienta	struna	Tak	Ciąg sformatowany jako GUID, który identyfikuje klienta.

Nagłówki żądań

Aby uzyskać więcej informacji, patrz Nagłówki REST Centrum partnerskiego.

Ciało żądania

Żaden.

Przykład żądania

GET https://api.partnercenter.microsoft.com/v1/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/relationships HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c9251710-5a30-4cd3-891a-c42d550af9a8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera kolekcję zasobów PartnerRelationship w celu zidentyfikowania odsprzedawców.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów Centrum partnerskiego.

Przykład odpowiedzi

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: c9251710-5a30-4cd3-891a-c42d550af9a8
MS-CV: plJP3ufU0UqXMeuh.0
MS-ServerId: 020021921
Date: Fri, 07 Apr 2017 23:42:11 GMT

{
    "totalCount": 1,
    "items": [{
            "id": "aaaa0000-aa11-2222-33cc-444444bbbbbb",
            "name": "First Up Consultants",
            "relationshipType": "is_indirect_cloud_solution_provider_of",
            "mpnId": "4847383",
            "attributes": {
                "objectType": "PartnerRelationship"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Udostępnij za pośrednictwem