Udostępnij za pośrednictwem


Baselines - List

Wyświetla wartości linii bazowej metryki dla zasobu.

GET https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/metricBaselines?api-version=2019-03-01
GET https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/metricBaselines?metricnames={metricnames}&metricnamespace={metricnamespace}&timespan={timespan}&interval={interval}&aggregation={aggregation}&sensitivities={sensitivities}&$filter={$filter}&resultType={resultType}&api-version=2019-03-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceUri
path True

string

Identyfikator zasobu.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

$filter
query

string

$filter służy do zmniejszenia zestawu zwracanych danych metryk. Przykład: Metryka zawiera metadane A, B i C. - Zwraca cały szereg czasowy C, gdzie A = a1 i B = b1 lub b2 $filter=A eq "a1" i B eq "b1" lub B eq "b2" i C eq "*" - Nieprawidłowy wariant: $filter=A eq "a1" i B eq "b1" i C eq "*" lub B = "b2" Jest to nieprawidłowe, ponieważ operator logiczny lub nie może oddzielić dwóch różnych nazw metadanych. - Zwracanie wszystkich szeregów czasowych, w których A = a1, B = b1 i C = c1: $filter=A eq "a1" i B eq "b1" i C eq "c1" - Zwracaj wszystkie szeregi czasowe, gdzie A = a1 $filter=A eq "a1" i B eq "" i C eq "". Przypadek specjalny: gdy nazwa wymiaru lub wartość wymiaru używa nawiasów okrągłych. Na przykład: Gdy nazwa wymiaru jest dim (test) 1 Zamiast używać $filter= "dim (test) 1 eq '' " użyj **$filter= "dim %2528test%2529 1 eq '' "** Gdy nazwa wymiaru jest dim (test) 3 i wartość wymiaru jest dim3 (test) val Zamiast używać $filter= "dim (test) 3 eq 'dim3 (test) val" użyj $filter= "dim %2528test%2529 3 eq 'dim3 %2528test%2529 val' "

aggregation
query

string

Lista typów agregacji (rozdzielonych przecinkami) do pobrania.

interval
query

string (duration)

Interwał (tj. timegrain) zapytania.

metricnames
query

string

Nazwy metryk (rozdzielone przecinkami) do pobrania. Przypadek specjalny: jeśli sama nazwa metryki ma przecinek, użyj %2, aby ją wskazać. Na przykład: Metryka, Nazwa1 powinna być "Metric%2Name1" (Metric%2Name1)

metricnamespace
query

string

Przestrzeń nazw metryk zawierająca żądane nazwy metryk.

resultType
query

ResultType

Umożliwia pobieranie tylko metadanych punktu odniesienia. Na żądanie danych są pobierane wszystkie informacje.

sensitivities
query

string

Lista poufności (rozdzielonych przecinkami) do pobrania.

timespan
query

string

Przedział czasu zapytania. Jest to ciąg o następującym formacie "startDateTime_ISO/endDateTime_ISO".

Odpowiedzi

Nazwa Typ Opis
200 OK

MetricBaselinesResponse

Pomyślne żądanie pobrania listy wartości punktu odniesienia metryki.

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Get metric baselines

Przykładowe żądanie

GET https://management.azure.com/subscriptions/b368ca2f-e298-46b7-b0ab-012281956afa/resourceGroups/vms/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.Insights/metricBaselines?timespan=2019-03-12T11:00:00.000Z/2019-03-12T12:00:00.000Z&interval=PT1H&aggregation=average&sensitivities=Low,Medium&api-version=2019-03-01

Przykładowa odpowiedź

