Ottenere i dettagli del trasferimento in base all'ID

Articolo
03/09/2025

Prerequisiti

Credenziali come descritte in autenticazione del Partner Center. Questo scenario supporta l'autenticazione con credenziali App autonoma e App+Utente.
Un ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo in Centro per i partner selezionando l'area di lavoro clienti, quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare il ID Microsoft nella sezione informazioni sull'account cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).
Identificatore di trasferimento per un trasferimento esistente.

ruoli appropriati: agente di amministrazione

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1

Parametro URI

Usare il parametro path seguente per identificare il cliente e specificare il trasferimento da accettare.

Nome	Digitare	Obbligatorio	Descrizione
id cliente	corda	Sì	Un ID cliente formattato GUID che identifica il cliente.
transfer-id	corda	Sì	Un transfer-id formattato GUID che identifica il trasferimento.

Intestazioni della richiesta

Per ulteriori informazioni, vedere intestazioni REST di *Partner Center*.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce la risorsa popolata TransferEntity nel corpo della risposta.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere codici di errore .

Esempio di risposta in lavorazione

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"
        }
    }

Esempio di risposta per 'in corso'

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"
        }
    }

Esempio di risposta completata

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"
        }
    }

Condividi tramite