Gebruiksgegevens voor het abonnement per meter ophalen
Van toepassing op: Partnercentrum | Partnercentrum voor Microsoft Cloud for US Government
U kunt de resourceverzameling MeterUsageRecord gebruiken om metergebruiksrecords van een klant op te halen voor specifieke Azure-services of -resources tijdens de huidige factureringsperiode. Deze resourceverzameling vertegenwoordigt een geaggregeerd totaal voor elke meter voor de huidige factureringscyclus, in uw hele Azure-plan.
Vereisten
Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt alleen verificatie met 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 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).Een abonnements-id
Deze nieuwe route is gelijk aan subscriptions/{subscription-id}/usagerecords/resources, die alleen blijft werken voor Microsoft Azure-abonnementen (MS-AZR-0145P). Deze nieuwe route ondersteunt zowel Microsoft Azure-abonnementen (MS-AZR-0145P) als Azure-abonnementen. Als u deze informatie voor uw Azure-plan wilt verkrijgen, moet u overschakelen naar deze nieuwe route. Afgezien van de eigenschappen die in de volgende secties worden vermeld, is het antwoord hetzelfde als de oude route.
C#
Metergebruiksrecords ophalen van een klant voor een specifieke Azure-service of -resource tijdens de huidige factureringsperiode:
Gebruik uw verzameling IAggregatePartner.Customers om de methode ById() aan te roepen.
Roep de eigenschap Subscriptions en UsageRecords aan en vervolgens de eigenschap Meters . Voltooi het aanroepen van de methoden Get() of GetAsync().
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; // var selectedSubscriptionId as string; var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Meters.Get();
Zie het volgende voorbeeld voor een voorbeeld:
- Voorbeeld: Console-test-app
- Project: PartnerSDk.FeatureSamples
- Klasse: GetSubscriptionUsageRecordsByMeter.cs
REST-aanvraag
Aanvraagsyntaxis
| Methode | Aanvraag-URI |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1 |
URI-parameters
Deze tabel bevat de vereiste queryparameters om de geclassificeerde gebruiksgegevens van de klant op te halen.
| 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 de id van een Partner Center-abonnementsresource, die een Microsoft Azure-abonnement (MS-AZR-0145P) of een Azure-abonnement vertegenwoordigt. Geef voor azure-abonnementsresources de plan-id op als de abonnements-id in deze route. |
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/{subscription-id}/meterusagerecords HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
REST-antwoord
Als dit lukt, retourneert deze methode een PagedResourceCollection<MeterUsageRecord-resource> in de antwoordtekst.
Geslaagde en foutcodes voor antwoorden
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het is gelukt 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-abonnementen (MS-AZR-0145P)
In dit voorbeeld heeft de klant 145P Azure PayG gekocht.
Voor klanten met een Microsoft Azure-abonnement (MS-AZR-0145P) wordt de API-reactie niet gewijzigd.
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"totalCount": 1,
"items": [
{
"status": "active",
"offerId": "MS-AZR-0145P",
"resourceId": "11111111-F347-41B6-B02C-187B1B778A43",
"id": "11111111-F347-41B6-B02C-187B1B778A43",
"resourceName": "Microsoft Azure",
"name": "Microsoft Azure",
"totalCost": 22.861172,
"currencyLocale": "fr-FR",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
"attributes": {
"objectType": "SubscriptionMonthlyUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/{customer-tenant-id}/subscriptions/usagerecords/",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
VOORBEELD VAN REST-antwoord 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: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Fri, 26 Feb 2016 20:31:45 GMT
{
"totalCount": 4,
"items": [
{
"subscriptionId": "{subscription-id}",
"meterId": "DZH318Z0BNVX-005J-Data Transfer In (GB)",
"meterName": "Data Transfer In",
"category": "Bandwidth",
"subcategory": "Bandwidth",
"quantityUsed": 0.01129,
"unit": "1 GB",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
"attributes": {
"objectType": "MeterUsageRecord"
}
},
{
"subscriptionId": "{subscription-id}",
"meterId": "DZH318Z0BNVX-005J-Data Transfer Out (GB)",
"meterName": "Data Transfer Out",
"category": "Bandwidth",
"subcategory": "Bandwidth",
"quantityUsed": 0.000224,
"unit": "1 GB",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
"attributes": {
"objectType": "MeterUsageRecord"
}
},
{
"subscriptionId": "{subscription-id}",
"meterId": "DZH318Z0BNZ5-006G-10K Batch Write Operations",
"meterName": "Batch Write Operations",
"category": "Storage",
"subcategory": "Tables",
"quantityUsed": 0.2462,
"unit": "10K",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
"attributes": {
"objectType": "MeterUsageRecord"
}
},
{
"subscriptionId": "{subscription-id}",
"meterId": "DZH318Z0BNZ5-006G-Data Stored (GB/Month)",
"meterName": "LRS Data Stored",
"category": "Storage",
"subcategory": "Tables",
"quantityUsed": 0.002632,
"unit": "1 GB/Month",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
"attributes": {
"objectType": "MeterUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/meterusagerecords",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor