Freigeben über

Abrufen von Übertragungsdetails nach ID

  • Artikel

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

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {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.

Anforderungsbeispiel

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: aaaa0000-bb11-2222-33cc-444444dddddd
Accept: application/json

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.

Antwortbeispiel für in Bearbeitung

HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT

{
        "id": "96978f5b-ee35-486f-96e9-a17ed4a1d87d",
        "status": "InProgress",
        "transferType": 3,
        "customerEmailId": "",
        "createdTime": "2024-04-09T22:45:06.7851706Z",
        "lastModifiedTime": "2024-04-10T17:26:56Z",
        "customerName": "legacytomodern09022021",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
        "sourcePartnerName": "test",
        "sourcePartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
        "targetPartnerEmailId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "fec7ff82-163d-4763-afb1-6947d2b0db28",
        "lineItems": [
            {
                "id": 0,
                "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 0,
                "status": "InProgress"
            },
            {
                "id": 0,
                "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 5,
                "status": "InProgress"
            }
        ],
        "links": {
            "self": {
                "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/96978f5b-ee35-486f-96e9-a17ed4a1d87d",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }

Antwortbeispiel für in Bearbeitung

HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT

{
        "id": "2d9a20f4-532d-438d-b694-bb7ab4585508",
        "status": "Pending",
        "transferType": 3,
        "customerEmailId": "",
        "createdTime": "2024-05-09T18:53:13.8486497Z",
        "lastModifiedTime": "2024-05-09T18:53:14Z",
        "customerName": "legacytomodern09022021",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
        "sourcePartnerName": "test",
        "sourcePartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
        "targetPartnerEmailId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "35ebf490-ac97-44af-9048-d3cdac1e4c84",
        "links": {
            "self": {
                "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/2d9a20f4-532d-438d-b694-bb7ab4585508",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }

Antwortbeispiel für abgeschlossen

HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT

{
        "id": "1c53f090-7a5d-454f-bffa-696650863e79",
        "status": "Complete",
        "transferType": 3,
        "customerEmailId": "",
        "createdTime": "2024-04-24T19:29:58.4656093Z",
        "lastModifiedTime": "2024-04-24T19:38:22Z",
        "completedTime": "2024-04-24T19:36:12.7197415Z",
        "customerName": "legacytomodern09022021",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
        "sourcePartnerName": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
        "sourcePartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
        "targetPartnerEmailId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "f430373f-96d2-4ba5-b3ab-6b5dc69ae44f",
        "lineItems": [
            {
                "id": 0,
                "subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 0
            },
            {
                "id": 1,
                "orderId": "bc857bb7-45ad-4667-b369-14126df2f74c",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 1
            }
        ],
        "links": {
            "self": {
                "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/1c53f090-7a5d-454f-bffa-696650863e79",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }