Übertragung zurückziehenWithdraw a transfer

Gilt für:Applies to:

  • Partner CenterPartner Center

VoraussetzungenPrerequisites

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben.Credentials as described in Partner Center authentication. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen APP-und App-Anmelde Informationen.This scenario supports authentication with both standalone App and App+User credentials.

  • Eine Kunden-ID (customer-tenant-id).A customer ID (customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, finden Sie diese im Partner Center-Dashboard.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Wählen Sie im Partner Center-Menü CSP und dann Kunden aus.Select CSP from the Partner Center menu, followed by Customers. Wählen Sie den Kunden aus der Kundenliste aus, und wählen Sie dann Konto aus.Select the customer from the customer list, then select Account. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Ein Übertragungs Bezeichner für eine vorhandene Übertragung.A transfer identifier for an existing transfer.

REST-AnforderungREST request

AnforderungssyntaxRequest syntax

MethodeMethod Anforderungs-URIRequest URI
DELETEDELETE {baseurl}/v1/Customers/{Customer-ID}/Transfers/{Transfer-ID} HTTP/1.1{baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1

URI-ParameterURI parameter

Verwenden Sie zum Identifizieren des Kunden die folgenden Pfadparameter:Use the following path parameter to identify the customer.

NameName typeType ErforderlichRequired BESCHREIBUNGDescription
Kunden-IDcustomer-id Zeichenfolgestring JaYes Eine GUID-formatierte Kunden-ID, die den Kunden identifiziert.A GUID formatted customer-id that identifies the customer.
Übertragungs-IDtransfer-id Zeichenfolgestring JaYes Eine GUID-formatierte Übertragungs-ID, die die Übertragung identifiziert.A GUID formatted transfer-id that identifies the transfer.

AnforderungsheaderRequest headers

Weitere Informationen finden Sie unter Partner Center-REST-Header.For more information, see Partner Center REST headers.

AnforderungsbeispielRequest example

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: 9041d76d-8915-43a8-8e82-00ca46a1a73d
Connection: keep-alive

REST-AntwortREST response

Bei erfolgreicher Ausführung gibt diese Methode keinen Inhalt zurück (204).If successful, this method returns No Content (204).

Erfolgs- und Fehlercodes der AntwortResponse success and error codes

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen.Use a network trace tool to read this code, error type, and additional parameters. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.For the full list, see Error Codes.

AntwortbeispielResponse example

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: 9041d76d-8915-43a8-8e82-00ca46a1a73d
MS-RequestId: cdf6e25c-7b32-4cc3-d8bc-53e0b37eebd8
Date: Tue, 24 Mar 2020 23:44:06 GMT