Megosztás a következőn keresztül:

Ügyfél előfizetés-használati rekordjainak lekérése

  • Cikk

A következőre vonatkozik: Partnerközpont | Partnerközpont Microsoft Cloud for US Government

A SubscriptionMonthlyUsageRecord erőforrásgyűjtemény használatával lekérheti egy adott Azure-szolgáltatás vagy -erőforrás ügyfélének előfizetés-használati rekordjait az aktuális számlázási időszakban. Ez az erőforrás az ügyfél összes előfizetését jelöli. Az Azure-csomaggal rendelkező ügyfelek esetében ez az erőforrás ezeknek a csomagoknak a listáját adja vissza (nem az egyes Azure-előfizetéseket).

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él-azonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából az ügyféllistá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#

Ha egy adott Azure-szolgáltatás vagy erőforrás ügyfélének előfizetés-használati rekordjait szeretné lekérni az aktuális számlázási időszakban, hajtsa végre az alábbi lépéseket:

  1. Az IAggregatePartner.Customers gyűjtemény használatával hívja meg a ById() metódust.

  2. Ezután hívja meg az Előfizetések tulajdonságot és a UsageRecords tulajdonságot . Fejezze be a Get() vagy a GetAsync() metódus meghívásával.

    // IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.UsageRecords.Get();

Példaként tekintse meg a következőt:

REST-kérelem

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/usagerecords HTTP/1.1

URI-paraméter

Ez a táblázat felsorolja az ügyfél minősített használati adatainak lekéréséhez szükséges lekérdezési paramétert.

Név Típus Kötelező Leírás
customer-tenant-id guid Y Az ügyfélnek megfelelő GUID.

Kérésfejlécek

További információ: Partnerközpont REST-fejlécei.

A kérés törzse

Nincsenek.

Példa kérésre

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: 47c36033-af5d-4457-80a4-512c1626fac4

REST-válasz

Ha sikerült, ez a metódus egy SubscriptionMonthlyUsageRecord 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álasz a Microsoft Azure-előfizetésekre (MS-AZR-0145P)

Ebben a példában az ügyfél egy 145P-s Azure PayG-ajánlatot vásárolt.

A Microsoft Azure-előfizetéssel (MS-AZR-0145P) rendelkező ügyfelek esetében az API-válasz nem változik.

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-válasz példa az Azure-csomaghoz

Ebben a példában az ügyfél vásárolt egy Azure-csomagot.

Az Azure-csomagokkal rendelkező ügyfelek esetében az API-válasz a következő változásokat tartalmazza:

  • currencyLocale helyett currencyCode
  • usdTotalCost egy új mező
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": 2,
    "items": [
        {
            "status": "active",
            "partnerOnRecord": "some-id",
            "offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
            "resourceId": "11111111-7d58-6654-69fa-0797198155d3",
            "id": "11111111-7d58-6654-69fa-0797198155d3",
            "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": "11111111-25aa-ebb8-2bb4-fb406307babd",
            "id": "11111111-25aa-ebb8-2bb4-fb406307babd",
            "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"
    }
}