Overschrijding bijwerken

Artikel
02/09/2024

Van toepassing op

Partnercentrum

Juiste rollen

Globale beheerder
Beheer agent

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties bevatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle Cloud Solution Provider (CSP's). Zie Overzicht van nieuwe commerce-ervaringen voor meer informatie.

Wordt gebruikt om overschrijding voor een bepaalde klant in te stellen op een verbruiksabonnement. Kan ook worden gebruikt om overschrijding te verwijderen door deze in te stellen op false. Overschrijding stelt een klant in staat om services te blijven gebruiken als ze de service buiten de opgegeven limieten gebruiken. Overschrijding definieert de overschrijding van het abonnement op basis van betalen per gebruik.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.
Een klant-id (customer-tenant-id). Als u de id van de klant 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 (customer-tenant-id).
Ten minste één in aanmerking komend overschrijdingsabonnement dat voor de klant is aangeschaft.

REST-aanvraag

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

Aanvraagsyntaxis

Methode	Aanvraag-URI
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overschrijding HTTP/1.1

URI-parameter

Gebruik de volgende queryparameters om de overschrijding van een klant te retourneren.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	Guid	J	Een GUID die overeenkomt met de tenant van de klant.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Naam	Type	Beschrijving
azureEntitlementId	Guid	Een GUID die het verbruiksabonnement voor overschrijding definieert.
partnerId	Guid	De PartnerID van een indirecte reseller. Alleen van toepassing op een model met twee lagen (indirecte provider).
overageEnabled	booleaans	Geef aan of overschrijding moet worden ingeschakeld voor een bepaald verbruiksabonnement.

Voorbeeld van aanvraag

PUT 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

REST-antwoord

Als dit lukt, retourneert deze methode overschrijding voor een klant.

Geslaagde en foutcodes voor antwoorden

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

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

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

Share via