Aktualizace nadlimitního čerpání
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"
}
}