Compartir a través de


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}&timespan={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
resourceUri
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.

resultType
query

ResultType

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

MetricBaselinesResponse

Solicitud correcta para obtener la lista de valores de línea base de métricas.

Other Status Codes

ErrorResponse

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
AdditionalInfo

Matriz de objetos con propiedades 'type' y 'info'. El esquema de "info" es específico del servicio y depende de la cadena "type".

BaselineMetadata

Representa un valor de metadatos de línea base.

BaselineSensitivity

la sensibilidad de la línea base.

Error
ErrorDetail

Describe los detalles de una respuesta de error.

ErrorResponse

Describe el formato de respuesta de error.

MetricBaselinesResponse

Lista de líneas base de métricas.

MetricSingleDimension

Nombre y valor de la dimensión de métrica.

ResultType

Permite recuperar solo los metadatos de la línea base. En la solicitud de datos, se recupera toda la información.

SingleBaseline

Valores de línea base para un único valor de confidencialidad.

SingleMetricBaseline

Resultados de línea base de una sola métrica.

TimeSeriesBaseline

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

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

ErrorDetail[]

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

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

Error

MetricBaselinesResponse

Lista de líneas base de métricas.

Nombre Tipo Description
value

SingleMetricBaseline[]

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

BaselineSensitivity

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

TimeSeriesBaseline[]

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

SingleBaseline[]

Valores de línea base para cada confidencialidad.

dimensions

MetricSingleDimension[]

Dimensiones de esta serie temporal.

metadataValues

BaselineMetadata[]

Valores de metadatos de línea base.

timestamps

string[] (date-time)

Lista de marcas de tiempo de las líneas base.