Resourceparameters van werkmap

Met resourceparameters kunt u resources in werkmappen kiezen. Deze functionaliteit is handig bij het instellen van het bereik waaruit de gegevens moeten worden opgehaald. In een voorbeeld kunt u de set virtuele machines selecteren, die grafieken later gebruiken bij het presenteren van de gegevens.

Waarden van resourcekiezers kunnen afkomstig zijn van de werkmapcontext, statische lijst of Azure Resource Graph-query's.

Notitie

Het label voor elke resource in de lijst met resourceparameters is gebaseerd op de resource-id. U kunt die naam niet vervangen door een andere waarde. Voor de duidelijkheid tonen de voorbeelden in dit document het labelveld dat is ingesteld op de id, maar die waarde wordt niet gebruikt in de werkelijke parameter.

Een resourceparameter maken (werkmapresources)

1. Begin met een lege werkmap in de bewerkingsmodus.

2. Selecteer Parameters toevoegen parameter toevoegen>.

3. Voer in het nieuwe parametervenster dat wordt geopend het volgende in:

   1. Parameternaam: Applications
   2. Parametertype: Resource picker
   3. Vereist: checked
   4. Meerdere selecties toestaan: checked
   5. Gegevens ophalen uit: Workbook Resources
   6. Alleen resourcetypen opnemen: Application Insights

4. Selecteer Opslaan om de parameter te maken.

   

Een Azure Resource Graph-resourceparameter maken

1. Begin met een lege werkmap in de bewerkingsmodus.

2. Selecteer Parameters toevoegen parameter toevoegen>.

3. Voer in het nieuwe parametervenster dat wordt geopend het volgende in:

   1. Parameternaam: Applications
   2. Parametertype: Resource picker
   3. Vereist: checked
   4. Meerdere selecties toestaan: checked
   5. Gegevens ophalen uit: Query
   6. Querytype: Azure Resource Graph
   7. Abonnementen: Use default subscriptions
   8. Voeg in het querybeheer dit fragment toe:

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

4. Selecteer Opslaan om de parameter te maken.

   

Zie Wat is Azure Resource Graph? voor meer informatie over Azure Resource Graph.

Een resourceparameter voor een JSON-lijst maken

1. Begin met een lege werkmap in de bewerkingsmodus.
2. Selecteer Parameters toevoegen parameter toevoegen>.
3. Voer in het nieuwe parametervenster dat wordt geopend het volgende in:

   1. Parameternaam: Applications

   2. Parametertype: Resource picker

   3. Vereist: checked

   4. Meerdere selecties toestaan: checked

   5. Gegevens ophalen uit: JSON

   6. Voeg in het inhoudsbeheer dit JSON-fragment toe:

      [
          { "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. Selecteer Bijwerken.

4. U kunt eventueel instellen Include only resource types op Application Insights.
5. Selecteer Opslaan om de parameter te maken.

Verwijzen naar een resourceparameter

1. Selecteer Query toevoegen om een querybeheer toe te voegen en selecteer vervolgens een Application Insights-resource.

2. Gebruik de vervolgkeuzelijst Application Insights om de parameter aan het besturingselement te binden. Met deze stap stelt u het bereik van de query in op de resources die tijdens runtime door de parameter worden geretourneerd.

3. Voeg in het KQL-besturingselement dit fragment toe:

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

4. Voer de query uit om de resultaten te bekijken.

   

Deze benadering kan worden gebruikt om resources te binden aan andere besturingselementen, zoals metrische gegevens.

Opties voor resourceparameters

Parameter	Description	Voorbeeld
{Applications}	De geselecteerde resource-id.	/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication
{Applications:label}	Het label van de geselecteerde resource.	acmefrontend Opmerking: voor resourceparameters met meerdere waarden kan dit label worden ingekort en acmefrontend (+3 others) mag dit niet alle labels van alle geselecteerde waarden bevatten
{Applications:value}	De waarde van de geselecteerde resource.	'/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication'
{Applications:name}	De naam van de geselecteerde resource.	acmefrontend
{Applications:resourceGroup}	De resourcegroep van de geselecteerde resource.	acmegroup
{Applications:resourceType}	Het type van de geselecteerde resource.	microsoft.insights/components
{Applications:subscription}	Het abonnement van de geselecteerde resource.
{Applications:grid}	Een raster met de resource-eigenschappen. Handig om tijdens foutopsporing in een tekstblok weer te geven.

Volgende stappen

Aan de slag met Azure Workbooks