Uppdatera överförbrukning

Artikel
03/07/2025

Gäller för

Partnercenter

Lämpliga roller

Administratörsagent

Anmärkning

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Molnlösningsleverantör (CSP:er). För mer information, se översikten över nya handelsupplevelser.

Används för att ställa in överförbrukning för en viss kund på en förbrukningsprenumeration. Kan också användas för att ta bort överförbrukning genom att ställa in den på false. Överförbrukning gör det möjligt för en kund att fortsätta använda tjänster om de använder tjänsten utöver de angivna gränserna. Överförbrukning anger de kostnader för extra förbrukning i en betal-per-användning-prenumeration.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partner Center genom att välja arbetsytan Kunder, sedan kunden från kundlistan och sedan Konto. På kundens kontosida, leta efter Microsoft-ID i avsnittet Kundkontoinformation. Microsoft-ID är samma som kund-ID (customer-tenant-id).
Minst en berättigad tilläggsprenumeration som köpts för kunden.

REST-begäran

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

Syntax för begäran

Metod	URI för förfrågan
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

URI-parameter

Använd följande frågeparametrar för att returnera en kunds överförbrukning.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	GUID	Y	En GUID som motsvarar kundens tenant.

Begäranhuvuden

För mer information, se REST-huvuden för Partner Center.

Begärandetext

Namn	Typ	Beskrivning
azureEntitlementId	GUID	Ett GUID som definierar förbrukningsprenumerationen för överförbrukning.
partnerId	GUID	PartnerID för en indirekt återförsäljare. Gäller endast för en tvånivåmodell (indirekt leverantör).
overageEnabled	bool	Ange om överförbrukning ska aktiveras för en viss förbrukningsprenumeration.

Exempel på begäran

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

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

REST-svar

Om det lyckas returnerar den här metoden överskott för en kund.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. För den fullständiga listan, se Felkoder.

Svarsexempel

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

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

Dela via