Condividi tramite


Baselines - List

Elenca i valori di base delle metriche per una risorsa.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceUri
path True

string

Identificatore della risorsa.

api-version
query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

$filter
query

string

Il $filter viene usato per ridurre il set di dati delle metriche restituiti. Esempio: la metrica contiene metadati A, B e C. - Restituisce tutte le serie temporali di C dove A = a1 e B = b1 o b2 $filter=A eq 'a1' eq 'b1' o B eq 'b2' eq '*' - Variante non valida: $filter=A eq 'a1' e B eq 'b1' eq '*' o B = 'b2' Questo non è valido perché l'operatore logico o non può separare due nomi di metadati diversi. - Restituisce tutte le serie temporali in cui A = a1, B = b1 e C = c1: $filter=A eq 'a1' e B eq 'b1' eQ 'c1' - Restituisce tutte le serie temporali dove A = a1 $filter=A eq 'a1' e B eq '' eq ''. Caso speciale: quando il nome della dimensione o il valore della dimensione utilizza parentesi quadre arrotondate. Eg: When dimension name is dim (test) 1 Instead of using $filter= "dim (test) 1 eq '' " use **$filter= "dim %2528test%2529 1 eq '' "** When dimension name is dim (test) 3 e il valore della dimensione sono dim3 (test) val anziché usare $filter= "dim (test) 3 eq 'dim3 (test) val' " use $filter= "dim %2528test%2529 3 eq 'dim3 %2528test%2529 val' "

aggregation
query

string

Elenco di tipi di aggregazione (delimitati da virgole) da recuperare.

interval
query

string (duration)

Intervallo (ad esempio timegrain) della query.

metricnames
query

string

Nomi delle metriche (delimitate da virgole) da recuperare. Caso speciale: se un nome metrico stesso contiene una virgola, usare %2 per indicare il nome. Ad esempio: 'Metric,Name1' deve essere 'Metric%2Name1'

metricnamespace
query

string

Spazio dei nomi della metrica che contiene i nomi delle metriche richieste.

resultType
query

ResultType

Consente di recuperare solo i metadati della baseline. Nella richiesta di dati vengono recuperate tutte le informazioni.

sensitivities
query

string

Elenco di sensibilità (delimitate da virgole) da recuperare.

timespan
query

string

Intervallo di tempo della query. Si tratta di una stringa con il formato seguente 'startDateTime_ISO/endDateTime_ISO'.

Risposte

Nome Tipo Descrizione
200 OK

MetricBaselinesResponse

Richiesta riuscita per ottenere l'elenco dei valori di base delle metriche.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Get metric baselines

Esempio di richiesta

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

Risposta di esempio

