Dela via


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}&timespan={timespan}&interval={interval}&aggregation={aggregation}&sensitivities={sensitivities}&$filter={$filter}&resultType={resultType}&api-version=2019-03-01

URI-parametrar

Name I Obligatorisk Typ Description
resourceUri
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.

resultType
query

ResultType

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

MetricBaselinesResponse

Lyckad begäran om att hämta listan över måttbaslinjevärden.

Other Status Codes

ErrorResponse

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
AdditionalInfo

En matris med objekt med egenskaperna "type" och "info". Schemat för "info" är tjänstspecifikt och beroende av strängen "typ".

BaselineMetadata

Representerar ett metadatavärde för baslinjen.

BaselineSensitivity

baslinjens känslighet.

Error
ErrorDetail

Beskriver information om ett felsvar.

ErrorResponse

Beskriver formatet för Felsvar.

MetricBaselinesResponse

En lista över måttbaslinjer.

MetricSingleDimension

Måttdimensionens namn och värde.

ResultType

Tillåter endast hämtning av metadata för baslinjen. Vid databegäran hämtas all information.

SingleBaseline

Baslinjevärdena för ett enda känslighetsvärde.

SingleMetricBaseline

Baslinjeresultatet för ett enda mått.

TimeSeriesBaseline

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

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

ErrorDetail[]

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

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

Error

MetricBaselinesResponse

En lista över måttbaslinjer.

Name Typ Description
value

SingleMetricBaseline[]

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

BaselineSensitivity

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

TimeSeriesBaseline[]

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

SingleBaseline[]

Baslinjevärdena för varje känslighet.

dimensions

MetricSingleDimension[]

Dimensionerna för den här tidsserien.

metadataValues

BaselineMetadata[]

Metadatavärdena för baslinjen.

timestamps

string[] (date-time)

Listan över tidsstämplar för baslinjerna.