Abrufen der Bestätigung der Kundenakzeptanz zur Microsoft-Kundenvereinbarung

  • Artikel

Gilt für: Partner Center

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

Die Vereinbarungsressource wird derzeit nur von Partner Center in der öffentlichen Microsoft-Cloud unterstützt.

In diesem Artikel wird erläutert, wie Sie Bestätigungen der Annahme des Microsoft-Kundenvereinbarung eines Kunden abrufen können.

Voraussetzungen

  • Wenn Sie das Partner Center .NET SDK verwenden, ist Version 1.14 oder höher erforderlich.

    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.

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur App- und Benutzerauthentifizierung.

  • Eine Kunden-ID (customer-tenant-id). Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

.NET

So rufen Sie Bestätigungen der Kundenakzeptanz ab, die zuvor bereitgestellt wurde:

  • Verwenden Sie die IAggregatePartner.Customers-Auflistung und rufen Sie die ById-Methode mit dem angegebenen Kundenbezeichner auf.

  • Rufen Sie die Agreements-Eigenschaft ab, und filtern Sie die Ergebnisse nach Microsoft-Kundenvereinbarung, indem Sie die ByAgreementType-Methode aufrufen.

  • Rufen Sie die Get - oder GetAsync-Methode auf.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Ein vollständiges Beispiel finden Sie in der GetCustomerAgreements-Klasse aus dem Konsolentest-App-Projekt .

REST-Anforderung

So rufen Sie die Bestätigung der Kundenakzeptanz ab, die zuvor bereitgestellt wurde:

  1. Erstellen Sie eine REST-Anforderung zum Abrufen der Vereinbarungssammlung für den Kunden.

  2. Verwenden Sie den agreementType-Abfrageparameter, um die Ergebnisse nur auf die Microsoft-Kundenvereinbarung zu beschränken.

Anforderungssyntax

Verwenden Sie die folgende Anforderungssyntax:

Methode Anforderungs-URI
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

URI-Parameter

Sie können die folgenden URI-Parameter mit Ihrer Anforderung verwenden:

Name Type Erforderlich Beschreibung
customer-tenant-id GUID Ja Der Wert ist eine guid formatierte CustomerTenantId , mit der Sie einen Kunden angeben können.
Vereinbarungstyp Zeichenfolge No Dieser Parameter gibt alle Vereinbarungsmetadaten zurück. Verwenden Sie diesen Parameter, um die Abfrageantwort auf einen bestimmten Vertragstyp festzulegen. Die unterstützten Werte sind:

MicrosoftCloudAgreement , das nur Vereinbarungsmetadaten des Typs "MicrosoftCloudAgreement" enthält.

MicrosoftCustomerAgreement , das nur Vereinbarungsmetadaten des Typs "MicrosoftCustomerAgreement" enthält.

* die alle Vereinbarungsmetadaten zurückgibt. (Verwenden Sie diese Option nur, * wenn Ihr Code über die erforderliche Logik zum Behandeln unerwarteter Vertragstypen verfügt.)

Hinweis: Wenn der URI-Parameter nicht angegeben ist, wird die Abfrage standardmäßig für Die Abwärtskompatibilität auf MicrosoftCloudAgreement festgelegt. Microsoft kann Vertragsmetadaten jederzeit mit neuen Vertragstypen einführen.

Anforderungsheader

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

Anforderungstext

Keine.

Beispiel für eine Anfrage

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

REST-Antwort

Bei erfolgreicher Ausführung gibt die Methode eine Sammlung von Vereinbarungsressourcen im Antworttext zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und andere Debuginformationen angibt.

Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}