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

Articolo
03/07/2025

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 aggiorna il trasferimento con i dettagli della voce di linea. 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. Maggiori informazioni utili si possono trovare nella documentazione sul trasferimento delle sottoscrizioni.

Prerequisiti

Credenziali come descritto in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione sia con le credenziali dell'App autonoma che con quelle di App+Utente.
ID cliente (customer-tenant-ID). Se non si conosce l'ID del cliente, è possibile cercarlo nel Partner Center selezionando l'area 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 è lo stesso dell'ID 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	Sì	Un customer-id nel formato GUID che identifica il cliente.

Intestazioni delle richieste

Per ulteriori informazioni, vedere Intestazioni REST del Centro per i Partner.

Testo della richiesta

Questa tabella descrive le proprietà di TransferEntity nel corpo della richiesta per creare una nuova richiesta di trasferimento nel commercio.

Proprietà	Tipo	Obbligatorio	Descrizione
sourcePartnerTenantId	string	Sì	L'ID del partner formattato come GUID che identifica il partner che avvia il trasferimento.
sourcePartnerName	string	Sì	Nome dell'organizzazione del partner che avvia il trasferimento.
customerEmailId	string	Sì	Stringa del cliente per ricevere notifiche sulla creazione del trasferimento.
nomeCliente	string	No	(Facoltativo). Nome del cliente le cui sottoscrizioni vengono trasferite.
targetPartnerTenantId	string	No	Partner tenant ID formattato come GUID che identifica il partner per il quale è destinato il trasferimento. Se omesso, il contesto di autorizzazione del partner viene risolto nell'ID tenant del partner.
targetPartnerEmailId	string	No	ID partner tenant formattato GUID che identifica il partner per cui è destinato il trasferimento. Se omesso, il contesto di autorizzazione del partner viene risolto nell'ID tenant del partner.
tipiDiProdottoDestinati	string	No	Raccolta di stringhe che determinano i tipi di sottoscrizioni che possono essere inviate per un trasferimento. Si presuppone che tutti i tipi siano null. I valori possono includere AzureSubscription, AzureReservation, AzureSavingsPlan e OnlineServicesNCE.
tipo di trasferimento	string	Sì	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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
    "sourcePartnerName": "Test_Test_IP4_AG",
    "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerName": "Test_Test_DB_AG",
    "targetPartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
    "targetProductTypes": [
	    "AzureSubscription",
	    "AzureReservation",
	    "AzureSavingsPlan",
	    "OnlineServicesNCE“
	],
    "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/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
            "method": "GET",
            "headers": []
        }
    }
}

Risposta REST

In caso di esito positivo, questo metodo restituisce la risorsa TransferEntity 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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetProductTypes": [
    "AzureSubscription",
    "AzureReservation",
    "AzureSavingsPlan",
    "OnlineServicesNCE“
	],
"transferDirection": 1,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "7ffdaa28-3b1c-4a61-b580-e1aa6ecf833c",
"links": {
    "self": {
        "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
        "method": "GET",
        "headers": []
    }
}
}

Condividi tramite