Einddatums voor aangepaste termen ophalen

Artikel
07/25/2023

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

Partners kunnen toegestane einddatums voor aangepaste termijn bekijken voor abonnementen op basis van NCE-licenties die ze voor hun klanten aanschaffen. Partners kunnen einddatums weergeven die overeenkomen met het einde van de kalendermaand of die co-term met bestaande klantabonnementen.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een CustomerTenantId. 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.

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
GET	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Queryreeksen

Deze tabel bevat de queryreeksen die nodig zijn om de einddatums van aangepaste termen te filteren en op te halen. Het invoeren van meerdere id's voor query's wordt geaccepteerd, maar is niet vereist.

Naam	Vereist	Beschrijving
TermDuration	Ja	Een tekenreeks met GUID-indeling die de klant identificeert.
TermStartDate	Nee	Een tekenreeks met GUID-indeling die een gemigreerd verouderd abonnement identificeert.
TargetCotermSubscriptionId	Nee	Een tekenreeks met GUID-indeling die de migratiebatch identificeert.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie. Het antwoord van de API retourneert maximaal 300 paginarecords. Als meer dan 300 records worden geretourneerd in een ingevoerde query, wordt er een vervolgtoken opgegeven in de antwoordheader. Het vervolgtoken kan worden ingevoerd in de header van een volgende aanvraag om extra paginarecords te retourneren die worden opgevraagd.

Aanvraagtekst

Geen.

REST-antwoord

Als dit lukt, retourneert deze methode details van de abonnementen die zijn gemigreerd (migratieobject) in de hoofdtekst van het antwoord. Dit omvat de migratie-id.

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.

Voorbeelden van aanvraag-URL's

baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M

Antwoordvoorbeelden

 {
    "totalCount": 2,
    "items": [
        {
            "allowedCustomTermEndDateType": "calendarMonthAligned",
            "allowedCustomTermEndDate": "2023-07-31T00:00:00"
        },
        {
            "allowedCustomTermEndDateType": "subscriptionAligned",
            "cotermSubscriptionIds": [
               "5fcf618b-1daa-4604-da99-cc3e1c9ee422",
               "d30a9ff9-713e-4546-c97e-f06b9dcf6ef6"
            ],
            "allowedCustomTermEndDate": "2023-08-01T00:00:00"
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
 }