Avvisa 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.
Lämpliga roller: Global administratör | Administratörsagent | Försäljningsagent
REST-begäran
Syntax för begäran
Metod | URI för förfrågan |
---|---|
LAPP | {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 och ange vilken överföring som ska godkännas.
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.
Begärandetext
I den här tabellen beskrivs egenskaperna TransferEntity i begärandetexten.
Property | Type | Obligatoriskt | Beskrivning |
---|---|---|---|
id | sträng | Nej | En transferEntity-identifierare som tillhandahålls när överföringenEntity har skapats. |
status | sträng | Nej | Status för transferEntity. Om du vill avvisa en överföring ska värdet anges som "avvisa" |
Exempel på begäran
PATCH /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: efa4c6f5-153a-4f76-e458-1375e181cc14
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
Connection: keep-alive
Content-Length: 63
{"id":"ac4a9d22-ba07-444e-890f-cfe084eed498","status":"reject"}
REST-svar
Om det lyckas returnerar den här metoden den ifyllda TransferEntity-resursen i svarstexten.
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 200 OK
Content-Length: 1069
Content-Type: application/json; charset=utf-8
MS-CorrelationId: efa4c6f5-153a-4f76-e458-1375e181cc14
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
X-Locale: en-US
Date: Fri, 27 Mar 2020 17:50:33 GMT
{
"id": "ac4a9d22-ba07-444e-890f-cfe084eed498",
"status": "Reject",
"createdTime": "2020-03-25T22:05:25.1057725Z",
"lastModifiedTime": "2020-03-27T17:50:32Z",
"customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
"partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
"sourcePartnerName": "Test_Test_09092019GBL",
"sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
"targetPartnerName": "Test_Test_09032019GBL",
"targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
"lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
"lineItems": [
{
"id": 0,
"subscriptionId": "1151B8CE-125C-49D7-8C48-E62FC9101B77",
"offerId": "13D32E13-A1B0-400D-96C0-4EAAA14DCED5",
"billingCycle": "monthly",
"friendlyName": "Dynamics 365 for Supply Chain Management Attach to Qualifying Dynamics 365 Base Offer (Qualified Offer)",
"quantity": 20,
"partnerIdOnRecord": "5139005",
"addonItems": [
]
}
],
"links": {
"self": {
"uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498",
"method": "GET",
"headers": [
]
}
},
"attributes": {
"objectType": "TransferEntity"
}
}