Aktualizace nadlimitního čerpání

Článek
03/07/2025

Platí pro

Partnerské centrum

Příslušné role

Agent pro správu

Poznámka:

Nové komerční prostředí pro služby založené na licencích zahrnují mnoho nových funkcí a jsou k dispozici pro všechny poskytovatele cloudových řešení (CSP). Další informace najdete v přehledu nových zkušeností s obchodem.

Používá se k nastavení nadlimitního využití pro daného zákazníka k odběratelskému předplatnému. Můžete jej také použít k odebrání přesahu jeho nastavením na false. Nadlimitní využití umožňuje zákazníkovi pokračovat v používání služeb, pokud službu používá nad rámec uvedených limitů. Nadlimitní spotřeba určuje, k jakým dodatečným nákladům na průběžné platby na základě využití předplatného dojde.

Požadavky

Přihlašovací údaje, jak je popsáno v autentizaci v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů pro aplikaci a přihlašovacích údajů pro aplikaci spolu s uživatelem.
ID zákazníka (). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru výběrem pracovního prostoru zákazníci, pak zákazníka ze seznamu zákazníků a poté účet. Na stránce Účet zákazníka vyhledejte Microsoft ID v části Informace o účtu zákazníka. Microsoft ID je stejné jako ID zákazníka (customer-tenant-id).
Alespoň jedno nadlimitní oprávněné předplatné zakoupeno pro zákazníka.

Požadavek REST

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

Syntaxe požadavku

metoda	URI žádosti
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

Parametr identifikátoru URI

K vrácení překročení limitu zákazníka použijte následující parametry dotazu.

Name	Typ	Požadováno	Popis
customer-tenant-id	GUID	Y	Identifikátor GUID (globálně jedinečný identifikátor) odpovídající tenantovi zákazníka.

Hlavičky žádostí

Další informace najdete v tématu REST hlavičky Partnerského centra.

Text požadavku

Name	Typ	Popis
azureEntitlementId	GUID	Identifikátor GUID definující předplatné spotřeby pro nadlimitní využití.
partnerId	guid	ID partnera nepřímého prodejce. Platí pouze pro dvouvrstvou model (nepřímý zprostředkovatel).
povolení nadlimitního využití	bool	Určete, jestli má být pro dané předplatné spotřeby povoleno překročení limitu.

Příklad požadavku

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
}

Odpověď REST

V případě úspěchu tato metoda vrátí zákazníkovi nadlimitní částku.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete viz Kódy chyb.

Příklad odpovědi

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

Sdílet prostřednictvím