{
  "value": [
    {
      "id": "/subscriptions/11aeb0ed-456b-4ca0-8df5-b9fbdc63d0d3/resourceGroups/SmartAnalytics-DEV-VM/providers/Microsoft.Compute/virtualMachines/DemoVM1/providers/microsoft.insights/metricBaselines/Percentage CPU",
      "type": "microsoft.insights/metricBaselines",
      "name": "Percentage CPU",
      "properties": {
        "interval": "PT1H",
        "timespan": "2019-03-12T11:00:00.000Z/2019-03-12T12:00:00.000Z",
        "namespace": "microsoft.compute/virtualmachines",
        "baselines": [
          {
            "aggregation": "average",
            "dimensions": [],
            "metadataValues": [
              {
                "name": "ErrorType",
                "value": "TooManyAnomalies"
              },
              {
                "name": "SeasonalityFrequency",
                "value": "288"
              }
            ],
            "timestamps": [
              "2019-03-12T11:00:00.000Z",
              "2019-03-12T12:00:00.000Z"
            ],
            "data": [
              {
                "sensitivity": "Low",
                "lowThresholds": [
                  30,
                  31.1
                ],
                "highThresholds": [
                  90.3453,
                  91.3453
                ]
              },
              {
                "sensitivity": "Medium",
                "lowThresholds": [
                  50,
                  51.1
                ],
                "highThresholds": [
                  70.3453,
                  71.3453
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

Definicje

Nazwa Opis
AdditionalInfo

Tablica obiektów z właściwościami "type" i "info". Schemat "info" jest specyficzny dla usługi i zależny od ciągu "type".

BaselineMetadata

Reprezentuje wartość metadanych punktu odniesienia.

BaselineSensitivity

czułość punktu odniesienia.

Error
ErrorDetail

Opisuje szczegóły odpowiedzi na błąd.

ErrorResponse

Opisuje format odpowiedzi Błąd.

MetricBaselinesResponse

Lista punktów odniesienia metryk.

MetricSingleDimension

Nazwa i wartość wymiaru metryki.

ResultType

Umożliwia pobieranie tylko metadanych punktu odniesienia. Na żądanie danych są pobierane wszystkie informacje.

SingleBaseline

Wartości punktu odniesienia dla pojedynczej wartości poufności.

SingleMetricBaseline

Wyniki linii bazowej pojedynczej metryki.

TimeSeriesBaseline

Wartości punktu odniesienia dla pojedynczej serii czasowej.

AdditionalInfo

Tablica obiektów z właściwościami "type" i "info". Schemat "info" jest specyficzny dla usługi i zależny od ciągu "type".

Nazwa Typ Opis
info

object

Dodatkowe informacje specyficzne dla typu.

type

string

Typ dodatkowych informacji.

BaselineMetadata

Reprezentuje wartość metadanych punktu odniesienia.

Nazwa Typ Opis
name

string

Nazwa metadanych punktu odniesienia.

value

string

Wartość metadanych punktu odniesienia.

BaselineSensitivity

czułość punktu odniesienia.

Wartość Opis
Low
Medium
High

Error

Nazwa Typ Opis
additionalInfo

AdditionalInfo[]

Tablica obiektów z właściwościami "type" i "info". Schemat "info" jest specyficzny dla usługi i zależny od ciągu "type".

code

string

Nielokalizowany ciąg, który może służyć do programowego identyfikowania błędu.

details

ErrorDetail[]

Tablica dodatkowych obiektów informacji o błędach zagnieżdżonych zgodnie z opisem w tym kontrakcie.

message

string

Opisuje szczegółowo błąd i zawiera informacje o debugowaniu. Jeśli Accept-Language jest ustawiona w żądaniu, musi zostać zlokalizowana w tym języku.

target

string

Element docelowy określonego błędu (na przykład nazwa właściwości w błędzie).

ErrorDetail

Opisuje szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
additionalInfo

AdditionalInfo[]

Tablica obiektów z właściwościami "type" i "info". Schemat "info" jest specyficzny dla usługi i zależny od ciągu "type".

code

string

Nielokalizowany ciąg, który może służyć do programowego identyfikowania błędu.

message

string

Opisuje szczegółowo błąd i zawiera informacje o debugowaniu.

target

string

Element docelowy określonego błędu (na przykład nazwa właściwości w błędzie).

ErrorResponse

Opisuje format odpowiedzi Błąd.

Nazwa Typ Opis
error

Error

MetricBaselinesResponse

Lista punktów odniesienia metryk.

Nazwa Typ Opis
value

SingleMetricBaseline[]

Lista punktów odniesienia metryk.

MetricSingleDimension

Nazwa i wartość wymiaru metryki.

Nazwa Typ Opis
name

string

Nazwa wymiaru.

value

string

Wartość wymiaru.

ResultType

Umożliwia pobieranie tylko metadanych punktu odniesienia. Na żądanie danych są pobierane wszystkie informacje.

Wartość Opis
Data
Metadata

SingleBaseline

Wartości punktu odniesienia dla pojedynczej wartości poufności.

Nazwa Typ Opis
highThresholds

number[] (double)

Wysokie progi punktu odniesienia.

lowThresholds

number[] (double)

Niskie progi punktu odniesienia.

sensitivity

BaselineSensitivity

czułość punktu odniesienia.

SingleMetricBaseline

Wyniki linii bazowej pojedynczej metryki.

Nazwa Typ Opis
id

string

Identyfikator punktu odniesienia metryki.

name

string

Nazwa metryki, dla której pobrano punkty odniesienia.

properties.baselines

TimeSeriesBaseline[]

Punkt odniesienia dla każdej serii czasowej, dla których wykonano zapytanie.

properties.interval

string (duration)

Interwał (rozmiar okna), dla którego zostały zwrócone dane metryk. Może to zostać skorygowane w przyszłości i zwrócone z tego, czego pierwotnie zażądano. Nie jest to obecne, jeśli zostało wykonane żądanie metadanych.

properties.namespace

string

Przestrzeń nazw metryk została zapytana.

properties.timespan

string

Przedział czasu, dla którego pobrano dane. Jej wartość składa się z dwóch połączonych dat/godzin rozdzielonych znakami "/". Może to zostać skorygowane w przyszłości i zwrócone z tego, czego pierwotnie zażądano.

type

string

Typ zasobu bazowego metryki.

TimeSeriesBaseline

Wartości punktu odniesienia dla pojedynczej serii czasowej.

Nazwa Typ Opis
aggregation

string

Typ agregacji metryki.

data

SingleBaseline[]

Wartości punktu odniesienia dla każdej poufności.

dimensions

MetricSingleDimension[]

Wymiary tej serii czasowej.

metadataValues

BaselineMetadata[]

Wartości metadanych punktu odniesienia.

timestamps

string[] (date-time)

Lista sygnatur czasowych punktów odniesienia.