Een nieuwe commercemigratie maken

van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Een migratie van een abonnement maken naar New Commerce Experience

Voorwaarden

• Referenties zoals beschreven in Partnercentrum-authenticatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

• Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

• Een huidige abonnements-id

Frequentielimiet

De limiet voor de Create Migration API is 100 aanroepen door een partner in vijf minuten. Meer informatie over frequentielimieten en bandbreedtebeperking is beschikbaar op API-beperkingsrichtlijnen.

REST-aanvraag

Aanvraagsyntaxis

Methode	URI aanvragen
VERZENDEN	{baseURL}/v1/klanten/{customer-tenant-id}/migraties/newcommerce HTTP/1.1

URI-parameter

Deze tabel bevat de vereiste queryparameters voor het maken van een nieuwe commerce-migratie.

Naam	Typologie	Vereist	Beschrijving
klant-huurder-id	snaar	Ja	Een tekenreeks in GUID-formaat die de klant identificeert.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Aanvraaginhoud

In deze tabel worden de eigenschappen Abonnement in de hoofdtekst van de aanvraag beschreven.

Eigenschap	Typologie	Vereist	Beschrijving
huidigeAbonnementId	snaar	Ja	Een abonnements-id die aangeeft welk abonnement validatie voor migratie vereist.
looptijd	snaar	Nee	De duur van de looptijd kan worden gewijzigd bij de migratie.
facturatiecyclus	snaar	Nee	De factureringscyclus kan worden gewijzigd bij de migratie.
volledigeAankooptermijn	Bool	Nee	Bij migratie kan een nieuwe term in NCE worden gestart.
hoeveelheid	Int	Nee	De licentiehoeveelheid voor een abonnement kan worden verhoogd of verlaagd bij de migratie.
aangepasteTermijnEinddatum	datum/tijd	Nee	Een einddatum kan worden ingesteld om te worden afgestemd op een bestaand OnlineServicesNCE-abonnement zonder proefperiode of kalendermaand. Hier vindt u meer informatie over het uitlijnen van abonnementseinddatums: Einddatums van het abonnement uitlijnen in partnercentrum

Aanvraagvoorbeeld

Opmerking: geneste invoegtoepassingen (uitbreidingsabonnementen met invoegtoepassingsabonnementen) moeten in de aanvraagtekst worden geschreven als een platte lijst binnen addOnMigrations en niet worden genest in andere invoegtoepassingsabonnementen in de aanvraag; zie het laatste voorbeeld van de aanvraag voor het schrijven van invoegtoepassingen in de hoofdtekst van de aanvraag.

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

REST-antwoord

Als dit succesvol is, retourneert deze methode details van de Abonnementen die worden gemigreerd (migratieobject) in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of er sprake is van succes of een fout, samen met extra informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype, andere parameters te lezen. Zie Partnercentrum REST-foutcodesvoor de volledige lijst.

Antwoordvoorbeelden

{
    "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
}