Zaktualizuj nadwyżkę

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 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.

Grupa zasobów jest zawsze M365. Partnerzy mogą dodawać tagi i lokalizacje do grupy zasobów, ale nie mogą jej zmieniać.

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	Typ	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	Required. GUID definiujący subskrypcję na zużycie w przypadku przekroczeń.
azureResourceGroup	obiekt	Optional. Nazwa wartości tagów i lokalizacji grupy zasobów.
partnerId	guid	Dotyczy tylko modelu dwuwarstwowego (dostawcy pośredniego). PartnerID odsprzedawcy pośredniego.
overageEnabled	bool	Required. 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: 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
}

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