Hämta prenumerationsanvändningsposter för en kund
Gäller för: Partnercenter | Partnercenter för Microsoft Cloud for US Government
Du kan använda resurssamlingen SubscriptionMonthlyUsageRecord för att hämta prenumerationsanvändningsposter för en kund för en specifik Azure-tjänst eller resurs under den aktuella faktureringsperioden. Den här resursen representerar alla prenumerationer för kunden. För en kund med en Azure-plan returnerar den här resursen en lista över dessa planer (inte enskilda Azure-prenumerationer).
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med app+användarautentiseringsuppgifter.
Ett kund-ID (
customer-tenant-id
). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id
).
C#
Utför följande steg för att hämta användningsposter för prenumerationer för en kund för en specifik Azure-tjänst eller resurs under den aktuella faktureringsperioden:
Använd din IAggregatePartner.Customers-samling för att anropa metoden ById().
Anropa sedan egenskapen Prenumerationer och egenskapen UsageRecords . Slutför genom att anropa metoderna Get() eller GetAsync().
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.UsageRecords.Get();
Ett exempel finns i följande:
- Exempel: Konsoltestapp
- Projekt: PartnerSDK.FeatureSamples
- Klass: GetSubscriptionUsageRecords.cs
REST-begäran
Begärandesyntax
Metod | URI för förfrågan |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/usagerecords HTTP/1.1 |
URI-parameter
I den här tabellen visas den frågeparameter som krävs för att hämta kundens klassificerade användningsinformation.
Namn | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
customer-tenant-id | Guid | Y | Ett GUID som motsvarar kunden. |
Begärandehuvuden
Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
Inga.
Exempel på begäran
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
REST-svar
Om det lyckas returnerar den här metoden en SubscriptionMonthlyUsageRecord-resurs i svarstexten.
Lyckade svar och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. En fullständig lista finns i Felkoder.
Svarsexempel för Microsoft Azure-prenumerationer (MS-AZR-0145P)
I det här exemplet köpte kunden ett 145P Azure PayG-erbjudande .
För kunder med Microsoft Azure-prenumerationer (MS-AZR-0145P) ändras inte API-svaret.
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"
}
}
REST-svarsexempel för Azure-plan
I det här exemplet köpte kunden en Azure-plan.
För kunder med Azure-planer finns följande ändringar i API-svaret:
- currencyLocale ersätts med currencyCode
- usdTotalCost är ett nytt fält
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"
}
}