Abrufen des Status der direkten Unterzeichnung eines Kunden (direkte Akzeptanz) für die Microsoft-Kundenvereinbarung

Artikel
01/29/2025

Gilt für: Partner Center

Gilt nicht für: Partner Center, betrieben von 21Vianet | Partner Center für Microsoft Cloud für die US-Regierung

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

In diesem Artikel wird erläutert, wie Sie den Status der direkten Annahme des Microsoft-Kundenvertrags eines Kunden abrufen können.

Voraussetzungen

Anmeldeinformationen so wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Authentifizierung mit App- und Benutzeranmeldedaten.
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 auswählen, dann den Kunden aus der Kundenliste und anschließend Konto. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).
Der indirekte Anbieter oder direkte Rechnungspartner muss über eine aktive Weiterverkaufsbeziehung mit dem Kunden verfügen, um den direkten Unterzeichnungsstatus des Vertrags abzurufen.

C#

Rufen Sie die Methode IAggregatePartner.Customers.ById mit dem Kundenkennzeichen auf, um den Status der direkten Akzeptanz der Microsoft-Kundenvereinbarung abzurufen. Verwenden Sie dann die Eigenschaft Agreements, um eine ICustomerAgreementCollection-Schnittstelle abzurufen. Rufen Sie schließlich GetDirectSignedCustomerAgreementStatus() oder GetDirectSignedCustomerAgreementStatusAsync() auf, um den Status abzurufen.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

Beispiel: Konsolenbeispiel-App. Projekt: SdkSamples Klasse: GetDirectSignedCustomerAgreementStatus.cs

REST-Anforderung

Um den Status der direkten Akzeptanz der Microsoft-Kundenvereinbarung eines Kunden abzurufen, senden Sie eine REST-Anforderung, um den DirectSignedCustomerAgreementStatus für den Kunden abzurufen.

Anforderungssyntax

Verwenden Sie die folgende Anforderungssyntax:

Methode	Anforderungs-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

URI-Parameter

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

Name	Typ	Erforderlich	Beschreibung
customer-tenant-id	GUID	Ja	Der Wert ist eine GUID-formatierte CustomerTenantId, mit der Sie die Mandanten-ID eines Kunden angeben können.

Anforderungsheader

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

Anforderungstext

Keiner.

Anforderungsbeispiel

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-Antwort

Bei erfolgreicher Ausführung gibt die Methode eine DirectSignedCustomerAgreementStatus--Ressource im Antworttext zurück.

Die Ressource verfügt über eine isSigned-Eigenschaft, die den Status der direkten Unterzeichnung (direkte Akzeptanz) des Kunden angibt.

Ein Wert von true gibt an, dass der Vertrag direkt vom Kunden unterzeichnet (akzeptiert) wurde.
Ein Wert von false gibt an, dass die Vereinbarung nicht direkt vom Kunden unterzeichnet (akzeptiert) wurde.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und weitere 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.

Antwortbeispiel

HTTP/1.1 200 OK
Content-Length: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

Freigeben über