Abrufen des Status der direkten Signatur eines Kunden (direkte Annahme) von Microsoft-Kundenvereinbarung
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}