Skapa en överföring för ny handel med hjälp av REST-API:er för Partnercenter

Artikel
09/20/2024

Partner kan överföra nya handelsprenumerationer från en transaktionspartner till en annan. En målpartner skapar överföringsbegäran. Källpartnern uppdaterar överföringen med information om radobjekt. I det här avsnittet beskrivs api:et som en målpartner anropar för att skapa överföringsbegäran. Det här avsnittet är endast relevant för Azure-planreservationer, sparplaner och prenumerationer och nya licensbaserade prenumerationer för handel. Mer värdefull information finns i dokumentationen om prenumerationsöverföring.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-ID). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-ID).
Lämpliga roller: Administratörsagent

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
POST	{baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1

URI-parameter

Använd följande sökvägsparameter för att identifiera kunden.

Namn	Typ	Obligatoriskt	Beskrivning
kund-ID	sträng	Ja	Ett GUID-formaterat kund-ID som identifierar kunden.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

I den här tabellen beskrivs egenskaperna TransferEntity i begärandetexten för att skapa en ny begäran om handelsöverföring.

Property	Type	Obligatoriskt	Beskrivning
sourcePartnerTenantId	sträng	Ja	Ett GUID-formaterat partner-ID som identifierar partnern som initierar överföringen.
sourcePartnerName	sträng	Ja	Namnet på den partnerorganisation som initierar överföringen.
customerEmailId	sträng	Ja	En sträng av kunden för att ta emot meddelanden om att överföringen har skapats.
customerName	sträng	Nej	Valfritt. Namnet på kunden vars prenumerationer överförs.
targetPartnerTenantId	sträng	Nej	Ett GUID-formaterat partnerklient-ID som identifierar den partner som överföringen är riktad till. Partnerauktoriseringskontexten matchar partnerklient-ID:t om det utelämnas.
targetPartnerEmailId	sträng	Nej	Ett GUID-formaterat partnerklient-ID som identifierar den partner som överföringen är riktad till. Partnerauktoriseringskontexten matchar partnerklient-ID:t om det utelämnas.
transferType	sträng	Ja	En sträng som definierar typ av överföring. 3 representerar NewCommerce och bör användas för Azure-abonnemang och nya licensbaserade prenumerationer för handel.

Exempel på begäran

{
    "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": []
        }
    }
}

REST-svar

Om det lyckas returnerar den här metoden den ifyllda TransferEnity-resursen i svarstexten.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och mer felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och fler parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

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": []
    }
}
}

Dela via