Dra tillbaka en överföring
Kommentar
Det här avsnittet gäller endast för traditionella licensbaserade tjänster och inte för nya handelsupplevelser. Mer information om hur du överför nya licensbaserade prenumerationer för handel finns i avsnittet om ny handelsöverföring.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett kund-ID (
customer-tenant-id
). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id
).En överföringsidentifierare för en befintlig överföring.
REST-begäran
Syntax för begäran
Metod | URI för förfrågan |
---|---|
DELETE | {baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1 |
URI-parameter
Använd följande sökvägsparameter för att identifiera kunden.
Namn | Typ | Obligatoriskt | Beskrivning |
---|---|---|---|
kund-ID | sträng | Ja | Ett GUID-formaterat kund-ID som identifierar kunden. |
transfer-id | sträng | Ja | Ett GUID-formaterat överförings-ID som identifierar överföringen. |
Begärandehuvuden
Mer information finns i REST-huvuden för Partnercenter.
Exempel på begäran
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-svar
Om det lyckas returnerar den här metoden inget innehåll (204).
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.
Svarsexempel
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