Baselines - List
Visar en lista över måttbaslinjevärden för en resurs.
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
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Resursens identifierare. |
|
api-version
|
query | True |
string minLength: 1 |
DEN API-version som ska användas för den här åtgärden. |
|
$filter
|
query |
string |
$filter används för att minska mängden måttdata som returneras. Exempel: Mått innehåller metadata A, B och C. - Returnera alla tidsserier för C där A = a1 och B = b1 eller b2 $filter=A eq 'a1' och B eq 'b1' eller B eq 'b2' och C eq '*' - Ogiltig variant: $filter=A eq 'a1' and B eq 'b1' and C eq '*' or B = 'b2' Detta är ogiltigt eftersom den logiska eller operatorn inte kan separera två olika metadatanamn. - Returnera alla tidsserier där A = a1, B = b1 och C = c1: $filter=A eq 'a1' och B eq 'b1' och C eq 'c1' - Return all time series where A = a1 $filter=A eq 'a1' and B eq '' and C eq ''. Specialfall: När dimensionsnamn eller dimensionsvärde använder runda hakparenteser. T.ex. när dimensionsnamnet är dim (test) 1 I stället för att använda $filter= "dim (test) 1 eq '' " använder du **$filter= "dim %2528test%2529 1 eq '' "** När dimensionsnamnet är dim (test) 3 och dimensionsvärdet är dim3 (test) val I stället för att använda $filter= "dim (test) 3 eq 'dim3 (test) val' " use $filter= "dim %2528test%2529 3 eq 'dim3 %2528test%2529 val' " |
|
|
aggregation
|
query |
string |
Listan över sammansättningstyper (kommaavgränsade) som ska hämtas. |
|
|
interval
|
query |
string (duration) |
Intervallet (t.ex. timegrain) för frågan. |
|
|
metricnames
|
query |
string |
Namnen på måtten (kommaavgränsade) som ska hämtas. Specialfall: Om ett måttnamn i sig har ett kommatecken i sig använder du %2 för att ange det. Till exempel: "Mått, namn1" ska vara "Mått%2Name1" |
|
|
metricnamespace
|
query |
string |
Måttnamnområde som innehåller de begärda måttnamnen. |
|
|
result
|
query |
Tillåter endast hämtning av metadata för baslinjen. Vid databegäran hämtas all information. |
||
|
sensitivities
|
query |
string |
Listan över känsligheter (kommaavgränsade) att hämta. |
|
|
timespan
|
query |
string |
Tidsintervallet för frågan. Det är en sträng med följande format startDateTime_ISO/endDateTime_ISO. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Lyckad begäran om att hämta listan över måttbaslinjevärden. |
|
| Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2-flöde
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
Get metric baselines
Exempelbegäran
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
Exempelsvar
{
"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
]
}
]
}
]
}
}
]
}
Definitioner
| Name | Description |
|---|---|
|
Additional |
En matris med objekt med egenskaperna "type" och "info". Schemat för "info" är tjänstspecifikt och beroende av strängen "typ". |
|
Baseline |
Representerar ett metadatavärde för baslinjen. |
|
Baseline |
baslinjens känslighet. |
| Error | |
|
Error |
Beskriver information om ett felsvar. |
|
Error |
Beskriver formatet för Felsvar. |
|
Metric |
En lista över måttbaslinjer. |
|
Metric |
Måttdimensionens namn och värde. |
|
Result |
Tillåter endast hämtning av metadata för baslinjen. Vid databegäran hämtas all information. |
|
Single |
Baslinjevärdena för ett enda känslighetsvärde. |
|
Single |
Baslinjeresultatet för ett enda mått. |
|
Time |
Baslinjevärdena för en enskild tidsserie. |
AdditionalInfo
En matris med objekt med egenskaperna "type" och "info". Schemat för "info" är tjänstspecifikt och beroende av strängen "typ".
| Name | Typ | Description |
|---|---|---|
| info |
object |
Ytterligare information som är specifik för typen. |
| type |
string |
Typ av ytterligare information. |
BaselineMetadata
Representerar ett metadatavärde för baslinjen.
| Name | Typ | Description |
|---|---|---|
| name |
string |
Namnet på baslinjemetadata. |
| value |
string |
Värdet för baslinjemetadata. |
BaselineSensitivity
baslinjens känslighet.
| Värde | Description |
|---|---|
| Low | |
| Medium | |
| High |
Error
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
En matris med objekt med egenskaperna "type" och "info". Schemat för "info" är tjänstspecifikt och beroende av strängen "typ". |
|
| code |
string |
Oallokerad sträng som kan användas för att programmatiskt identifiera felet. |
| details |
En matris med ytterligare kapslade felsvarsinformationsobjekt enligt beskrivningen i det här kontraktet. |
|
| message |
string |
Beskriver felet i detalj och tillhandahåller felsökningsinformation. Om Accept-Language anges i begäran måste det lokaliseras till det språket. |
| target |
string |
Målet för det specifika felet (till exempel namnet på egenskapen i fel). |
ErrorDetail
Beskriver information om ett felsvar.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
En matris med objekt med egenskaperna "type" och "info". Schemat för "info" är tjänstspecifikt och beroende av strängen "typ". |
|
| code |
string |
Oallokerad sträng som kan användas för att programmatiskt identifiera felet. |
| message |
string |
Beskriver felet i detalj och tillhandahåller felsökningsinformation. |
| target |
string |
Målet för det specifika felet (till exempel namnet på egenskapen i fel). |
ErrorResponse
Beskriver formatet för Felsvar.
| Name | Typ | Description |
|---|---|---|
| error |
MetricBaselinesResponse
En lista över måttbaslinjer.
| Name | Typ | Description |
|---|---|---|
| value |
Listan över måttbaslinjer. |
MetricSingleDimension
Måttdimensionens namn och värde.
| Name | Typ | Description |
|---|---|---|
| name |
string |
Namnet på dimensionen. |
| value |
string |
Dimensionens värde. |
ResultType
Tillåter endast hämtning av metadata för baslinjen. Vid databegäran hämtas all information.
| Värde | Description |
|---|---|
| Data | |
| Metadata |
SingleBaseline
Baslinjevärdena för ett enda känslighetsvärde.
| Name | Typ | Description |
|---|---|---|
| highThresholds |
number[] (double) |
De höga tröskelvärdena för baslinjen. |
| lowThresholds |
number[] (double) |
De låga tröskelvärdena för baslinjen. |
| sensitivity |
baslinjens känslighet. |
SingleMetricBaseline
Baslinjeresultatet för ett enda mått.
| Name | Typ | Description |
|---|---|---|
| id |
string |
Måttbaslinje-ID. |
| name |
string |
Namnet på måttet som baslinjerna hämtades för. |
| properties.baselines |
Baslinjen för varje tidsserie som efterfrågades. |
|
| properties.interval |
string (duration) |
Intervallet (fönsterstorlek) som måttdata returnerades för. Detta kan justeras i framtiden och returneras från det som ursprungligen begärdes. Detta finns inte om en metadatabegäran har gjorts. |
| properties.namespace |
string |
Namnområdet för måtten har efterfrågats. |
| properties.timespan |
string |
Tidsintervallet för vilken data hämtades. Dess värde består av två sammanlänkade datetimes, avgränsade med "/". Detta kan justeras i framtiden och returneras från det som ursprungligen begärdes. |
| type |
string |
Resurstypen för måttbaslinjeresursen. |
TimeSeriesBaseline
Baslinjevärdena för en enskild tidsserie.
| Name | Typ | Description |
|---|---|---|
| aggregation |
string |
Måttets sammansättningstyp. |
| data |
Baslinjevärdena för varje känslighet. |
|
| dimensions |
Dimensionerna för den här tidsserien. |
|
| metadataValues |
Metadatavärdena för baslinjen. |
|
| timestamps |
string[] (date-time) |
Listan över tidsstämplar för baslinjerna. |