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

Platí pro: Partnerské centrum | Partnerské centrum pro Microsoft Cloud Germany | 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če 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 agregovanou celkovou částku pro každý měřič pro aktuální fakturační období v rámci celého plánu Azure.

Požadavky

  • Přihlašovací údaje, jak je popsáno Partnerské centrum ověřování. Tento scénář podporuje ověřování pouze pomocí přihlašovacích údajů aplikace a uživatele.

  • ID zákazníka ( customer-tenant-id ). Pokud ID zákazníka neznáme, můžete ho na řídicím panelu Partnerské centrum. V nabídce Partnerské centrum vyberte CSP a pak Zákazníci. V seznamu zákazníků vyberte zákazníka a pak vyberte Účet. Na stránce Účtu zákazníka vyhledejte ID Microsoftu 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 ekvivalentní s , která bude dál fungovat pouze pro subscriptions/{subscription-id}/usagerecords/resources předplatná Microsoft Azure (MS-AZR-0145P). Tato nová trasa bude podporovat jak předplatná Microsoft Azure (MS-AZR-0145P), tak plány Azure. Abyste tyto informace mohli získat 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 u staré trasy.

C#

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

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

  2. Zavolejte vlastnost Subscriptions a UsageRecords a pak vlastnost Meters. 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:

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI žádosti
Dostat {baseURL}/v1/customers/{ID_tenanta_zákazníka}/subscriptions/{ID_předplatného}/meterusagerecords HTTP/1.1

Parametry identifikátoru URI

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

Název Typ Vyžadováno Popis
customer-tenant-id guid Y Identifikátor GUID odpovídající zákazníkovi.
id předplatného guid Y Identifikátor GUID odpovídající identifikátoru prostředku předplatného Partnerské centrum,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 id plánu jako ID předplatného v této trase.

Hlavičky požadavku

Další informace najdete v Partnerské centrum REST.

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

Odpověď REST

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

Kódy chyb a úspěšné odpovědi

Každá odpověď má stavový kód HTTP, který indikuje úspěch nebo neúspěch 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 Microsoft Azure předplatných (MS-AZR-0145P)

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

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

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

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

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

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

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