Zurücknehmen einer Übertragung

Artikel
05/23/2024

Hinweis

Dieses Thema gilt nur für herkömmliche lizenzbasierte Dienste und nicht für neue Handelserfahrungen. Weitere Informationen zum Übertragen neuer lizenzbasierter E-Commerce-Abonnements finden Sie im neuen Thema zum Übertragen von E-Commerce-Lizenzen.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
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).
Ein Übertragungsbezeichner für eine vorhandene Übertragung.

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
DELETE	{baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1

URI-Parameter

Verwenden Sie zum Identifizieren des Kunden die folgenden Pfadparameter:

Name	Type	Erforderlich	Beschreibung
customer-id	Zeichenfolge	Ja	Eine guid formatierte Kunden-ID, die den Kunden identifiziert.
Transfer-ID	Zeichenfolge	Ja	Eine GUID-formatierte Übertragungs-ID, die die Übertragung identifiziert.

Anforderungsheader

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

Anforderungsbeispiel

DELETE /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/transfers/67c5b05b-09b5-47ba-9047-5056fe2afa4f HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: cdf6e25c-7b32-4cc3-d8bc-53e0b37eebd8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Connection: keep-alive

REST-Antwort

Wenn die Methode erfolgreich verläuft, werden keine Inhalte (204) zurückgegeben.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Beispielantwort

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: cdf6e25c-7b32-4cc3-d8bc-53e0b37eebd8
Date: Tue, 24 Mar 2020 23:44:06 GMT

Freigeben über