Een gebruiksoverzicht ophalen voor alle abonnementen van een klant

Artikel
10/07/2024

Van toepassing op: Partnercentrum | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

U kunt de Resource CustomerUsageSummary gebruiken om het gebruik van een specifieke Azure-service of -resource op te halen tijdens de huidige factureringsperiode.

Notitie

Over het algemeen zijn dagelijkse niet-gefactureerde gebruiksgegevens na 24 uur beschikbaar via DE API of de partnercentrumportal. Afhankelijk van uw locatie en wanneer het gebruik van de meters rapporteert, kunnen er extra vertragingen optreden.

Soms ziet u mogelijk niet de meest recente niet-gefactureerde gebruiksgegevens vanaf het begin van de maand totdat de gefactureerde gebruiksgegevens van de vorige maand zijn geleverd. Dit is om ervoor te zorgen dat de gefactureerde gebruiksgegevens efficiënt worden geleverd binnen de SLA. Zodra u de gefactureerde gebruiksgegevens ontvangt, kunt u beginnen met het ophalen van alle bijgewerkte niet-gefactureerde gebruiksgegevens vanaf het begin van de maand.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten 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#

Een gebruiksoverzicht voor alle abonnementen van een klant ophalen:

Gebruik uw verzameling IAggregatePartner.Customers om de ById() -methode aan te roepen.

Roep de eigenschap UsageSummary aan, gevolgd door de methoden Get() of GetAsync():

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();

Zie het volgende voor een voorbeeld:

Voorbeeld: Consoletest-app
Project: PartnerSDK.FeatureSamples
Klasse: GetCustomerUsageSummary.cs

REST-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1

URI-parameter

Deze tabel bevat de vereiste queryparameter om de geschatte gebruiksgegevens van de klant op te halen.

Name	Type	Vereist	Beschrijving
klant-tenant-id	Guid	J	Een GUID die overeenkomt met de klant.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-antwoord

Als dit lukt, retourneert deze methode een CustomerUsageSummary-resource in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

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

Antwoordvoorbeeld voor Microsoft Azure-abonnement (MS-AZR-0145P)

In dit voorbeeld heeft de klant een Azure PayG-aanbieding van 145P gekocht.

Voor klanten met Microsoft Azure-abonnementen (MS-AZR-0145P) is er geen wijziging in het API-antwoord.

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget":{
        "ammount":300.000000,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "id":"65726577-C208-40FD-9735-8C85AC9CAC68",
    "name":"600 test",
    "billingStartDate":"2016-02-06T00:00:00-08:00",
    "billingEndDate":"2016-03-05T00:00:00-08:00",
    "totalCost":0.0,
    "currencyLocale":"en-US",
    "lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
    "links":{
        "self":{
            "uri":"/customers/{customer-tenant-id}/usagesummary",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"CustomerUsageSummary"
    }
}

Antwoordvoorbeeld voor Azure-plan

In dit voorbeeld heeft de klant een Azure-abonnement gekocht.

Voor klanten met Azure-abonnementen zijn er de volgende wijzigingen in het API-antwoord:

currencyLocale wordt vervangen door currencyCode
usdTotalCost is een nieuw veld

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "resourceName": "Modern Azure Customer UK",
    "billingStartDate": "2019-09-01T00:00:00+00:00",
    "billingEndDate": "2019-10-01T00:00:00+00:00",
    "totalCost": 28.82860766744404945074,
    "currencyCode": "GBP",
    "usdTotalCost": 35.23000000000000362337,
    "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
    "attributes": {
        "objectType": "CustomerUsageSummary"
    }
}

Delen via