Übertragungs Details nach ID erhaltenGet transfer details by id

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
GETGET {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 den folgenden path-Parameter, um den Kunden zu identifizieren und die zu akzeptierende Übertragung anzugeben.Use the following path parameter to identify the customer and specify the transfer to be accepted.

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

GET /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/46e8ed67-8adf-4f65-b3d8-d31318080556 HTTP/1.1
Authorization: Bearer <token>
Connection: keep-alive
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
MS-CorrelationId: 68eacc61-971c-43b0-c06f-2622bf79b090
Accept: application/json

REST-AntwortREST response

Bei erfolgreicher Ausführung gibt diese Methode die aufgefüllte transferentity -Ressource im Antworttext zurück.If successful, this method returns the populated TransferEntity resource in the response body.

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 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 68eacc61-971c-43b0-c06f-2622bf79b090
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 27 Mar 2020 18:25:25 GMT

{
  "id": "46e8ed67-8adf-4f65-b3d8-d31318080556",
  "status": "Active",
  "createdTime": "2020-03-27T18:22:33.2875302Z",
  "lastModifiedTime": "2020-03-27T18:22:33Z",
  "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": "edc0524d-2e42-4619-af7e-349c015cfdfd",
  "lineItems": [
    {
      "id": 0,
      "subscriptionId": "75B71186-73C3-45B4-A403-281C0D7EB032",
      "offerId": "F72752C8-3E37-4C9B-A1A0-69E8442068DC",
      "billingCycle": "annual",
      "friendlyName": "Dynamics 365 Business Central Team Member",
      "quantity": 1,
      "partnerIdOnRecord": "5139005",
      "addonItems": [

      ]
    },
    {
      "id": 1,
      "subscriptionId": "1FB4CB0A-EB79-4300-9E87-7D486054888A",
      "offerId": "88F9EB8A-0636-45E8-A601-553E0A48AA9E",
      "billingCycle": "annual",
      "friendlyName": "Dynamics 365 Business Central External Accountant",
      "quantity": 1,
      "partnerIdOnRecord": "5139005",
      "addonItems": [

      ]
    },
    {
      "id": 2,
      "subscriptionId": "08AB3010-B647-402E-8955-B6C0FB364D8F",
      "offerId": "4D8F3B90-29B3-4E7B-B37C-4A435DDEF1D9",
      "billingCycle": "annual",
      "friendlyName": "Common Area Phone",
      "quantity": 1,
      "partnerIdOnRecord": "5139005",
      "addonItems": [

      ]
    }
  ],
  "links": {
    "self": {
      "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/46e8ed67-8adf-4f65-b3d8-d31318080556",
      "method": "GET",
      "headers": [

      ]
    }
  },
  "attributes": {
    "objectType": "TransferEntity"
  }
}