Tworzenie nowej migracji handlowej

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Jak utworzyć migrację subskrypcji do New Commerce Experience

Warunki wstępne

• Poświadczenia, jak opisano w uwierzytelnianiu Centrum Partnerskiego. Ten scenariusz obsługuje uwierzytelnianie przy użyciu zarówno autonomicznych poświadczeń aplikacji, jak i połączonych poświadczeń 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 klient z listy klientów, a następnie konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).

• Bieżący identyfikator subskrypcji

Limit szybkości

Limit interfejsu API tworzenia migracji wynosi 100 połączeń przez partnera w ciągu 5 minut. Więcej informacji na temat limitów szybkości i ograniczania przepływności można znaleźć na stronie wskazówki dotyczące ograniczania przepustowości interfejsu API.

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1

Parametr identyfikatora URI

W tej tabeli wymieniono wymagane parametry zapytania w celu utworzenia nowej migracji handlowej.

Nazwa	Typ	Wymagane	Opis
identyfikator klienta-dzierżawy	struna	Tak	Ciąg w formacie GUID, który służy do identyfikacji 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 subskrypcji w treści żądania.

Własność	Typ	Wymagane	Opis
obecnySubskrypcjaId	struna	Tak	Identyfikator subskrypcji wskazujący, która z subskrypcji wymaga weryfikacji pod kątem migracji.
czas trwania umowy	struna	Nie	Czas trwania terminu można zmienić podczas migracji.
billingCycle	struna	Nie	Cykl rozliczeniowy można zmienić podczas migracji.
zakup pełnego okresu	bool	Nie	Po migracji można rozpocząć nowy okres w platformie NCE.
ilość	Int	Nie	Ilość licencji dla subskrypcji można zwiększyć lub zmniejszyć podczas migracji.
customTermEndDate	znacznik czasu	Nie	Datę końcową można ustawić tak, aby był zgodny z istniejącą nietrialną subskrypcją usługi OnlineServicesNCE lub miesiącem kalendarzowym. Więcej informacji na temat dopasowywania dat zakończenia subskrypcji znajduje się tutaj: Dopasuj daty zakończenia subskrypcji w Centrum partnerskim

Przykład żądania

Należy pamiętać, że zagnieżdżone dodatki (subskrypcje dodatków z subskrypcjami dodatków) powinny być zapisywane w treści żądania jako płaska lista w ramach addOnMigrations, a nie jako zagnieżdżone wewnątrz innych subskrypcji dodatków w tym żądaniu. Zobacz ostatni przykład żądania, aby dowiedzieć się, jak można zapisać dodatki w treści żądania.

{
    "currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
} 

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca szczegóły Subskrypcje migrowane (obiekt migracji) 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 dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu, inne parametry. Aby uzyskać pełną listę, zobacz Centrum Partnerów Kody błędów REST.

Przykłady odpowiedzi

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}