Aktualizowanie nadwyżki

Artykuł
02/09/2024

Dotyczy

Centrum partnerskie

Odpowiednie role

Administrator globalny
agent Administracja

Uwaga

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych możliwości i są dostępne dla wszystkich dostawców 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ć do usunięcia nadwyżki, 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 go wyszukać 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 Firmy 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.

Nazwa	Typ	Wymagane	Opis
customer-tenant-id	Identyfikator 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

Nazwa	Typ	Opis
azureEntitlementId	Identyfikator guid	Identyfikator GUID definiujący subskrypcję zużycia dla nadwyżki.
partnerId	Identyfikator guid	Identyfikator PartnerID odsprzedawcy pośredniego. Dotyczy tylko modelu dwuwarstwowego (dostawcy pośredniego).
nadwyżkaEnabled	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: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca nadwyżkę dla klienta.

Kody powodzenia odpowiedzi i błędów

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

Udostępnij przez