Condividi tramite


Ottenere il budget di spesa per l'utilizzo di un cliente

Si applica a: Centro per i partner | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

È possibile aggiornare il budget di spesa (oggetto SpendingBudget) nel riepilogo dell'utilizzo del cliente (la risorsa CustomerUsageSummary).

Prerequisiti

  • Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.

  • ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

C#

Per aggiornare il budget di spesa per l'utilizzo di un cliente:

  1. Creare un nuovo oggetto SpendingBudget con l'importo aggiornato.

  2. Utilizzare l'insieme IAggregatePartner.Customers per chiamare il metodo ById() con l'identificatore del cliente specificato.

  3. Chiamare il metodo Get o GetAsync per ottenere il budget di utilizzo del cliente.

// 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.Get();

Richiesta REST

Sintassi della richiesta

metodo URI della richiesta
GET {baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1

Parametro URI

Usare il parametro di query seguente per aggiornare il profilo di fatturazione.

Nome Digita Obbligatorio Descrizione
customer-tenant-id guid Y Il valore è un GUID formattato customer-tenant-id che consente al rivenditore di filtrare i risultati per un determinato cliente appartenente al rivenditore.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Risorsa completa.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce il budget di spesa di un utente con l'importo aggiornato.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

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, 17 Sep 2019 20:31:45 GMT

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