Een nieuwe commercemigratie plannen

Artikel
09/20/2024

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

Juiste rollen: Beheerdersagent | Verkoopagent

In dit artikel wordt beschreven hoe u een nieuwe commerce-ervaring plant.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. 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 het 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

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules

URI-parameter

Deze tabel bevat de vereiste queryparameters voor het maken van een nieuwe commercemigratie.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	tekenreeks	Ja	Een tekenreeks met GUID-indeling die de klant identificeert.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

In deze tabel worden de abonnementseigenschappen in de aanvraagbody beschreven.

Eigenschappen	Type	Vereist	Beschrijving
currentSubscriptionId	tekenreeks	Ja	Een abonnements-id die aangeeft welk abonnement validatie voor migratie vereist.
termDuration	tekenreeks	Nee	De duur van de periode kan worden opgegeven om te worden gewijzigd bij de migratie.
billingCycle	tekenreeks	Nee	De factureringscyclus kan worden opgegeven om te worden gewijzigd bij de migratie.
purchaseFullTerm	bool	Nee	Bij migratie kan een nieuwe term in NCE worden gestart.
quantity	int	Nee	De licentiehoeveelheid voor een abonnement kan worden verhoogd of verlaagd bij de migratie.
customTermEndDate	datetime	Nee	Een einddatum kan worden ingesteld om te worden afgestemd op een bestaand abonnement op niet-proefversie OnlineServicesNCE of kalendermaand. Hier vindt u meer informatie over het uitlijnen van de einddatums van het abonnement: Einddatums van het abonnement uitlijnen in het Partnercentrum
targetDate	datetime	Vereist (als de migrateOnRenewal null/false is)	Doeldatum waarop de migratie moet worden gepland. Als targetDate is ingesteld voor de opgegeven datum, kan de migratieOnRenewal worden ingesteld op null of onwaar.
migrateOnRenewal	bool	Vereist (als de targetDate null is)	Als de vlag waar is ingesteld voor migrateOnRenewal, hoeft u de targetDate voor het plannen van een migratie niet op te geven.
addOnMigrationSchedules	bool	Nee	Bevat een lijst met AddOn-abonnementen die moeten worden opgenomen in de geplande migratie.

Aanvraagvoorbeeld

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

REST-antwoord

Als dit lukt, 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 dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Antwoordvoorbeelden

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Delen via