Analýza Azure Stack dat s využitím měřičů místního využití – Modulární datové centrum (MDC)

Informace o tom, která předplatná používají prostředky uložené v místní databázi využití. Správci můžou tato data načíst, aby mohli analyzovat, kteří uživatelé spotřebovávají prostředky.

Referenční informace k volání rozhraní API

Žádost

Požadavek získá podrobnosti o spotřebě pro požadovaná předplatná a pro požadovaný časový rámec. Neexistuje žádný text požadavku.

Toto rozhraní API využití je rozhraní API poskytovatele, takže volajícímu musí být v předplatném poskytovatele přiřazena roleVlastník,Přispěvatel nebo Čtenář.

Metoda Identifikátor URI žádosti
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}

Argumenty

Argument Popis
armendpoint Azure Resource Manager koncového bodu vašeho Azure Stack prostředí. Konvence Azure Stack je, že název koncového bodu Azure Resource Manager ve formátu https://adminmanagement.{domain-name} .
subId ID předplatného uživatele, který provádí volání.
reportedStartTime Počáteční čas dotazu. Hodnota pro by měla být ve standardu UTC (Coordinated Universal Time) a na začátku hodiny, například DateTime 13:00. Pro denní agregaci nastavte tuto hodnotu na půlnoc v UTC. Formát je uvozena uvozovacími znaky ISO 8601. Například , kde dvojtečka je uvozena na a znak plus je uvozena tak, aby byla 2015-06-16T18%3a53%3a11%2b00%3a00Z%3a%2b popisná identifikátoru URI.
reportedEndTime Koncový čas dotazu. Omezení, která platí také reportedStartTime pro tento argument. Hodnota reportedEndTime pro nemůže být buď v budoucnosti, nebo aktuální datum. Pokud je, je výsledek nastavený na "zpracování není dokončeno".
aggregationGranularity Volitelný parametr, který má dvě diskrétní potenciální hodnoty: denněa každou hodinu. Jak hodnoty naznačují, jedna vrací data v denních členitostech a druhá je hodinové rozlišení. Denní možnost je výchozí.
subscriberId ID předplatného. K získání filtrovaných dat se vyžaduje ID předplatného přímého tenanta poskytovatele. Pokud není zadaný žádný parametr ID předplatného, vrátí volání data o využití pro všechny přímé tenanty poskytovatele.
api-version Verze protokolu, která se používá k provedení tohoto požadavku. Tato hodnota je nastavená na 2015-06-01-preview .
continuationToken Token načtený z posledního volání zprostředkovatele rozhraní API pro využití. Tento token je potřeba, když je odpověď větší než 1 000 řádků. Funguje jako záložka pro průběh. Pokud token neexistuje, data se načtou od začátku dne nebo hodiny na základě předané členitosti.

Odpověď

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"

}
},

. . .

Podrobnosti odpovědi

Argument Popis
id Jedinečné ID agregace využití
name Název agregace využití
type Definice prostředku.
subscriptionId Identifikátor předplatného Azure Stack uživatele.
usageStartTime Počáteční čas UTC pro kbelík využití, do kterého tato agregace využití patří.
usageEndTime Koncový čas UTC pro kbelík využití, do kterého tato agregace využití patří.
instanceData Páry klíč-hodnota podrobností instance (v novém formátu):
resourceUri: Plně kvalifikované ID prostředku, které zahrnuje skupiny prostředků a název instance.
location: Oblast, ve které byla tato služba spuštěna.
tags: Značky prostředků, které jsou určené uživatelem.
additionalInfo: Další podrobnosti o spotřebovaném prostředku. Například verze operačního systému nebo typ image.
quantity Množství spotřeby prostředků, ke kterým došlo v tomto časovém rámci
meterId Jedinečné ID spotřebovaného prostředku (nazývaného ResourceID také ).

Načtení informací o využití

PowerShell

Pokud chcete vygenerovat data o využití, měli byste mít prostředky, které jsou spuštěné a aktivně používají systém. Například aktivní virtuální počítač nebo účet úložiště obsahující nějaká data. Pokud si nejste jistí, jestli máte nějaké prostředky spuštěné na Azure Stack Marketplace, nasaďte virtuální počítač a ověřte okno monitorování virtuálního počítače, abyste se ujistili, že je spuštěný. K zobrazení dat o využití použijte následující rutiny PowerShellu.

  1. Nainstalujte PowerShell pro Azure Stack.

  2. Nakonfigurujte Azure Stack uživatele neboAzure Stack prostředí PowerShellu.

  3. Pokud chcete načíst data o využití, zavolejte rutinu PowerShellu Get-AzsSubscriberUsage:

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

REST API

Informace o využití odstraněných předplatných můžete shromažďovat voláním služby Microsoft.Commerce.Admin.

Vrácení veškerého využití tenanta pro odstraněné aktivní uživatele

Metoda Identifikátor URI žádosti
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview

Vrácení využití pro odstraněné nebo aktivního tenanta

Metoda Identifikátor URI žádosti
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