Overschrijding bijwerken

Artikel
09/25/2024

Van toepassing op

Partnercentrum

Juiste rollen

Beheerderagent

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). Zie het 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. Met overschrijding kan een klant services blijven gebruiken als ze de service buiten de vermelde limieten gebruiken. Overschrijding definieert de overschrijding van het verbruiksabonnement voor betalen per gebruik.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. 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 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 is aangeschaft voor de klant.

REST-aanvraag

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

Aanvraagsyntaxis

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

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

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

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

Aanvraagvoorbeeld

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 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 Foutcodes voor de volledige lijst.

Responsvoorbeeld

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

Delen via