Alle maandelijkse gebruiksrecords voor een abonnement ophalen

Artikel
10/07/2024

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

U kunt de resourceverzameling AzureResourceMonthlyUsageRecord gebruiken om een lijst op te halen met services binnen het abonnement van een klant en de bijbehorende geclassificeerde gebruiksgegevens.

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).
Een abonnements-id.

Deze API ondersteunt alleen Microsoft Azure-abonnementen (MS-AZR-0145P). Als u een Azure-abonnement gebruikt, raadpleegt u Gebruiksgegevens voor abonnement ophalen per meter .

C#

Ga als volgt te werk om de resourcegebruiksgegevens van een abonnement op te halen:

Gebruik uw verzameling IAggregatePartner.Customers om de methode ById() aan te roepen.
Roep de eigenschap Subscriptions en UsageRecords aan en vervolgens de eigenschap Resources .
Roep de methode Get() of GetAsync() aan .

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

var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Resources.Get();

Zie het volgende voor een voorbeeld:

Voorbeeld: Consoletest-app
Project: PartnerSDK.featureSample
Klasse: SubscriptionResourceUsageRecords.cs

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1

URI-parameters

Deze tabel bevat de vereiste queryparameters voor het ophalen van de geclassificeerde gebruiksgegevens.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	Guid	J	Een GUID die overeenkomt met de klant.
subscription-id	Guid	J	Een GUID die overeenkomt met het abonnement.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 65b26053-37d0-4303-9fd1-46ad8012bcb6
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-antwoord

Als dit lukt, retourneert deze methode een verzameling AzureResourceMonthlyUsageRecord-resources in de antwoordtekst.

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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 10 Nov 2015 19:09:59 GMT

{
    "totalCount":20,
    "items":[{
        "category":"Storage",
        "subcategory":"LOCALLY REDUNDANT",
        "quantityUsed":0.151287527825352,
        "unit":"GB",
        "id":"2a2419c0-cefe-46b2-8004-8eb002ad606c",
        "name":"Azure Resource 1",
        "totalCost":0.195779159290613,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    },
    {
        "category":"Remote App",
        "subcategory":"Remote App",
        "quantityUsed":0.932546524299563,
        "unit":"GB",
        "id":"7e4099c8-2b3d-41a6-a1bd-d5cf315989b2",
        "name":"Azure Resource 2",
        "totalCost":0.920983775016379,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    }],
    "links":{
        "self":{
            "uri":"/v1/customers/<customer-tenant-id>/subscriptions/<id-for-subscription>%20/usagerecords",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"Collection"
    }
}

Delen via