Einddatums voor aangepaste termen ophalen

  • Artikel

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

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

API's ondersteunen alleen de berekening van aangepaste termijneinddatums voor de aankoop van nieuwe abonnementen en niet voor de verlenging van bestaande abonnementen.

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

Wijze 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.

Naam: Vereist: Beschrijving:
term_duration Ja Een ISO 8601-weergave van de duur van de term. De huidige ondersteunde waarden zijn P1M (1 maand), P1Y (1 jaar) en P3Y (3 jaar).
term_start_date Nee De beoogde aankoopdatum. Dit kan niet in het verleden zijn.
target_coterm_subscription_id Nee Een tekenreeks met GUID-indeling waarmee het abonnement wordt geïdentificeerd dat moet worden gekoppeld aan een coterm.

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