Utwórz transfer dla nowych operacji handlowych przy użyciu interfejsów API REST Centrum partnerskiego.

Artykuł
03/07/2025

Partnerzy mogą przenosić nowe subskrypcje handlowe od jednego partnera transakcyjnego do innego. Partner docelowy tworzy żądanie przeniesienia. Partner źródłowy aktualizuje transfer ze szczegółami pozycji na liście. W tym temacie opisano interfejs API wywoływany przez partnera docelowego w celu utworzenia żądania przeniesienia. Ten temat dotyczy tylko rezerwacji planu platformy Azure, planów oszczędnościowych i subskrypcji oraz nowych subskrypcji opartych na licencjach handlowych. Więcej cennych informacji można znaleźć w dokumentacji dotyczącej przeniesienia subskrypcji.

Wymagania wstępne

Poświadczenia zgodnie z opisem w Partner Center authentication. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu samodzielnych poświadczeń aplikacji, jak i poświadczeń aplikacji oraz użytkownika.
Identyfikator klienta (customer-tenant-ID). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Partner Center, wybierając obszar roboczy Klienci, następnie klienta z listy klientów, a potem pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-ID).
Odpowiednie role: Agent administracyjny

Żądanie REST

Składnia żądania

Metoda	Żądanie URI
POST	{baseURL}/v1/customers/{customer-ID}/transfery HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru ścieżki, aby zidentyfikować klienta.

Nazwisko	Typ	Wymagane	opis
identyfikator klienta	string	Tak	Sformatowany jako GUID identyfikator klienta, który identyfikuje klienta.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

W tej tabeli opisano właściwości TransferEntity w treści żądania utworzenia nowego żądania transferu handlowego.

Właściwość	Typ	Wymagane	opis
sourcePartnerTenantId	string	Tak	Identyfikator partnera w formacie GUID, identyfikujący partnera inicjującego transfer.
sourcePartnerName	string	Tak	Nazwa organizacji partnera, która inicjuje przeniesienie.
customerEmailId	string	Tak	Dane klienta do odbierania powiadomień o utworzeniu transferu.
nazwaKlienta	string	Nie	Opcjonalny. Nazwa klienta, którego subskrypcje są przenoszone.
targetPartnerTenantId	string	Nie	Identyfikator dzierżawy partnera w formacie GUID, który wskazuje partnera, do którego jest kierowany transfer. Kontekst autoryzacji partnera jest rozpoznawany jako identyfikator dzierżawy partnera w przypadku pominięcia.
IdentyfikatorEmailDocelowegoPartnera	string	Nie	Identyfikator dzierżawy partnera w formacie GUID, który wskazuje partnera, do którego jest skierowany transfer. Kontekst autoryzacji partnera staje się identyfikatorem dzierżawy partnera w przypadku pominięcia.
doceloweTypyProduktów	string	Nie	Kolekcja ciągów określających typy subskrypcji, które można zgłosić do przeniesienia. Przyjmuje się, że wszystkie typy mają wartość Null. Wartości mogą obejmować AzureSubscription, AzureReservation, AzureSavingsPlan i OnlineServicesNCE.
typ transferu	string	Tak	Ciąg definiujący typ transferu. 3 reprezentuje NewCommerce i powinno być używane do planu platformy Azure i nowych subskrypcji opartych na licencjach handlowych.

Przykład żądania

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

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca wypełniony zasób TransferEntity w treści odpowiedzi.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, sprawdź Kody błędów.

Przykład odpowiedzi

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

Udostępnij za pośrednictwem