Het gebruiksbestedingsbudget van een klant bijwerken

Artikel
10/07/2024

Van toepassing op: Partnercentrum | Partnercentrum voor Microsoft Cloud for US Government

Werk het bestedingsbudget bij dat is toegewezen voor het gebruik van een klant.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.
Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de klantenlijst en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

C#

Als u het gebruiksbudget van een klant wilt bijwerken, maakt u eerst een nieuw SpendingBudget-object met het bijgewerkte bedrag. Gebruik vervolgens de verzameling IAggregatePartner.Customers en roep de methode ById() aan met de opgegeven klant-id. Open vervolgens de eigenschap UsageBudget en geef het bijgewerkte gebruiksbudget door aan de methode Patch() of 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);

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
PATCH	{baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om het factureringsprofiel bij te werken.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	Guid	J	De waarde is een klant-tenant-id in GUID-indeling waarmee de reseller de resultaten kan filteren op een bepaalde klant die bij de reseller hoort.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

De volledige resource.

Voorbeeld van aanvraag

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

REST-antwoord

Als dit lukt, retourneert deze methode het bestedingsbudget van een gebruiker met het bijgewerkte bedrag.

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Voorbeeld van antwoord

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

Delen via