Baselines - List
Enumera los valores de línea base de métrica de un recurso.
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
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Identificador del recurso. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de la API que se va a usar para esta operación. |
|
$filter
|
query |
string |
El $filter se usa para reducir el conjunto de datos de métricas devueltos. Ejemplo: La métrica contiene los metadatos A, B y C. - Devuelve toda la serie temporal de C donde A = a1 y B = b1 o b2 $filter=A eq 'a1' y B eq 'b1' o B eq 'b2' y C eq '*' - Variante no válida: $filter=A eq 'a1' y B eq 'b1' y C eq '*' o B = 'b2' Esto no es válido porque el operador lógico o no puede separar dos nombres de metadatos diferentes. - Devuelve todas las series temporales donde A = a1, B = b1 y C = c1: $filter=A eq 'a1' y B eq 'b1' y C eq 'c1' - Devuelve todas las series temporales donde A = a1 $filter=A eq 'a1' y B eq '' y C eq ''. Caso especial: cuando el nombre de dimensión o el valor de dimensión usan corchetes redondos. Por ejemplo: Cuando el nombre de dimensión es dim (test) 1 En lugar de usar $filter= "dim (test) 1 eq '' " use **$filter= "dim %2528test%2529 1 eq '' "** When dimension name is dim (test) 3 y valor de dimensión es valor dim3 (test) val En lugar de usar $filter= "dim (test) 3 eq 'dim3 (test) val' " use $filter= "dim %2528test%2529 3 eq 'dim3 %2528test%2529 val' " |
|
|
aggregation
|
query |
string |
Lista de tipos de agregación (separados por comas) que se van a recuperar. |
|
|
interval
|
query |
string (duration) |
Intervalo (es decir, timegrain) de la consulta. |
|
|
metricnames
|
query |
string |
Nombres de las métricas (separadas por comas) que se van a recuperar. Caso especial: si un nombre de métrica tiene una coma en ella, use %2 para indicarlo. Por ejemplo: 'Métrica,Nombre1' debe ser 'Métrica%2Name1' |
|
|
metricnamespace
|
query |
string |
Espacio de nombres de métrica que contiene los nombres de métrica solicitados. |
|
|
result
|
query |
Permite recuperar solo los metadatos de la línea base. En la solicitud de datos, se recupera toda la información. |
||
|
sensitivities
|
query |
string |
Lista de sensibilidades (separadas por comas) que se van a recuperar. |
|
|
timespan
|
query |
string |
Intervalo de tiempo de la consulta. Es una cadena con el siguiente formato "startDateTime_ISO/endDateTime_ISO". |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Solicitud correcta para obtener la lista de valores de línea base de métricas. |
|
| Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar la cuenta de usuario |
Ejemplos
Get metric baselines
Solicitud de ejemplo
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
Respuesta de muestra
{
"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
]
}
]
}
]
}
}
]
}
Definiciones
| Nombre | Description |
|---|---|
|
Additional |
Matriz de objetos con propiedades 'type' y 'info'. El esquema de "info" es específico del servicio y depende de la cadena "type". |
|
Baseline |
Representa un valor de metadatos de línea base. |
|
Baseline |
la sensibilidad de la línea base. |
| Error | |
|
Error |
Describe los detalles de una respuesta de error. |
|
Error |
Describe el formato de respuesta de error. |
|
Metric |
Lista de líneas base de métricas. |
|
Metric |
Nombre y valor de la dimensión de métrica. |
|
Result |
Permite recuperar solo los metadatos de la línea base. En la solicitud de datos, se recupera toda la información. |
|
Single |
Valores de línea base para un único valor de confidencialidad. |
|
Single |
Resultados de línea base de una sola métrica. |
|
Time |
Los valores de línea base de una sola serie temporal. |
AdditionalInfo
Matriz de objetos con propiedades 'type' y 'info'. El esquema de "info" es específico del servicio y depende de la cadena "type".
| Nombre | Tipo | Description |
|---|---|---|
| info |
object |
Información adicional específica del tipo. |
| type |
string |
Tipo de información adicional. |
BaselineMetadata
Representa un valor de metadatos de línea base.
| Nombre | Tipo | Description |
|---|---|---|
| name |
string |
Nombre de los metadatos de línea base. |
| value |
string |
Valor de los metadatos de línea base. |
BaselineSensitivity
la sensibilidad de la línea base.
| Valor | Description |
|---|---|
| Low | |
| Medium | |
| High |
Error
| Nombre | Tipo | Description |
|---|---|---|
| additionalInfo |
Matriz de objetos con propiedades 'type' y 'info'. El esquema de "info" es específico del servicio y depende de la cadena "type". |
|
| code |
string |
Cadena no localizada que se puede usar para identificar mediante programación el error. |
| details |
Matriz de objetos de información de respuesta de error anidados adicionales, como se describe en este contrato. |
|
| message |
string |
Describe el error en detalle y proporciona información de depuración. Si Accept-Language se establece en la solicitud, debe localizarse en ese idioma. |
| target |
string |
Destino del error concreto (por ejemplo, el nombre de la propiedad en error). |
ErrorDetail
Describe los detalles de una respuesta de error.
| Nombre | Tipo | Description |
|---|---|---|
| additionalInfo |
Matriz de objetos con propiedades 'type' y 'info'. El esquema de "info" es específico del servicio y depende de la cadena "type". |
|
| code |
string |
Cadena no localizada que se puede usar para identificar mediante programación el error. |
| message |
string |
Describe el error en detalle y proporciona información de depuración. |
| target |
string |
Destino del error concreto (por ejemplo, el nombre de la propiedad en error). |
ErrorResponse
Describe el formato de respuesta de error.
| Nombre | Tipo | Description |
|---|---|---|
| error |
MetricBaselinesResponse
Lista de líneas base de métricas.
| Nombre | Tipo | Description |
|---|---|---|
| value |
Lista de líneas base de métricas. |
MetricSingleDimension
Nombre y valor de la dimensión de métrica.
| Nombre | Tipo | Description |
|---|---|---|
| name |
string |
Nombre de la dimensión. |
| value |
string |
Valor de la dimensión. |
ResultType
Permite recuperar solo los metadatos de la línea base. En la solicitud de datos, se recupera toda la información.
| Valor | Description |
|---|---|
| Data | |
| Metadata |
SingleBaseline
Valores de línea base para un único valor de confidencialidad.
| Nombre | Tipo | Description |
|---|---|---|
| highThresholds |
number[] (double) |
Umbrales altos de la línea base. |
| lowThresholds |
number[] (double) |
Umbrales bajos de la línea base. |
| sensitivity |
la sensibilidad de la línea base. |
SingleMetricBaseline
Resultados de línea base de una sola métrica.
| Nombre | Tipo | Description |
|---|---|---|
| id |
string |
Identificador de línea base de métrica. |
| name |
string |
Nombre de la métrica para la que se recuperaron las líneas base. |
| properties.baselines |
Línea base de cada serie temporal consultada. |
|
| properties.interval |
string (duration) |
Intervalo (tamaño de ventana) en el que se devolvieron los datos de métricas. Esto puede ajustarse en el futuro y devolverlo de lo que se solicitó originalmente. Esto no está presente si se realizó una solicitud de metadatos. |
| properties.namespace |
string |
Espacio de nombres de las métricas consultadas. |
| properties.timespan |
string |
Intervalo de tiempo para el que se recuperaron los datos. Su valor consta de dos datetimes concatenados, separados por '/'. Esto puede ajustarse en el futuro y devolverlo de lo que se solicitó originalmente. |
| type |
string |
Tipo de recurso del recurso de línea base de métrica. |
TimeSeriesBaseline
Los valores de línea base de una sola serie temporal.
| Nombre | Tipo | Description |
|---|---|---|
| aggregation |
string |
Tipo de agregación de la métrica. |
| data |
Valores de línea base para cada confidencialidad. |
|
| dimensions |
Dimensiones de esta serie temporal. |
|
| metadataValues |
Valores de metadatos de línea base. |
|
| timestamps |
string[] (date-time) |
Lista de marcas de tiempo de las líneas base. |