Pobieranie danych dotyczących użycia dla subskrypcji według miernika
Dotyczy: Centrum partnerskie | Centrum partnerskie dla Microsoft Cloud for US Government
Możesz użyć kolekcji zasobów MeterUsageRecord , aby uzyskać rekordy użycia miernika klienta dla określonych usług platformy Azure lub zasobów w bieżącym okresie rozliczeniowym. Ta kolekcja zasobów reprezentuje zagregowaną sumę dla każdego miernika dla bieżącego cyklu rozliczeniowego w całym planie platformy Azure.
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń użytkownika i aplikacji.
Identyfikator klienta (
customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz go wyszukać w Centrum partnerskim , wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta . Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).Identyfikator subskrypcji
Ta nowa trasa jest odpowiednikiem subscriptions/{subscription-id}/usagerecords/resourcesdla subskrypcji platformy Microsoft Azure (MS-AZR-0145P). Ta nowa trasa będzie obsługiwać zarówno subskrypcje platformy Microsoft Azure (MS-AZR-0145P) i plany platformy Azure. Aby uzyskać te informacje dla planu platformy Azure, musisz przełączyć się na tę nową trasę. Poza właściwościami wymienionymi w poniższych sekcjach odpowiedź jest taka sama jak stara trasa.
C#
Aby uzyskać rekordy użycia miernika klienta dla określonej usługi platformy Azure lub zasobu w bieżącym okresie rozliczeniowym:
Użyj kolekcji IAggregatePartner.Customers, aby wywołać metodę ById().
Wywołaj właściwość Subscriptions i UsageRecords, a następnie właściwość Meter . Zakończ, wywołując metody Get() lub GetAsync().
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; // var selectedSubscriptionId as string; var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Meters.Get();
Aby zapoznać się z przykładem, zobacz następujący przykład:
- Przykład: aplikacja testowa konsoli
- Projekt: PartnerSDK.FeatureSamples
- Klasa: GetSubscriptionUsageRecordsByMeter.cs
Żądanie REST
Składnia żądania
| Metoda | Identyfikator URI żądania |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1 |
Parametry identyfikatora URI
Ta tabela zawiera listę wymaganych parametrów zapytania w celu uzyskania informacji o ocenianej użyciu klienta.
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| customer-tenant-id | Identyfikator guid | Y | Identyfikator GUID odpowiadający klientowi. |
| identyfikator subskrypcji | Identyfikator guid | Y | Identyfikator GUID odpowiadający identyfikatorowi zasobu subskrypcji Centrum partnerskiego, który reprezentuje subskrypcję platformy Microsoft Azure (MS-AZR-0145P) lub plan platformy Azure. W przypadku zasobów subskrypcji planu platformy Azure podaj identyfikator planu jako identyfikator subskrypcji w tej trasie. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
Brak.
Przykład żądania
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
Odpowiedź REST
W przypadku powodzenia ta metoda zwraca zasób PagedResourceCollection<MeterUsageRecord> w treści odpowiedzi.
Kody powodzenia odpowiedzi i błędów
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.
Przykład odpowiedzi dla subskrypcji platformy Microsoft Azure (MS-AZR-0145P)
W tym przykładzie klient kupił 145P Azure PayG.
W przypadku klientów z subskrypcją platformy Microsoft Azure (MS-AZR-0145P) nie będzie żadnych zmian w odpowiedzi interfejsu API.
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"
}
}
Przykład odpowiedzi REST dla planu platformy Azure
W tym przykładzie klient kupił plan platformy Azure.
W przypadku klientów z planami platformy Azure istnieją następujące zmiany w odpowiedzi interfejsu API:
- currencyLocale jest zastępowany walutąCode
- usdTotalCost to nowe pole
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"
}
}
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla