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 licencované služby 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.

Skupina prostředků je vždy M365. Partneři můžou do skupiny prostředků přidávat značky a umístění, ale nemůžou je změnit.

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	Required. Identifikátor GUID definující předplatné spotřeby pro nadlimitní využití.
azureResourceGroup	objekt	Optional. Název hodnoty značek a umístění skupiny prostředků
partnerId	GUID	Platí pouze pro dvouvrstvou model (nepřímý zprostředkovatel). ID partnera nepřímého prodejce.
povolení nadlimitního využití	bool	Required. 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: 00000000-0000-0000-0000-000000000000
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
X-Locale: en-US

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
  },
    "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: 00000000-0000-0000-0000-000000000000
MS-RequestId: 00000000-0000-0000-0000-000000000000
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
    },
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/00000000-0000-0000-0000-000000000000/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}