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

Articolo
09/27/2024

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	Sì	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	Sì	ID partner formattato con 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.
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	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": "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": "d0df8837-6db3-49d8-c2b3-1d94bc1ab42d",
        "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: 0e93c70c-977c-4a88-9580-7cf084c73286
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": []
    }
}
}

Condividi tramite