Overschot verkrijgen

Artikel
03/07/2025

Van toepassing op

Partnercentrum

Geschikte rollen

Administratieagent

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Voor meer informatie, zie overzicht van nieuwe commerce-ervaringen.

Wordt gebruikt om overschrijding van een limiet voor een bepaalde klant te beheren. Met de overschrijdingsfunctie kan een klant de diensten blijven gebruiken wanneer ze de diensten buiten de vermelde limieten gebruiken. Overschrijding definieert de overschrijding van het verbruiksabonnement voor betalen per gebruik.

Vereisten

Referenties zoals beschreven in Partner Center authenticatie. 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 openen, de klant uit de klantenlijst te selecteren en vervolgens Account te kiezen. Zoek op de Klantaccountpagina naar de Microsoft ID in de sectie Klantaccountinfo. De Microsoft-ID is hetzelfde als de klant-ID (customer-tenant-id).

REST-aanvraag

[GET] /customers/{customer-tenant-id}/subscriptions/overschrijding

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

URI-parameter

Gebruik de volgende queryparameters om de overschrijding van een klant op te halen.

Name	Type	Vereist	Beschrijving
klant-huurder-id	Richtlijn	Y	Een GUID die overeenkomt met de tenant van de klant.

Aanvraagheaders

Zie REST-koppen in Partner Center voor meer informatie.

Aanvraagtekst

Geen

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST-antwoord

Als succesvol, retourneert deze methode een overschot voor een klant.

Geslaagde antwoorden en foutcodes

Elke respons wordt geleverd met een HTTP-statuscode die aangeeft of het verzoek is geslaagd of mislukt, evenals aanvullende informatie voor foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "totalCount": 1,
    "items": [
        {
            "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
            "partnerId": "1234",
            "type": "PhoneServices",
            "overageEnabled": true,
            "links": {
                "overage": {
                    "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
                    "method": "GET",
                    "headers": []
                }
            },
            "attributes": {
                "objectType": "Overage"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Delen via