Abrufen der Nutzungsdaten für ein Abonnement nach Verbrauchseinheit
Gilt für: Partner Center | Partner Center für Microsoft Cloud for US Government
Sie können die Ressourcensammlung MeterUsageRecord verwenden, um Verbrauchsdatensätze eines Kunden für bestimmte Azure-Dienste oder -Ressourcen während des aktuellen Abrechnungszeitraums abzurufen. Diese Ressourcensammlung stellt eine aggregierte Summe für jede Verbrauchseinheit für die aktuelle Abrechnungszeitraum in Ihrem gesamten Azure-Plan dar.
Voraussetzungen
Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Eine Kunden-ID (
customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).Eine Abonnement-ID
Diese neue Route entspricht subscriptions/{subscription-id}/usagerecords/resources, die weiterhin nur für Microsoft Azure-Abonnements (MS-AZR-0145P) funktioniert. Diese neue Route unterstützt sowohl Microsoft Azure-Abonnements (MS-AZR-0145P) als auch Azure-Pläne. Um diese Informationen für Ihren Azure-Plan zu erhalten, müssen Sie zu dieser neuen Route wechseln. Abgesehen von den in den folgenden Abschnitten erwähnten Eigenschaften entspricht die Antwort der alten Route.
C#
So rufen Sie Verbrauchsdatensätze eines Kunden für einen bestimmten Azure-Dienst oder eine bestimmte Ressource während des aktuellen Abrechnungszeitraums ab:
Verwenden Sie Ihre IAggregatePartner.Customers-Auflistung , um die ById() -Methode aufzurufen.
Rufen Sie die Subscriptions-Eigenschaft und UsageRecords und dann die Meter-Eigenschaft auf. Schließen Sie ab, indem Sie die Methoden Get() oder GetAsync() aufrufen.
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; // var selectedSubscriptionId as string; var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Meters.Get();
Ein Beispiel finden Sie im folgenden Beispiel:
- „Beispiel: Konsolentest der App
- Projekt: PartnerSDK.FeatureSamples
- Klasse: GetSubscriptionUsageRecordsByMeter.cs
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1 |
URI-Parameter
In dieser Tabelle sind die erforderlichen Abfrageparameter aufgeführt, um die vom Kunden bewerteten Nutzungsinformationen abzurufen.
| Name | Typ | Erforderlich | BESCHREIBUNG |
|---|---|---|---|
| customer-tenant-id | guid | J | Eine GUID, die dem Kunden entspricht. |
| abonnement-id | guid | J | Eine GUID, die dem Bezeichner einer Partner Center-Abonnementressource entspricht, die ein Microsoft Azure-Abonnement (MS-AZR-0145P) oder einen Azure-Plan darstellt. Geben Sie für Azure-Planabonnementressourcen die Plan-ID als Abonnement-ID in dieser Route an. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
Keine.
Anforderungsbeispiel
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-Antwort
Bei erfolgreicher Ausführung gibt diese Methode eine PagedResourceCollection<MeterUsageRecord-Ressource> im Antworttext zurück.
Erfolgs- und Fehlercodes der Antwort
Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Eine vollständige Liste finden Sie unter Fehlercodes.
Antwortbeispiel für Microsoft Azure-Abonnements (MS-AZR-0145P)
In diesem Beispiel hat der Kunde 145P Azure PayG erworben.
Für Kunden mit einem Microsoft Azure-Abonnement (MS-AZR-0145P) wird die API-Antwort nicht geändert.
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"
}
}
REST-Antwortbeispiel für Azure-Plan
In diesem Beispiel hat der Kunde einen Azure-Plan erworben.
Für Kunden mit Azure-Plänen gibt es die folgenden Änderungen in der API-Antwort:
- currencyLocale wird durch currencyCode ersetzt.
- usdTotalCost ist ein neues Feld.
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
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für