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:
Creare un nuovo oggetto SpendingBudget con l'importo aggiornato.
Utilizzare l'insieme IAggregatePartner.Customers per chiamare il metodo ById() con l'identificatore del cliente specificato.
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": []
}
}
}