Abrufen des Status der direkten Signatur eines Kunden (direkte Annahme) von 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 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: ab993325-1605-4cf4-bac4-fb584142a31b

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: ab993325-1605-4cf4-bac4-fb584142a31b

{"isSigned":true}