Aktualizace nadlimitního využití

Článek
09/25/2024

Platí pro

Partnerské centrum

Odpovídající 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 obchodních prostředí.

Používá se k nastavení nadlimitního využití pro daného zákazníka k předplatnému consumption. Můžete ho také použít k odebrání nadlimitního využití 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í využití definuje nadlimitní využití předplatného s průběžnou platbou.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
Alespoň jedno oprávněné předplatné nadlimitní využití zakoupené pro zákazníka.

Požadavek REST

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

Syntaxe požadavku

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

Parametr identifikátoru URI

K vrácení nadlimitního využití zákazníka použijte následující parametry dotazu.

Name	Type	Požadováno	Popis
customer-tenant-id	identifikátor guid	Y	Identifikátor GUID odpovídající tenantovi zákazníka.

Záhlaví žádosti

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

Text požadavku

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

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 vrátí tato metoda pro zákazníka nadlimitní využití.

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 v tématu 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