Analysera Azure Stack-användning med lokala användningsmätare – Modular Data Center (MDC)

Information om vilka prenumerationer som använder vilka resurser som lagras i en lokal användningsdatabas. Administratörer kan hämta dessa data för att analysera vilka användare som förbrukar resurser.

Referens för API-anrop

Förfrågan

Begäran hämtar förbrukningsinformation för de begärda prenumerationerna och för den begärda tidsramen. Det finns ingen begärandetext.

Det här användnings-API:et är ett provider-API, så anroparen måste tilldelas rollen Ägare, Deltagare eller Läsare i providerns prenumeration.

Metod URI för förfrågan
GET https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&subscriberId={sub1.1}&api-version=2015-06-01-preview&continuationToken={token-value}

Argument

Argument Description
armendpoint Azure Resource Manager slutpunkt för din Azure Stack-miljö. Azure Stack-konventionen är att namnet på Azure Resource Manager-slutpunkten har formatet https://adminmanagement.{domain-name}.
subId Prenumerations-ID för den användare som gör anropet.
reportedStartTime Starttid för frågan. Värdet för DateTime ska vara i Coordinated Universal Time (UTC) och i början av timmen, till exempel 13:00. För daglig aggregering anger du det här värdet till UTC midnatt. Formatet är undantaget ISO 8601; till exempel 2015-06-16T18%3a53%3a11%2b00%3a00Z, där kolonet är undantaget till %3a och plustecknet är undantaget så %2b att det är URI-vänligt.
reportedEndTime Sluttid för frågan. De begränsningar som gäller för reportedStartTime gäller även för det här argumentet. Värdet för reportedEndTime får inte vara antingen i framtiden eller aktuellt datum. Om så är fallet är resultatet inställt på "bearbetningen är inte slutförd".
aggregationGranularity Valfri parameter som har två diskreta potentiella värden: varje dag och varje timme. Som värdena antyder returnerar en data i daglig kornighet och den andra är en timupplösning. Det dagliga alternativet är standard.
subscriberId Prenumerations-ID. För att hämta filtrerade data krävs prenumerations-ID för en direkt klientorganisation för providern. Om ingen parameter för prenumerations-ID anges returnerar anropet användningsdata för alla providerns direkta klienter.
api-version Version av protokollet som används för att göra den här begäran. Det här värdet är inställt på 2015-06-01-preview.
continuationToken Token som hämtats från det senaste anropet till api-providern för användning. Denna token behövs när ett svar är större än 1 000 rader. Den fungerar som ett bokmärke för förloppet. Om token inte finns hämtas data från början av dagen eller timmen, baserat på den kornighet som skickades in.

Svarsåtgärder

GET
/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0
{
"value": [
{

"id":
"/subscriptions/sub1.1/providers/Microsoft.Commerce.Admin/UsageAggregate/sub1.1-

meterID1",
"name": "sub1.1-meterID1",
"type": "Microsoft.Commerce.Admin/UsageAggregate",

"properties": {
"subscriptionId":"sub1.1",
"usageStartTime": "2015-03-03T00:00:00+00:00",
"usageEndTime": "2015-03-04T00:00:00+00:00",
"instanceData":"{\"Microsoft.Resources\":{\"resourceUri\":\"resourceUri1\",\"location\":\"Alaska\",\"tags\":null,\"additionalInfo\":null}}",
"quantity":2.4000000000,
"meterId":"meterID1"

}
},

. . .

Svarsinformation

Argument Description
id Unikt ID för användningsmängden.
name Namnet på användningsmängden.
type Resursdefinition.
subscriptionId Prenumerationsidentifierare för Azure Stack-användaren.
usageStartTime UTC-starttiden för användningsbucketen som den här användningsmängden tillhör.
usageEndTime UTC-sluttiden för den användningsbucket som den här användningsmängden tillhör.
instanceData Nyckel/värde-par med instansinformation (i ett nytt format):
resourceUri: Fullständigt kvalificerat resurs-ID, som innehåller resursgrupperna och instansnamnet.
location: Region där den här tjänsten kördes.
tags: Resurstaggar som anges av användaren.
additionalInfo: Mer information om resursen som förbrukades; till exempel operativsystemets version eller avbildningstyp.
quantity Mängden resursförbrukning som inträffat under den här tidsramen.
meterId Unikt ID för den resurs som förbrukades (kallas ResourceIDäven ).

Hämta användningsinformation

PowerShell

Om du vill generera användningsdata bör du ha resurser som körs och aktivt använder systemet. till exempel en aktiv virtuell dator (VM) eller ett lagringskonto som innehåller vissa data. Om du inte är säker på om du har några resurser som körs på Azure Stack Marketplace distribuerar du en virtuell dator och kontrollerar övervakningsbladet för den virtuella datorn för att kontrollera att den körs. Använd följande PowerShell-cmdletar för att visa användningsdata.

  1. Installera PowerShell för Azure Stack.

  2. Konfigurera Azure Stack-användaren eller Azure Stack-operatörens PowerShell-miljö.

  3. Om du vill hämta användningsdata anropar du PowerShell-cmdleten Get-AzsSubscriberUsage :

    Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"
    

REST-API

Du kan samla in användningsinformation för borttagna prenumerationer genom att anropa Microsoft.Commerce. Admin tjänsten.

Returnera all klientanvändning för borttagna för aktiva användare

Metod URI för förfrågan
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview

Returnera användning för borttagen eller aktiv klientorganisation

Metod URI för förfrågan
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&subscriberId={subscriber-id}&api-version=2015-06-01-preview