Uppdatera överförbrukning

Artikel
09/25/2024

Gäller för

Partnercenter

Lämpliga roller

Administratörsagent

Kommentar

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). Mer information finns i översikten över nya handelsupplevelser.

Används för att ange överförbrukning för en viss kund till 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 definierar förbrukningsprenumerationens överförbrukning som betala per användning kommer att ackumuleras till.

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 Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).
Minst en berättigad överförbrukningsprenumeration 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	Ett GUID som motsvarar kundens klientorganisation.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Namn	Type	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 provider).
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 överförbrukning 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. Den fullständiga listan finns i 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