Aktualizowanie nadwyżki

Artykuł
09/25/2024

Dotyczy

Centrum partnerskie

Odpowiednie role

Agent administracyjny

Uwaga

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

Służy do ustawiania nadwyżki dla danego klienta w ramach subskrypcji zużycia. Można również użyć polecenia , aby usunąć nadwyżkę, ustawiając ją 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 definiuje nadwyżkowe użycie subskrypcji z płatnością zgodnie z rzeczywistym użyciem.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft 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

Method	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	Type	Wymagania	opis
identyfikator dzierżawy klienta	guid	Y	Identyfikator GUID odpowiadający dzierżawie klienta.

Nagłówki żądań

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

Treść żądania

Nazwisko	Pisz	Opis
azureEntitlementId	guid	Identyfikator GUID definiujący subskrypcję zużycia dla nadwyżki.
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 powodzenia 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