Een nieuwe commerce-migratie 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
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
Frequentielimiet
De limiet voor de Migratie-API maken is in vijf minuten 100 aanroepen door een partner. Meer informatie over frequentielimieten en bandbreedtebeperking vindt u in api-beperkingsrichtlijnen.
REST-aanvraag
Aanvraagsyntaxis
Wijze | Aanvraag-URI |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1 |
URI-parameter
Deze tabel bevat de vereiste queryparameters voor het maken van een nieuwe commercemigratie.
Name | 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.
Eigenschap | Type | Vereist | Beschrijving |
---|---|---|---|
currentSubscriptionId | tekenreeks | Ja | Een abonnements-id die aangeeft welk abonnement validatie voor migratie vereist. |
termDuration | tekenreeks | Nee | De duur van de looptijd kan worden gewijzigd bij de migratie. |
billingCycle | tekenreeks | Nee | De factureringscyclus kan 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 niet-trial OnlineServicesNCE-abonnement of kalendermaand. Hier vindt u meer informatie over het uitlijnen van abonnementseinddatums: Einddatums van abonnementen 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 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 er succes- of foutopsporingsinformatie is en extra informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype, andere parameters te lezen. Zie rest-foutcodes in Partnercentrum voor 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
}