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

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.

Název 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 ř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.
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.
partnerOnRecord řetězec Ne MPNID oficiálního partnera pro převedené položky řádkového předplatného. Platí pouze při převodu na nepřímé cílové partnery poskytovatele.
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",
    "partnerOnRecord": "456789",
    "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.

Některé běžné chyby, které se vyskytnou při vytváření přenosu distributory:

  • Nesprávný účet umístění partnera (PLA): Distributoři musí deklarovat partnera záznamu pro převedené položky. Neplatné ID partnera vrátí kód chyby 900400 se zprávou ID PLA (dříve ID MPN) není propojeno s žádným aktivním tenantem prodejce.
  • ID tenanta jsou nesprávná: Nesprávné ID tenanta zdrojového partnera způsobí kód chyby 900160 a zpráva "Žádost o převod selhala, protože aktuální ID partnera Microsoftu je neplatné nebo neaktivní. Pokud chcete získat správné ID Microsoftu, obraťte se na aktuálního partnera zákazníka. Nesprávné ID tenanta zákazníka způsobí chybu 20002 a zpráva , že zdrojový partner nemá žádný obchodní vztah s ID zákazníka.

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",
"partnerOnRecord": "456789",
"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": []
    }
}
}
  • Last updated on