Overschrijding bijwerken

Van toepassing op

  • Partnercentrum

Juiste rollen

  • Beheeragent

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle Cloud Solution Providers (CSP's). 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 een overgebruik-optie kan een klant diensten blijven gebruiken als zij de service buiten de vermelde limieten gebruiken. Overschrijding definieert de overschrijding van het verbruiksabonnement waaraan kosten voor het betalen per gebruik zullen worden toegevoegd.

De resourcegroep is altijd M365. Partners kunnen tags en locaties toevoegen aan de resourcegroep, maar kunnen deze niet wijzigen.

Vereisten

  • Referenties zoals beschreven in Partnercentrum-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 Klanten-werkruimte te selecteren, vervolgens de klant in de lijst met klanten, en daarna Account. Zoek op de accountpagina van de klant naar de Microsoft ID in het gedeelte 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 op te halen.

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

Aanvraagkoppen

Zie REST-headers in Partner Center voor meer informatie.

Aanvraagtekst

Name Type Beschrijving
azureEntitlementId leidraad Required. Een GUID die het verbruiksabonnement definieert voor overschrijding.
azureResourceGroup object Optional. Naamwaarde van tags en de locatie van de resourcegroep.
partnerId leidraad Alleen van toepassing op een model met twee lagen (Indirecte provider). De PartnerID van een indirecte reseller.
overage ingeschakeld bool Required. 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: 00000000-0000-0000-0000-000000000000
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
X-Locale: en-US

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
  },
    "overageEnabled": true
}

REST-antwoord

Als het slaagt, retourneert deze methode een overschot voor een klant.

Geslaagde antwoorden en foutcodes

Elke reactie wordt geleverd met een HTTP-statuscode die aangeeft of het verzoek is geslaagd of mislukt, en 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: 00000000-0000-0000-0000-000000000000
MS-RequestId: 00000000-0000-0000-0000-000000000000
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
    },
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/00000000-0000-0000-0000-000000000000/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}
  • Last updated on