Delen via

Een overdracht intrekken

  • Artikel

Notitie

Dit onderwerp is alleen van toepassing op traditionele services op basis van licenties en niet op nieuwe commerce-ervaringen. Zie het onderwerp nieuwe commerceoverdracht voor meer informatie over het overdragen van nieuwe commercelicentieabonnementen.

Vereisten

  • Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

  • Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

  • Een overdrachts-id voor een bestaande overdracht.

REST-aanvraag

Aanvraagsyntaxis

Wijze Aanvraag-URI
DELETE {baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1

URI-parameter

Gebruik de volgende padparameter om de klant te identificeren.

Name Type Vereist Beschrijving
klant-id tekenreeks Ja Een door DE GUID opgemaakte klant-id die de klant identificeert.
transfer-id tekenreeks Ja Een met GUID opgemaakte overdrachts-id die de overdracht identificeert.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagvoorbeeld

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-antwoord

Als dit lukt, retourneert deze methode Geen inhoud (204).

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

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