Abrufen des Status der direkten Signatur eines Kunden (direkte Annahme) von Microsoft-Kundenvereinbarung

Artikel
03/05/2024

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 DirectSignedCustomerAgreementStatus-Ressource wird derzeit nur von Partner Center in der öffentlichen Microsoft-Cloud unterstützt.

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

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
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).

C#

Um den Status der direkten Annahme des Microsoft-Kundenvereinbarung eines Kunden abzurufen, rufen Sie die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID auf. Verwenden Sie dann die Agreements-Eigenschaft, um eine ICustomerAgreementCollection-Schnittstelle abzurufen. Rufen Sie GetDirectSignedCustomerAgreementStatus() schließlich den Status auf, oder GetDirectSignedCustomerAgreementStatusAsync() rufen Sie ihn ab.

// 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 Annahme des Microsoft-Kundenvereinbarung eines Kunden abzurufen, erstellen 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	Type	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

Keine.

Beispiel für eine Anfrage

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 Direktsignierungsstatus (Direct Acceptance) des Kunden angibt.

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

Erfolgs- und Fehlercodes der Antwort

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.

Beispielantwort

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