Pobieranie rekordów użycia subskrypcji dla klienta
Dotyczy: Centrum partnerskie | Centrum partnerskie dla Microsoft Cloud for US Government
Możesz użyć kolekcji zasobów SubscriptionMonthlyUsageRecord , aby uzyskać rekordy użycia subskrypcji dla klienta określonej usługi platformy Azure lub zasobu w bieżącym okresie rozliczeniowym. Ten zasób reprezentuje wszystkie subskrypcje klienta. W przypadku klienta z planem platformy Azure ten zasób zwraca listę tych planów (a nie poszczególnych subskrypcji 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).
C#
Aby uzyskać rekordy użycia subskrypcji dla klienta określonej usługi platformy Azure lub zasobu w bieżącym okresie rozliczeniowym, wykonaj następujące czynności:
Użyj kolekcji IAggregatePartner.Customers, aby wywołać metodę ById().
Następnie wywołaj właściwość Subscriptions i właściwość UsageRecords . Zakończ, wywołując metody Get() lub GetAsync().
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.UsageRecords.Get();
Aby zapoznać się z przykładem, zobacz następujące kwestie:
- Przykład: aplikacja testowa konsoli
- Projekt: PartnerSDK.FeatureSamples
- Klasa: GetSubscriptionUsageRecords.cs
Żądanie REST
Składnia żądania
| Metoda | Identyfikator URI żądania |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/usagerecords HTTP/1.1 |
Parametr 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. |
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/usagerecords HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Odpowiedź REST
Jeśli ta metoda powiedzie się, ta metoda zwraca zasób SubscriptionMonthlyUsageRecord 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ł ofertę 145P usługi Azure PayG .
W przypadku klientów korzystających z subskrypcji 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: aaaa0000-bb11-2222-33cc-444444dddddd
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": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
"id": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
"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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"totalCount": 2,
"items": [
{
"status": "active",
"partnerOnRecord": "some-id",
"offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
"resourceId": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
"id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
"resourceName": "Azure plan",
"name": "Azure plan",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
"attributes": {
"objectType": "SubscriptionMonthlyUsageRecord"
}
},
{
"status": "active",
"partnerOnRecord": "some-id",
"offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
"resourceId": "c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3",
"id": "c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3",
"resourceName": "Azure plan",
"name": "Azure plan",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
"attributes": {
"objectType": "SubscriptionMonthlyUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/<customer-tenant-id>/subscriptions/usagerecords",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}