Zaktualizuj nadwyżkę

Artykuł
03/07/2025

Dotyczy

Centrum partnerskie

Odpowiednie role

Agent administracyjny

Uwaga

Nowe doświadczenia handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych doświadczeń handlowych.

Służy do ustawiania nadwyżki dla danego klienta w ramach subskrypcji zużycia. Można również usunąć nadwyżkę, ustawiając opcję na wartość false. Nadwyżka umożliwia klientowi dalsze korzystanie z usług, jeśli korzystają z usługi poza określonymi limitami. Nadwyżka określa, jak nadwyżkowe zużycie subskrypcji w modelu pay-as-you-go będzie naliczane.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno z wykorzystaniem poświadczeń samej aplikacji, jak i poświadczeń aplikacji oraz użytkownika.
Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum Partner, wybierając obszar roboczy Klienci, a następnie klienta z listy klientów, a potem Konto. Na stronie konta klienta poszukaj Microsoft ID w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).
Co najmniej jedna kwalifikująca się subskrypcja nadwyżkowa zakupiona dla klienta.

Żądanie REST

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

Składnia żądania

Metoda	Identyfikator URI żądania
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

Parametr identyfikatora URI

Użyj następujących parametrów zapytania, aby zwrócić nadwyżkę klienta.

Nazwisko	Rodzaj	Wymagane	opis
identyfikator dzierżawy klienta	guid	Y	Identyfikator GUID odpowiadający najemcy klienta.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum Partnerów.

Treść żądania

Nazwisko	Typ	opis
azureEntitlementId	guid	GUID definiujący subskrypcję na zużycie w przypadku przekroczeń.
partnerId	guid	PartnerID odsprzedawcy pośredniego. Dotyczy tylko modelu dwuwarstwowego (dostawcy pośredniego).
overageEnabled	bool	Określ, czy nadwyżka powinna być włączona dla danej subskrypcji zużycia.

Przykład żądania

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
}

Odpowiedź REST

Jeśli operacja powiedzie się, ta metoda zwraca nadwyżkę dla klienta.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi

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

Udostępnij za pośrednictwem