Updateüberschreitung

Gilt für

• Partner Center

Geeignete Rollen

• Globaler Administrator
• Administrator-Agent

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

Wird verwendet, um die Überschreitung für einen bestimmten Kunden auf ein Verbrauchsabonnement festzulegen. Kann auch verwendet werden, um Überschreitungen zu entfernen, indem Sie sie auf false festlegen. Eine Überschreitung ermöglicht es einem Kunden, Dienste weiterhin zu nutzen, wenn er den Dienst über die angegebenen Grenzwerte hinaus nutzt. Die Überschreitung definiert die Nutzungsabonnementüberschreitung bei nutzungsbasierter Bezahlung.

Voraussetzungen

• Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

• Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

• Mindestens ein berechtigtes Überschreitungsabonnement, das für den Kunden erworben wurde.

REST-Anforderung

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

Anforderungssyntax

Methode	Anforderungs-URI
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

URI-Parameter

Verwenden Sie die folgenden Abfrageparameter, um die Überschreitung eines Kunden zurückzugeben.

Name	Typ	Erforderlich	BESCHREIBUNG
customer-tenant-id	guid	J	Eine GUID, die dem Mandanten des Kunden entspricht.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Name	Typ	BESCHREIBUNG
azureEntitlementId	guid	Eine GUID, die das Verbrauchsabonnement für Überschreitung definiert.
partnerId	guid	Die PartnerID eines indirekten Wiederverkäufers. Gilt nur für ein Modell mit zwei Ebenen (indirekter Anbieter).
overageEnabled	bool	Geben Sie an, ob eine Überschreitung für ein bestimmtes Verbrauchsabonnement aktiviert werden soll.

Anforderungsbeispiel

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-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Überlastung für einen Kunden zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Antwortbeispiel

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