Delen via

Overdrachtsgegevens ophalen op id

  • Artikel

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.

Juiste rollen: Beheer agent

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameter

Gebruik de volgende padparameter om de klant te identificeren en de overdracht op te geven die moet worden geaccepteerd.

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

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

Als dit lukt, retourneert deze methode de ingevulde TransferEntity-resource in de hoofdtekst van het antwoord.

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.

Antwoordvoorbeeld voor wordt uitgevoerd

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, 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": "425829ba-6938-4b55-af29-fbbd28ebeebf",
        "partnertenantid": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "sourcePartnerName": "test",
        "sourcePartnerTenantId": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "targetPartnerEmailId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "fec7ff82-163d-4763-afb1-6947d2b0db28",
        "lineItems": [
            {
                "id": 0,
                "subscriptionId": "45e7c151-71be-4502-8fd9-576db2da4e12",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 0,
                "status": "InProgress"
            },
            {
                "id": 0,
                "subscriptionId": "10ca8b90-2fde-4f2a-dfc3-5d5b8c2d160e",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 5,
                "status": "InProgress"
            }
        ],
        "links": {
            "self": {
                "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/transfers/96978f5b-ee35-486f-96e9-a17ed4a1d87d",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }

Antwoordvoorbeeld voor wordt uitgevoerd

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, 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": "425829ba-6938-4b55-af29-fbbd28ebeebf",
        "partnertenantid": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "sourcePartnerName": "test",
        "sourcePartnerTenantId": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "targetPartnerEmailId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "35ebf490-ac97-44af-9048-d3cdac1e4c84",
        "links": {
            "self": {
                "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/transfers/2d9a20f4-532d-438d-b694-bb7ab4585508",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }

Antwoordvoorbeeld voor voltooid

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, 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": "425829ba-6938-4b55-af29-fbbd28ebeebf",
        "partnertenantid": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "sourcePartnerName": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "sourcePartnerTenantId": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "targetPartnerEmailId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "f430373f-96d2-4ba5-b3ab-6b5dc69ae44f",
        "lineItems": [
            {
                "id": 0,
                "subscriptionId": "c9716959-699a-47a3-af35-ca68ec929eaa",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 0
            },
            {
                "id": 1,
                "orderId": "bc857bb7-45ad-4667-b369-14126df2f74c",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 1
            }
        ],
        "links": {
            "self": {
                "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/transfers/1c53f090-7a5d-454f-bffa-696650863e79",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }