Uppdatera överförbrukning

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örer (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.

Resursgruppen är alltid M365. Partner kan lägga till taggar och platser i resursgruppen men kan inte ändra den.

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 Required. Ett GUID som definierar förbrukningsprenumerationen för överförbrukning.
azureResourceGroup objekt Optional. Namnvärde för taggar och platsen för resursgruppen.
partnerId GUID Gäller endast för en tvånivåmodell (indirekt leverantör). PartnerID för en indirekt återförsäljare.
overageEnabled bool Required. 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: 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-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: 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