Nieuwe commercemigratie-gebeurtenissen ophalen

Artikel
03/07/2025

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

Details van migratiegebeurtenissen verkrijgen op basis van de huidige abonnement-ID of migratie-ID

Voorwaarden

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

Deze API kan migratie-gebeurtenissen ophalen op basis van queryreeksen die de partner selecteert. De geselecteerde queryreeksen kunnen de volgende opties bevatten:

Een CustomerTenantId. 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.
Een CurrentSubscriptionId (de verouderde ID voor een abonnement dat is gemigreerd)
Een MigrationId (de id van het migratieobject dat is gekoppeld aan het huidige abonnement)

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events HTTP/1.1

Queryreeksen

Deze tabel bevat de queryreeksen die kunnen worden gebruikt om nieuwe commerciële migratiegebeurtenissen op te halen. Ten minste één van de twee id's is vereist om de migratiegebeurtenissen op te halen die zijn gekoppeld aan een huidig abonnement. Het invoeren van zowel de migratie-id als de huidige abonnements-id wordt geaccepteerd, maar is niet vereist.

Naam	Beschrijving
MigrationId	Een tekenreeks met GUID-indeling die het migratieobject identificeert.
HuidigeAbonnementId	Een GUID-geformatteerde tekenreeks die een gemigreerd verouderd abonnement identificeert.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Aanvraagtekst

Geen.

REST-antwoord

Als dit lukt, retourneert deze methode gebeurtenisdetails van de huidige Subscription die is gemigreerd in de antwoordtekst.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of het gelukt of mislukt is, samen met andere informatie voor foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Partnercentrum REST-foutcodesvoor de volledige lijst.

Voorbeelden van aanvraag-URL's

baseurl/v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/migrations/newcommerce/events?current_subscription_id=02DF825B-D0C9-40BE-8CB6-BAC895510D0A

Antwoordvoorbeelden

[
    {
        "id": "6eb07675-ba1d-45c2-9d05-c693a4863427",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:06:02.7529574Z",
        "eventName": "MigrationStarted"
    },
    {
        "id": "e828079b-c974-4822-977e-f12ac67380db",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:06:21.526778Z",
        "eventName": "NewCommerceSubscriptionCreated"
    },
    {
        "id": "7dbdcbd5-7a87-4d9b-bf1f-d9298493e631",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:08:08.5185085Z",
        "eventName": "NewCommerceSubscriptionProvisioned"
    },
    {
        "id": "71a3f753-55ca-461e-807d-f541685d5c8b",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "createdTime": "2022-06-11T00:10:07.6947014Z",
        "eventName": "MigrationCompleted"
    }
]

Delen via