Przeczytaj w języku angielskim

Udostępnij za pośrednictwem

Aktualizowanie budżetu wydatków na użycie klienta

  • Artykuł

Dotyczy: Centrum partnerskie | Centrum partnerskie dla Microsoft Cloud for US Government

Zaktualizuj budżet wydatków przydzielony na potrzeby użycia klienta.

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

C#

Aby zaktualizować budżet wydatków na użycie klienta, najpierw utwórz nowy obiekt SpendingBudget z zaktualizowaną kwotą. Następnie użyj kolekcji IAggregatePartner.Customers i wywołaj metodę ById() z identyfikatorem określonego klienta. Następnie uzyskaj dostęp do właściwości UsageBudget i przekaż zaktualizowany budżet użycia do metody Patch() lub PatchAsync().

C# 
// IAggregatePartner partnerOperations;
// string selectedCustomerId;

// Create a new spending budget with the udpated amount.
var newUsageBudget = new SpendingBudget()
{
    Amount = 100
};

// Update the customer's usage budget.
var usageBudget = partnerOperations.Customers.ById(selectedCustomerId).UsageBudget.Patch(newUsageBudget);

Żądanie REST

Składnia żądania

Metoda Identyfikator URI żądania
PATCH {baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru zapytania, aby zaktualizować profil rozliczeniowy.

Nazwa Typ Wymagane Opis
customer-tenant-id Identyfikator guid Y Wartość to identyfikator GUID sformatowany jako customer-tenant-id , który umożliwia odsprzedawcy filtrowanie wyników dla danego klienta należącego do odsprzedawcy.

Nagłówki żądań

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

Treść żądania

Pełny zasób.

Przykład żądania

HTTP 
PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/usagebudget HTTP/1.1
Authorization: Bearer <token>
Accept: application/json, text/plain, */*
MS-RequestId: 312b044d-dc41-4b37-c2d5-7d27322d9654
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"

{
     "Amount": 100,
     "Attributes": {
          "ObjectType": "SpendingBudget"
     }
}

Odpowiedź REST

Jeśli ta metoda powiedzie się, ta metoda zwraca budżet wydatków użytkownika z zaktualizowaną kwotą.

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 
HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 10 Nov 2015 19:09:59 GMT

{
    {
        "amount": 100,
        "usageSpendingBudget": 100,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "links":{
        "self":{
            "uri":"/v1/customers/<customer-tenant-id>/usagebudget",
            "method":"PATCH",
            "headers":[]
        }
    }
}