Condividi tramite


Creare un trasferimento per un nuovo commercio usando le API REST del Centro per i partner

I partner possono trasferire nuove sottoscrizioni commerciali da un partner di transazione a un altro. Un partner di destinazione crea la richiesta di trasferimento. Il partner di origine aggiorna il trasferimento con i dettagli dell'elemento della riga. Questo argomento illustra l'API che un partner di destinazione chiamerebbe per creare la richiesta di trasferimento. Questo argomento è rilevante solo per le prenotazioni del piano di Azure, i piani di risparmio e le sottoscrizioni e le nuove sottoscrizioni basate sulle licenze commerciali. Altre informazioni utili sono disponibili nella documentazione relativa al trasferimento delle sottoscrizioni.

Prerequisiti

  • Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.

  • ID cliente (customer-tenant-ID). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-ID).

  • Ruoli appropriati: agente di amministrazione

Richiesta REST

Sintassi della richiesta

metodo URI della richiesta
POST {baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1

Parametro URI

Usare il parametro di percorso seguente per identificare il cliente.

Nome Digita Obbligatorio Descrizione
customer-id string GUID formattato con ID cliente che identifica il cliente.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Questa tabella descrive le proprietà TransferEntity nel corpo della richiesta per la creazione di una nuova richiesta di trasferimento commerciale.

Proprietà Type Obbligatorio Descrizione
sourcePartnerTenantId string ID partner formattato con GUID che identifica il partner che avvia il trasferimento.
sourcePartnerName string Nome dell'organizzazione del partner che avvia il trasferimento.
customerEmailId string Stringa del cliente per ricevere notifiche sulla creazione del trasferimento.
customerName string No (Facoltativo). Nome del cliente le cui sottoscrizioni vengono trasferite.
targetPartnerTenantId string No ID tenant partner formattato CON GUID che identifica il partner a cui è destinato il trasferimento. Se omesso, il contesto di autorizzazione del partner viene risolto nell'ID tenant del partner.
targetPartnerEmailId string No ID tenant partner formattato CON GUID che identifica il partner a cui è destinato il trasferimento. Se omesso, il contesto di autorizzazione del partner viene risolto nell'ID tenant del partner.
transferType string Stringa che definisce il tipo di trasferimento. 3 rappresenta New Commerce e deve essere usato per il piano di Azure e le nuove sottoscrizioni basate sulle licenze commerciali.

Esempio di richiesta

{
    "id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
    "status": "InProgress",
    "transferType": 3,
    "customerEmailId": "",
    "createdTime": "2024-04-30T18:31:41.5133355Z",
    "lastModifiedTime": "2024-05-01T00:51:55Z",
    "expirationTime": "2024-05-31T00:00:00Z",
    "customerName": "ipdbtrans2",
    "customerTenantId": "a624f7f8-408b-49d0-9320-df79e56bed55",
    "partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
    "sourcePartnerName": "Test_Test_IP4_AG",
    "sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
    "targetPartnerName": "Test_Test_DB_AG",
    "targetPartnerTenantId": "817512dd-0689-47a0-bbf2-a7f11ae1fc11",
    "targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
    "transferDirection": 2,
    "ignoreEligibilityCheck": false,
    "lastModifiedUser": "1671774b-679f-4543-a152-1f8b14006c0e",
    "lineItems": [{
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "billingCycle": "unknown",
        "quantity": 0,
        "productType": 5,
        "status": "InProgress"
    }],
    "links": {
        "self": {
            "uri": "/customers/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
            "method": "GET",
            "headers": []
        }
    }
}

Risposta REST

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

Codici di errore e di esito 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 questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US,en-US

{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "Pending",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-04-30T18:31:41Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "a624f7f8-408b-49d0-9320-df79e56bed55",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"transferDirection": 1,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "7ffdaa28-3b1c-4a61-b580-e1aa6ecf833c",
"links": {
    "self": {
        "uri": "/customers/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
        "method": "GET",
        "headers": []
    }
}
}