Vytvoření přenosu pro nový obchod pomocí rozhraní REST API Partnerského centra

Článek
03/08/2025

Partneři můžou převést nová komerční předplatná od jednoho partnera, který provádí transakce, do jiného. Cílový partner vytvoří žádost o převod. Zdrojový partner aktualizuje transfer detaily položky. Toto téma vysvětluje rozhraní API, které by cílový partner volal za účelem vytvoření žádosti o převod. Toto téma je relevantní jenom pro rezervace plánů Azure, plány úspor a předplatná a nová předplatná založená na obchodních licencích. Více cenných informací najdete v dokumentaci k převodu předplatných.

Požadavky

Přihlašovací údaje, jak jsou popsány v ověřování Partnerského centra. Tento scénář podporuje autentizaci pomocí samostatných přihlašovacích údajů aplikace i kombinovaných přihlašovacích údajů aplikace a uživatele.
ID zákazníka (customer-tenant-ID). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci, poté zákazníka ze seznamu zákazníků, a nakonec Účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-ID).
Příslušné role: Agent pro správu

Požadavek REST

Syntaxe požadavku

metoda	URI žádosti
POST	{baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1

Parametr identifikátoru URI

Pomocí následujícího parametru cesty identifikujte zákazníka.

Name	Typ	Požadováno	Popis
ID zákazníka	řetězec	Ano	Identifikátor zákazníka ve formátu GUID, který identifikuje zákazníka.

Hlavičky žádosti

Další informace najdete v části Partner Center REST headers.

Tělo žádosti

Tato tabulka popisuje vlastnosti TransferEntity v textu požadavku pro vytvoření nového požadavku na převod obchodu.

Nemovitost	Typ	Požadováno	Popis
sourcePartnerTenantId	řetězec	Ano	Identifikátor partnera ve formátu GUID, který identifikuje partnera zahajujícího převod.
sourcePartnerName	řetězec	Ano	Název organizace partnera, který zahájí převod.
customerEmailId	řetězec	Ano	Řetězec zákazníka, který obdrží oznámení o vytvoření převodu.
názevZákazníka	řetězec	Ne	Nepovinné. Jméno zákazníka, jehož předplatná se převádějí.
cílovýPartnerTenantId	řetězec	Ne	ID tenanta s formátem GUID, které identifikuje partnera, na kterého je převod cílený. Kontext autorizace partnera se v případě vynechání přeloží na ID tenanta partnera.
IdentifikátorEmailuCílovéhoPartnera	string	Ne	ID tenanta s formátem GUID, které identifikuje partnera, na kterého je převod cílený. Kontext autorizace partnera se, pokud je vynechán, stanoví na ID tenanta partnera.
cílové typy produktů	řetězec	Ne	Kolekce řetězců, které určují, jaké typy předplatných lze předat k převodu. Předpokládá se, že null je přijatelný pro všechny typy. Mezi hodnoty patří AzureSubscription, AzureReservation, AzureSavingsPlan a OnlineServicesNCE.
typ přenosu	řetězec	Ano	Řetězec definující typ přenosu. 3 představuje NewCommerce a měl by se používat pro plány Azure a nová předplatná v rámci nové komerční platformy.

Příklad požadavku

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

Odpověď REST

Pokud je tato metoda úspěšná, vrátí naplněný prostředek TransferEntity v těle odpovědi.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

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

Sdílet prostřednictvím