Získání dat o využití pro předplatné podle měřiče

Článek
10/07/2024

Platí pro: Partnerské centrum | Partnerské centrum pro Microsoft Cloud for US Government

Kolekci prostředků MeterUsageRecord můžete použít k získání záznamů o využití měřičů zákazníka pro konkrétní služby nebo prostředky Azure během aktuálního fakturačního období. Tato kolekce prostředků představuje agregovaný součet pro každý měřič za aktuální fakturační období v rámci celého plánu Azure.

Požadavky

Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování jenom pomocí přihlašovacích údajů aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte Microsoft ID v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
ID předplatného

Tato nová trasa je ekvivalentem subscriptions/{subscription-id}/usagerecords/resources, který bude dál fungovat jenom pro předplatná Microsoft Azure (MS-AZR-0145P). Tato nová trasa bude podporovat předplatná Microsoft Azure (MS-AZR-0145P) i plány Azure. Pokud chcete získat tyto informace pro svůj plán Azure, musíte přepnout na tuto novou trasu. Kromě vlastností uvedených v následujících částech je odpověď stejná jako původní trasa.

C#

Získání záznamů o využití měřičů zákazníka pro konkrétní službu nebo prostředek Azure během aktuálního fakturačního období:

K volání metody ById() použijte kolekci IAggregatePartner.Customers.

Volejte vlastnost Subscriptions a UsageRecords a pak vlastnost Měřiče . Dokončete voláním metod Get() nebo GetAsync().

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

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

Příklad najdete v následující ukázce:

Ukázka: Testovací aplikace konzoly
Projekt: PartnerSDK.FeatureSamples
Třída: GetSubscriptionUsageRecordsByMeter.cs

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id_předplatného}/meterusagerecords HTTP/1.1

Parametry identifikátoru URI

Tato tabulka obsahuje seznam požadovaných parametrů dotazu pro získání informací o využití s hodnocením zákazníka.

Název	Typ	Vyžadováno	Popis
customer-tenant-ID	Identifikátor guid	Y	Identifikátor GUID odpovídající zákazníkovi.
ID předplatného	Identifikátor guid	Y	Identifikátor GUID odpovídající identifikátoru prostředku předplatného Partnerského centra, který představuje předplatné Microsoft Azure (MS-AZR-0145P) nebo plán Azure. V případě prostředků předplatného plánu Azure zadejte v této trase id plánu* jako ID předplatného .*

Hlavičky požadavku

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Žádné

Příklad požadavku

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: aaaa0000-bb11-2222-33cc-444444dddddd

Odpověď REST

V případě úspěchu vrátí tato metoda prostředek PagedResourceCollection<MeterUsageRecord> v textu odpovědi.

Kódy úspěšných odpovědí a chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi pro předplatná Microsoft Azure (MS-AZR-0145P)

V tomto příkladu si zákazník koupil 145P Azure PayG.

U zákazníků s předplatným Microsoft Azure (MS-AZR-0145P) se odpověď rozhraní API nezmění.

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"
    }
}

Příklad odpovědi REST pro plán Azure

V tomto příkladu si zákazník koupil plán Azure.

U zákazníků s plány Azure jsou v odpovědi rozhraní API následující změny:

currencyLocale se nahradí kódem měny.
usdTotalCost je nové 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: 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"
    }
}

Sdílet prostřednictvím