Überlastung aktualisieren

Artikel
09/25/2024

Gilt für

Partner Center

Geeignete Rollen

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 Überlastung für einen bestimmten Kunden auf ein Verbrauchsabonnement festzulegen. Kann auch verwendet werden, um die Überlastung zu entfernen, indem sie auf "false" festgelegt wird. Überlastung ermöglicht es einem Kunden, weiterhin Dienste zu nutzen, wenn er den Dienst über die angegebenen Grenzwerte hinaus nutzt. Die Überlastung definiert den Verbrauchabonnementüberlastungssatz, dem Sie zuordnen.

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 Überlastungsabonnement, 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 Überlastung eines Kunden zurückzugeben.

Name	Type	Erforderlich	Beschreibung
customer-tenant-id	guid	Y	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 Überlastung definiert.
partnerId	guid	Die PartnerID eines indirekten Wiederverkäufers. Gilt nur für ein Modell mit zwei Ebenen (indirekter Anbieter).
overageEnabled	bool	Gibt an, ob die Überlastung 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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

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

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode die Ü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.

Beispielantwort

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

Freigeben über