Használati rekordok lekérése az összes ügyfél számára
A következőre vonatkozik: Partnerközpont | Partnerközpont Microsoft Cloud for US Government
A partnerek a CustomerMonthlyUsageRecord erőforrásgyűjtemény használatával lekérhetik az összes ügyfél használati rekordjait. Ez az erőforrás az összes ügyfél használati rekordjait jelöli. Ide tartoznak azok az ügyfelek, akik Microsoft Azure-előfizetéssel (MS-AZR-0145P) vagy Azure-csomaggal rendelkeznek.
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak az App+User hitelesítő adatokkal való hitelesítést támogatja.
Ügyfélazonosító (
customer-tenant-id
). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület, majd az ügyféllista ügyféllistájából, majd a Fiók lehetőség kiválasztásával. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id
).
C#
Egy adott Azure-szolgáltatást vagy erőforrást az aktuális számlázási időszak alatt vásárló összes ügyfél használati rekordjának lekérése:
Az IAggregatePartner.Customers gyűjtemény használatával hívja meg a ById() metódust.
Hívja meg a UsageRecords tulajdonságot , majd hívja meg a Get() vagy a GetAsync() metódust.
// IAggregatePartner partnerOperations; var usageRecords = partnerOperations.Customers.UsageRecords.Get();
Példaként tekintse meg a következő mintát:
- Minta: Konzolteszt alkalmazás
- Projekt: PartnerSDK.FeatureSamples
- Osztály: GetCustomerUsageRecords.cs
REST-kérelem
Kérés szintaxisa
Metódus | Kérés URI-ja |
---|---|
GET | {baseURL}/v1/customers/usagerecords HTTP/1.1 |
Kérésfejlécek
További információt a Partnerközpont REST-fejlécei című témakörben talál.
A kérés törzse
Nincsenek.
Példa kérésre
GET https://api.partnercenter.microsoft.com/v1/customers/usagerecords HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
REST-válasz
Ha sikeres, ez a metódus egy CustomerMonthlyUsageRecord erőforrást ad vissza a válasz törzsében.
Sikeres válasz és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát a Hibakódok című témakörben találja.
Példa válaszra
Az isUpgraded tulajdonsággal azonosíthatja az Azure-csomaggal rendelkező ügyfeleket. Ha az isUpgraded értéke igaz, az azt jelenti, hogy az ügyfelek Azure-csomagokat is használhatnak.
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": 25,
"items": [
{
"budget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"customerSpendingBudget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 0,
"isUpgraded": false,
"resourceId": "11111111-1843-4b3b-872f-206e08a08e51",
"id": "11111111-1843-4b3b-872f-206e08a08e51",
"resourceName": "LEGACY AZURE CUSTOMER SE",
"name": "LEGACY AZURE CUSTOMER SE",
"totalCost": 0,
"currencyLocale": "fr-FR",
"usdTotalCost": 0,
"lastModifiedDate": "2019-08-01T23:00:16.57+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"amount": 20,
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 602.84,
"isUpgraded": true,
"resourceId": "11111111-6fb9-4b05-8f15-b3d72e0596e6",
"id": "11111111-6fb9-4b05-8f15-b3d72e0596e6",
"resourceName": "Modern Azure Customer SE",
"name": "Modern Azure Customer SE",
"totalCost": 120.5682999999995904716,
"currencyCode": "SEK",
"usdTotalCost": 12.39999999999999985235,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 0,
"isUpgraded": true,
"resourceId": "11111111-5892-4326-8541-9da1fdb233fb",
"id": "11111111-5892-4326-8541-9da1fdb233fb",
"resourceName": "Test_Test_MA20190829_14",
"name": "Test_Test_MA20190829_14",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"amount": 97,
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 28.08,
"isUpgraded": true,
"resourceId": "11111111-641b-4c53-b7fc-0f2bfca8a581",
"id": "11111111-641b-4c53-b7fc-0f2bfca8a581",
"resourceName": "Modern Azure Customer UK",
"name": "Modern Azure Customer UK",
"totalCost": 27.23292827625710931604,
"currencyCode": "GBP",
"usdTotalCost": 33.280000000000001044,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/usagerecords",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: