Verifiera en prenumeration för migrering

Artikel
10/28/2024

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Verifiera en prenumeration för migrering till New Commerce Experience

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).
Ett aktuellt prenumerations-ID

Hastighetsgräns

Api-gränsen för verifieringsmigrering är 450 anrop per partner-kund-kombination på 5 minuter. Mer information om hastighetsbegränsningar och begränsning finns i vägledningen för API-begränsning.

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

URI-parameter

Den här tabellen visar de frågeparametrar som krävs för att verifiera en prenumeration för migrering.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.
termDuration	sträng	Nej	Termens varaktighet kan ändras vid migrering.
billingCycle	sträng	Nej	Faktureringscykeln kan ändras vid migrering.
purchaseFullTerm	bool	Nej	En ny term kan startas i NCE vid migrering.
kvantitet	heltal	Nej	Licenskvantiteten för en prenumeration kan ökas eller minskas vid migrering.
customTermEndDate	datetime	Nej	Ett slutdatum kan anges så att det överensstämmer med en befintlig onlinetjänstprenumeration eller kalendermånad. Det finns mer information om hur du justerar prenumerationens slutdatum här: Justera prenumerationens slutdatum i Partnercenter

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Den här tabellen beskriver prenumerationsegenskaperna i begärandetexten.

Property	Type	Obligatoriskt	Beskrivning
currentSubscriptionId	sträng	Ja	En prenumerationsidentifierare som anger vilken prenumeration som kräver validering för migrering.

Exempel på begäran

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

REST-svar

Om det lyckas returnerar den här metoden ett "isEligible"-booleskt värde i svarstexten, vilket anger om den aktuella prenumerationen är berättigad till migrering till ny handel. Observera att API:et Verifiera migrering inte innehåller information om en prenumerations berättigande till kampanjer i New Commerce.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och extral felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }

Dela via