Analizowanie Azure Stack danych za pomocą mierników użycia lokalnego — Modular Data Center (MDC)

Informacje o tym, które subskrypcje używają zasobów przechowywanych w lokalnej bazie danych użycia. Administratorzy mogą pobrać te dane, aby przeanalizować, którzy użytkownicy zużywają zasoby.

Dokumentacja wywołań interfejsu API

Żądanie

Żądanie pobiera szczegóły użycia dla żądanych subskrypcji i dla żądanego okresu. Nie ma treści żądania.

Ten interfejs API użycia jest interfejsem API dostawcy, dlatego wywołujący musi mieć przypisaną rolę właściciela,współautora lub czytelnika w subskrypcji dostawcy.

Metoda Identyfikator URI żądania
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 Opis
armendpoint Azure Resource Manager punktu końcowego Azure Stack środowiska. Konwencja Azure Stack jest taka, że nazwa punktu końcowego Azure Resource Manager jest w formacie https://adminmanagement.{domain-name} .
subId Identyfikator subskrypcji użytkownika, który wykonuje wywołanie.
reportedStartTime Godzina rozpoczęcia zapytania. Wartość powinna być w Uniwersalny czas koordynowany (UTC) i na początku godziny, na przykład DateTime 13:00. W przypadku agregacji dziennej ustaw tę wartość na północ czasu UTC. W formacie jest używany kod ISO 8601. na przykład , gdzie dwukropek jest znakem ucieczki, a znak plus jest znakem ucieczki do , aby był przyjazny 2015-06-16T18%3a53%3a11%2b00%3a00Z%3a dla %2b URI.
reportedEndTime Godzina zakończenia zapytania. Ograniczenia, które mają zastosowanie reportedStartTime również do tego argumentu. Wartością reportedEndTime nie może być ani w przyszłości, ani bieżąca data. Jeśli tak jest, wynik jest ustawiany na "przetwarzanie nie jest zakończone".
aggregationGranularity Opcjonalny parametr, który ma dwie odrębne potencjalne wartości: codziennie i co godzinę. Zgodnie z sugerowanymi wartościami jedna zwraca dane z dziennym poziomem szczegółowości, a druga jest rozdzielczością godzinową. Opcja dzienna jest opcją domyślną.
subscriberId Identyfikator subskrypcji. Aby uzyskać odfiltrowane dane, wymagany jest identyfikator subskrypcji bezpośredniej dzierżawy dostawcy. Jeśli nie określono parametru identyfikatora subskrypcji, wywołanie zwraca dane użycia dla wszystkich bezpośrednich dzierżaw dostawcy.
api-version Wersja protokołu używanego do tego żądania. Ta wartość jest ustawiona na 2015-06-01-preview .
continuationToken Token pobrany z ostatniego wywołania dostawcy interfejsu API użycia. Ten token jest wymagany, gdy odpowiedź jest większa niż 1000 wierszy. Działa jako zakładka postępu. Jeśli token nie istnieje, dane są pobierane od początku dnia lub godziny na podstawie przekazanego poziomu szczegółowości.

Reakcja

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"

}
},

. . .

Szczegóły odpowiedzi

Argument Opis
id Unikatowy identyfikator agregacji użycia.
name Nazwa agregacji użycia.
type Definicja zasobu.
subscriptionId Identyfikator subskrypcji Azure Stack użytkownika.
usageStartTime Czas rozpoczęcia czasu UTC zasobnika użycia, do którego należy ta agregacja użycia.
usageEndTime Czas zakończenia czasu UTC zasobnika użycia, do którego należy ta agregacja użycia.
instanceData Pary klucz-wartość szczegółów wystąpienia (w nowym formacie):
resourceUri: w pełni kwalifikowany identyfikator zasobu, który zawiera grupy zasobów i nazwę wystąpienia.
location: region, w którym ta usługa została uruchamiana.
tags: tagi zasobów określone przez użytkownika.
additionalInfo: więcej szczegółowych informacji o zużytym zasobie; na przykład wersja systemu operacyjnego lub typ obrazu.
quantity Ilość zużycia zasobów, które wystąpiło w tym okresie.
meterId Unikatowy identyfikator zasobu, który został zużyty (nazywany również ResourceID ).

Pobieranie informacji o użyciu

PowerShell

Aby wygenerować dane użycia, musisz mieć zasoby, które są uruchomione i aktywnie z systemu; na przykład aktywna maszyna wirtualna lub konto magazynu zawierające dane. Jeśli nie masz pewności, czy masz jakiekolwiek zasoby uruchomione w witrynie Azure Stack Marketplace, wd wdrażaj maszynę wirtualną i sprawdź, czy blok monitorowania maszyny wirtualnej jest uruchomiony. Użyj następujących poleceń cmdlet programu PowerShell, aby wyświetlić dane użycia.

  1. Zainstaluj program PowerShell dla Azure Stack.

  2. Skonfiguruj użytkownika Azure Stack użytkownika lub Azure Stack środowiska PowerShell operatora.

  3. Aby pobrać dane użycia, wywołaj polecenie cmdlet Get-AzsSubscriberUsage programu PowerShell:

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

Interfejs API REST

Informacje o użyciu usuniętych subskrypcji można zbierać, wywołując usługę Microsoft.Commerce.Admin.

Zwracanie całego użycia dzierżawy dla usuniętych aktywnych użytkowników

Metoda Identyfikator URI żądania
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview

Zwracanie użycia dla usuniętej lub aktywnej dzierżawy

Metoda Identyfikator URI żądania
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