Tworzenie transferu dla nowego handlu przy użyciu interfejsów API REST Centrum partnerskiego

Artykuł
09/27/2024

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 elementu wiersza. 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 przenoszenia subskrypcji.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Identyfikator klienta (customer-tenant-ID). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie 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

Method	Identyfikator URI żądania
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	Type	Wymagania	opis
identyfikator klienta	string	Tak	Identyfikator GUID sformatowany przez 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 tworzenia nowego żądania przeniesienia handlu.

Właściwość	Type	Wymagania	opis
sourcePartnerTenantId	string	Tak	Identyfikator GUID sformatowany przez partnera identyfikujący partnera inicjującego transfer.
sourcePartnerName	string	Tak	Nazwa organizacji partnera, która inicjuje przeniesienie.
customerEmailId	string	Tak	Ciąg klienta do odbierania powiadomień o utworzeniu przeniesienia.
customerName	string	Nie	Opcjonalny. Nazwa klienta, którego subskrypcje są przenoszone.
targetPartnerTenantId	string	Nie	Identyfikator dzierżawy partnera sformatowany za pomocą identyfikatora GUID, który identyfikuje partnera, do którego jest kierowany transfer. Kontekst autoryzacji partnera jest rozpoznawany jako identyfikator dzierżawy partnera w przypadku pominięcia.
targetPartnerEmailId	string	Nie	Identyfikator dzierżawy partnera sformatowany za pomocą identyfikatora GUID, który identyfikuje partnera, do którego jest kierowany transfer. Kontekst autoryzacji partnera jest rozpoznawany jako identyfikator dzierżawy partnera w przypadku pominięcia.
transferType	string	Tak	Ciąg definiujący typ transferu. 3 reprezentuje NewCommerce i powinny być używane do planowania 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": "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": []
        }
    }
}

Odpowiedź REST

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

Kody powodzenia 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ę, zobacz 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": "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": []
    }
}
}

Udostępnij za pośrednictwem