Überprüfen einer Partner-PARTNER-ID über C# oder die Partner Center-REST-API

Artikel
03/29/2024

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

So überprüfen Sie eine PartnerID.

Die hier gezeigte Technik überprüft die PartnerID durch Anfordern des Microsoft AI Cloud Partner Program-Profils des Partners aus dem Partner Center. Der Bezeichner gilt als gültig, wenn die Anforderung erfolgreich ist.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Partner-ID, die überprüft werden soll. Wenn Sie diesen Wert weglassen, ruft die Anforderung das Microsoft AI Cloud Partner Program-Profil des angemeldeten Partners ab.

C#

Um die PartnerID eines Partners zu überprüfen, rufen Sie zuerst eine Schnittstelle zu Partnerprofilsammlungsvorgängen aus der IAggregatePartner.Profiles-Eigenschaft ab. Rufen Sie dann eine Schnittstelle zu Microsoft AI Cloud Partner Program-Profilvorgängen aus der MpnProfile-Eigenschaft ab. Rufen Sie schließlich die Get - oder GetAsync-Methoden mit der PartnerID auf, um das Microsoft AI Cloud Partner Program-Profil abzurufen. Wenn Sie die PartnerID aus dem Get- oder GetAsync-Aufruf weglassen, versucht die Anforderung, das Microsoft AI Cloud Partner Program-Profil des angemeldeten Partners abzurufen.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Beispiel: Konsolentest-App. Project: Partner Center SDK Samples Class: VerifyPartnerMpnId.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

URI-Parameter

Geben Sie den folgenden Abfrageparameter an, um den Partner zu identifizieren. Wenn Sie diesen Abfrageparameter weglassen, gibt die Anforderung das Microsoft AI Cloud Partner Program-Profil des angemeldeten Partners zurück.

Name	Type	Erforderlich	Beschreibung
MPN-ID	INT	Nein	Eine Partner-ID, die den Partner identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Beispiel für eine Anfrage

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Wichtig

Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

REST-Antwort

Wenn der Antworttext erfolgreich verläuft, enthält der Antworttext die MpnProfile-Ressource für den Partner.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispiel für eine Antwort (Erfolg)

HTTP/1.1 200 OK
Content-Length: 159
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
    }
}

Antwortbeispiel (Fehler)

HTTP/1.1 404 Not Found
Content-Length: 124
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}

Freigeben über