Parámetros de recursos de libro

Los parámetros de recursos permiten la selección de recursos de los libros. Esta funcionalidad se usa para establecer el ámbito del que se van a obtener los datos. Un ejemplo sería permitirle seleccionar el conjunto de máquinas virtuales que los gráficos usarán más tarde al presentar los datos.

Los valores de los selectores de recursos pueden provenir del contexto del libro, de la lista estática o de las consultas de Azure Resource Graph.

Nota:

La etiqueta de cada recurso de la lista de parámetros de recursos se basa en el identificador de recurso. No puede reemplazar ese nombre por otro valor. Para mayor claridad, los ejemplos de este documento muestran el campo de etiqueta establecido en el identificador, pero ese valor no se usa en el parámetro real.

Creación de un parámetro de recurso (recursos de libro)

1. Comience con un libro vacío en modo de edición.

2. Seleccione Agregar parámetros>Agregar parámetro.

3. En el panel de nuevo parámetro que se abre, escriba:

   1. Nombre del parámetro: Applications
   2. Tipo de parámetro: Resource picker
   3. Obligatorio: checked
   4. Permitir selecciones múltiples: checked
   5. Obtener datos de: Workbook Resources
   6. Incluir solo los tipos de recursos: Application Insights

4. Seleccione Guardar para crear el parámetro.

   

Creación de un parámetro de recurso de Azure Resource Graph

1. Comience con un libro vacío en modo de edición.

2. Seleccione Agregar parámetros>Agregar parámetro.

3. En el panel de nuevo parámetro que se abre, escriba:

   1. Nombre del parámetro: Applications
   2. Tipo de parámetro: Resource picker
   3. Obligatorio: checked
   4. Permitir selecciones múltiples: checked
   5. Obtener datos de: Query
   6. Tipo de consulta: Azure Resource Graph
   7. Suscripciones: Use default subscriptions
   8. En el control de consulta, agregue este fragmento de código:

   where type == 'microsoft.insights/components'
   | project value = id, label = id, selected = false, group = resourceGroup
   

4. Seleccione Guardar para crear el parámetro.

   

Para obtener más información sobre Azure Resource Graph, consulte ¿Qué es Azure Resource Graph?.

Creación de un parámetro de recurso de lista JSON

1. Comience con un libro vacío en modo de edición.
2. Seleccione Agregar parámetros>Agregar parámetro.
3. En el panel de nuevo parámetro que se abre, escriba:

   1. Nombre del parámetro: Applications

   2. Tipo de parámetro: Resource picker

   3. Obligatorio: checked

   4. Permitir selecciones múltiples: checked

   5. Obtener datos de: JSON

   6. En el control de contenido, agregue este fragmento de código JSON:

      [
          { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication", "selected":true, "group":"Acme Backend" },
          { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeweb", "selected":false, "group":"Acme Frontend" }
      ]
      

   7. Seleccione Actualizar.

4. Opcionalmente, establezca Include only resource types en Application Insights.
5. Seleccione Guardar para crear el parámetro.

Referencia a un parámetro de recurso

1. Seleccione Agregar consulta para agregar un control de consulta y, a continuación, seleccione un recurso de Application Insights.

2. Use la lista desplegable Application Insights para enlazar el parámetro al control. Este paso establece el ámbito de la consulta en los recursos devueltos por el parámetro en tiempo de ejecución.

3. En el control KQL, agregue este fragmento de código:

   requests
   | summarize Requests = count() by appName, name
   | order by Requests desc
   

4. Ejecute la consulta para ver los resultados.

   

Este enfoque se puede usar para enlazar recursos a otros controles, como las métricas.

Opciones de parámetros de recursos

Parámetro	Descripción	Ejemplo
{Applications}	Identificador del recurso seleccionado.	/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication
{Applications:label}	Etiqueta del recurso seleccionado.	acmefrontend Nota: para los parámetros de recursos de varios valores, esta etiqueta se puede acortar como acmefrontend (+3 others) y puede no incluir todas las etiquetas de todos los valores seleccionados
{Applications:value}	Valor del recurso seleccionado.	'/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication'
{Applications:name}	Nombre del recurso seleccionado.	acmefrontend
{Applications:resourceGroup}	Grupo de recursos del recurso seleccionado.	acmegroup
{Applications:resourceType}	Tipo del recurso seleccionado.	microsoft.insights/components
{Applications:subscription}	Suscripción del recurso seleccionado.
{Applications:grid}	Cuadrícula que muestra las propiedades del recurso. Es útil para representar en un bloque de texto durante la depuración.

Pasos siguientes

Introducción a Libros de Azure