Ablehnen einer Übertragung

Artikel
09/20/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 Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
Ein Übertragungsbezeichner für eine vorhandene Übertragung.

Geeignete Rollen: Administrator-Agent | Vertriebsbeauftragter

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Verwenden Sie den folgenden Pfadparameter, um den Kunden zu identifizieren und die zu akzeptierende Übertragung anzugeben.

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.

Anforderungstext

In dieser Tabelle werden die TransferEntity-Eigenschaften im Anforderungstext beschrieben.

Eigenschaft	Type	Erforderlich	Beschreibung
id	Zeichenfolge	No	Ein transferEntity-Bezeichner, der bei erfolgreicher Erstellung der transferEntity bereitgestellt wird.
status	Zeichenfolge	No	Der Status der transferEntity. Um eine Übertragung abzulehnen, muss der Wert als "ablehnen" festgelegt werden.

Anforderungsbeispiel

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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
Connection: keep-alive
Content-Length: 63

{"id":"ac4a9d22-ba07-444e-890f-cfe084eed498","status":"reject"}

REST-Antwort

Bei erfolgreicher Ausführung gibt die Methode die aufgefüllte TransferEntity-Ressource im Antworttext zurück.

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 200 OK
Content-Length: 1069
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
  "sourcePartnerName": "Test_Test_09092019GBL",
  "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "targetPartnerName": "Test_Test_09032019GBL",
  "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
  "lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
  "lineItems": [
    {
      "id": 0,
      "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "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"
  }
}

Freigeben über