{
  "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
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

Definizioni

Nome Descrizione
AdditionalInfo

Matrice di oggetti con proprietà 'type' e 'info'. Lo schema di 'info' è specifico del servizio e dipende dalla stringa 'type'.

BaselineMetadata

Rappresenta un valore di metadati di base.

BaselineSensitivity

sensibilità della linea di base.

Error
ErrorDetail

Descrive i dettagli di una risposta di errore.

ErrorResponse

Descrive il formato della risposta di errore.

MetricBaselinesResponse

Elenco delle baseline delle metriche.

MetricSingleDimension

Nome e valore della dimensione della metrica.

ResultType

Consente di recuperare solo i metadati della baseline. Nella richiesta di dati vengono recuperate tutte le informazioni.

SingleBaseline

Valori di base per un singolo valore di riservatezza.

SingleMetricBaseline

Risultati di base di una singola metrica.

TimeSeriesBaseline

Valori di base per una singola serie temporale.

AdditionalInfo

Matrice di oggetti con proprietà 'type' e 'info'. Lo schema di 'info' è specifico del servizio e dipende dalla stringa 'type'.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive specifiche del tipo.

type

string

Tipo di informazioni aggiuntive.

BaselineMetadata

Rappresenta un valore di metadati di base.

Nome Tipo Descrizione
name

string

Nome dei metadati della baseline.

value

string

Valore dei metadati di base.

BaselineSensitivity

sensibilità della linea di base.

Valore Descrizione
Low
Medium
High

Error

Nome Tipo Descrizione
additionalInfo

AdditionalInfo[]

Matrice di oggetti con proprietà 'type' e 'info'. Lo schema di 'info' è specifico del servizio e dipende dalla stringa 'type'.

code

string

Stringa non localizzata che può essere usata per identificare l'errore a livello di codice.

details

ErrorDetail[]

Matrice di altri oggetti informazioni di risposta agli errori annidati, come descritto da questo contratto.

message

string

Descrive l'errore in dettaglio e fornisce informazioni di debug. Se Accept-Language è impostato nella richiesta, deve essere localizzato in tale lingua.

target

string

Destinazione dell'errore specifico, ad esempio il nome della proprietà in errore.

ErrorDetail

Descrive i dettagli di una risposta di errore.

Nome Tipo Descrizione
additionalInfo

AdditionalInfo[]

Matrice di oggetti con proprietà 'type' e 'info'. Lo schema di 'info' è specifico del servizio e dipende dalla stringa 'type'.

code

string

Stringa non localizzata che può essere usata per identificare l'errore a livello di codice.

message

string

Descrive l'errore in dettaglio e fornisce informazioni di debug.

target

string

Destinazione dell'errore specifico, ad esempio il nome della proprietà in errore.

ErrorResponse

Descrive il formato della risposta di errore.

Nome Tipo Descrizione
error

Error

MetricBaselinesResponse

Elenco delle baseline delle metriche.

Nome Tipo Descrizione
value

SingleMetricBaseline[]

Elenco delle baseline delle metriche.

MetricSingleDimension

Nome e valore della dimensione della metrica.

Nome Tipo Descrizione
name

string

Nome della dimensione.

value

string

Valore della dimensione.

ResultType

Consente di recuperare solo i metadati della baseline. Nella richiesta di dati vengono recuperate tutte le informazioni.

Valore Descrizione
Data
Metadata

SingleBaseline

Valori di base per un singolo valore di riservatezza.

Nome Tipo Descrizione
highThresholds

number[] (double)

Soglie elevate della linea di base.

lowThresholds

number[] (double)

Soglie basse della linea di base.

sensitivity

BaselineSensitivity

sensibilità della linea di base.

SingleMetricBaseline

Risultati di base di una singola metrica.

Nome Tipo Descrizione
id

string

ID baseline della metrica.

name

string

Nome della metrica per cui sono state recuperate le baseline.

properties.baselines

TimeSeriesBaseline[]

Baseline per ogni serie temporale su cui è stata eseguita una query.

properties.interval

string (duration)

Intervallo (dimensioni della finestra) in cui sono stati restituiti i dati delle metriche. Questo può essere modificato in futuro e restituito da ciò che è stato originariamente richiesto. Non è presente se è stata effettuata una richiesta di metadati.

properties.namespace

string

Lo spazio dei nomi delle metriche è stato sottoposto a query.

properties.timespan

string

Intervallo di tempo per il quale sono stati recuperati i dati. Il valore è costituito da due datetime concatenate, separate da '/'. Questo può essere modificato in futuro e restituito da ciò che è stato originariamente richiesto.

type

string

Tipo di risorsa della risorsa di base della metrica.

TimeSeriesBaseline

Valori di base per una singola serie temporale.

Nome Tipo Descrizione
aggregation

string

Tipo di aggregazione della metrica.

data

SingleBaseline[]

Valori di base per ogni riservatezza.

dimensions

MetricSingleDimension[]

Dimensioni di questa serie temporale.

metadataValues

BaselineMetadata[]

Valori dei metadati di base.

timestamps

string[] (date-time)

Elenco di timestamp delle linee di base.