Aktualizace nadlimitního využití

Článek
02/09/2024

Platí pro

Partnerské centrum

Vhodné role

Globální správce
agent Správa

Poznámka

Nová komerční prostředí pro služby založené na licencích zahrnují mnoho nových funkcí a jsou dostupné všem poskytovatelům CSP (Cloud Solution Provider). Další informace najdete v přehledu nových obchodních prostředí.

Slouží k nastavení nadlimitního využití daného zákazníka na předplatné 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, kterému se budou účtovat průběžné platby.

Požadavky

Přihlašovací údaje, jak je popsáno v tématu 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 ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte ID Microsoft 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é nadlimitní předplatné 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/{id_tenanta}/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.

Název	Typ	Vyžadováno	Popis
customer-tenant-ID	Identifikátor guid	Y	Identifikátor GUID odpovídající tenantovi zákazníka.

Hlavičky požadavku

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

Text požadavku

Název	Typ	Description
azureEntitlementId	Identifikátor guid	Identifikátor GUID definující předplatné consumption pro nadlimitní využití.
id partnera	Identifikátor guid	ID partnera nepřímého prodejce. Platí pouze pro dvouúrovňový model (nepřímý poskytovatel).
nadlimitní využitíPožděné	bool	Uveďte, jestli má být pro dané předplatné consumption 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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
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 zákazníkovi nadlimitní využití.

Úspěšné odpovědi a kódy chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo neúspěch, 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: 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"
    }
}

Share via