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}×pan={timespan}&interval={interval}&aggregation={aggregation}&sensitivities={sensitivities}&$filter={$filter}&resultType={resultType}&api-version=2019-03-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
resource
|
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. |
|
|
result
|
query |
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 |
Richiesta riuscita per ottenere l'elenco dei valori di base delle metriche. |
|
| Other Status Codes |
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 |
|---|---|
|
Additional |
Matrice di oggetti con proprietà 'type' e 'info'. Lo schema di 'info' è specifico del servizio e dipende dalla stringa 'type'. |
|
Baseline |
Rappresenta un valore di metadati di base. |
|
Baseline |
sensibilità della linea di base. |
| Error | |
|
Error |
Descrive i dettagli di una risposta di errore. |
|
Error |
Descrive il formato della risposta di errore. |
|
Metric |
Elenco delle baseline delle metriche. |
|
Metric |
Nome e valore della dimensione della metrica. |
|
Result |
Consente di recuperare solo i metadati della baseline. Nella richiesta di dati vengono recuperate tutte le informazioni. |
|
Single |
Valori di base per un singolo valore di riservatezza. |
|
Single |
Risultati di base di una singola metrica. |
|
Time |
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 |
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 |
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 |
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 |
MetricBaselinesResponse
Elenco delle baseline delle metriche.
| Nome | Tipo | Descrizione |
|---|---|---|
| value |
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 |
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 |
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 |
Valori di base per ogni riservatezza. |
|
| dimensions |
Dimensioni di questa serie temporale. |
|
| metadataValues |
Valori dei metadati di base. |
|
| timestamps |
string[] (date-time) |
Elenco di timestamp delle linee di base. |