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}×pan={timespan}&interval={interval}&aggregation={aggregation}&sensitivities={sensitivities}&$filter={$filter}&resultType={resultType}&api-version=2019-03-01
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
resource
|
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. |
|
|
result
|
query |
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 |
Pomyślne żądanie pobrania listy wartości punktu odniesienia metryki. |
|
| Other Status Codes |
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 |
|---|---|
|
Additional |
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". |
|
Baseline |
Reprezentuje wartość metadanych punktu odniesienia. |
|
Baseline |
czułość punktu odniesienia. |
| Error | |
|
Error |
Opisuje szczegóły odpowiedzi na błąd. |
|
Error |
Opisuje format odpowiedzi Błąd. |
|
Metric |
Lista punktów odniesienia metryk. |
|
Metric |
Nazwa i wartość wymiaru metryki. |
|
Result |
Umożliwia pobieranie tylko metadanych punktu odniesienia. Na żądanie danych są pobierane wszystkie informacje. |
|
Single |
Wartości punktu odniesienia dla pojedynczej wartości poufności. |
|
Single |
Wyniki linii bazowej pojedynczej metryki. |
|
Time |
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 |
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 |
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 |
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 |
MetricBaselinesResponse
Lista punktów odniesienia metryk.
| Nazwa | Typ | Opis |
|---|---|---|
| value |
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 |
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 |
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 |
Wartości punktu odniesienia dla każdej poufności. |
|
| dimensions |
Wymiary tej serii czasowej. |
|
| metadataValues |
Wartości metadanych punktu odniesienia. |
|
| timestamps |
string[] (date-time) |
Lista sygnatur czasowych punktów odniesienia. |