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

Articolo
10/07/2024

Si applica a: Centro per i partner | Centro per i partner per Microsoft Cloud for US Government

Aggiornare il budget di spesa allocato per l'utilizzo di un cliente.

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 cliente (customer-tenant-id).

C#

Per aggiornare il budget di spesa per l'utilizzo di un cliente, creare prima di tutto un nuovo oggetto SpendingBudget con l'importo aggiornato. Usare quindi la raccolta IAggregatePartner.Customers e chiamare il metodo ById() con l'ID del cliente specificato. Accedere quindi alla proprietà UsageBudget e passare il budget di utilizzo aggiornato al metodo Patch() o PatchAsync().

// 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);

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
PATCH	{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	Tipo	Obbligatoria	Descrizione
customer-tenant-id	guid	S	Il valore è un ID cliente-tenant formattato con GUID che consente al rivenditore di filtrare i risultati per un determinato cliente appartenente al rivenditore.

Intestazioni della richiesta

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

Testo della richiesta

Risorsa completa.

Esempio di richiesta

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

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 ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Esempio di risposta

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

Condividi tramite