Snabbstart: Dirigera Azure Cache for Redis händelser till webbslutpunkten med Azure PortalQuickstart: Route Azure Cache for Redis events to web endpoint with the Azure portal

Azure Event Grid är en händelsetjänst för molnet.Azure Event Grid is an eventing service for the cloud. I den här snabbstarten använder du Azure Portal för att skapa en Azure Cache for Redis-instans, prenumerera på händelser för den instansen, utlösa en händelse och visa resultatet.In this quickstart, you'll use the Azure portal to create an Azure Cache for Redis instance, subscribe to events for that instance, trigger an event, and view the results. Normalt kan du skicka händelser till en slutpunkt som bearbetar informationen om händelsen och utför åtgärder.Typically, you send events to an endpoint that processes the event data and takes actions. Men för att förenkla den här snabbstarten skickar du händelser till en webbapp som samlar in och visar meddelandena.However, to simplify this quickstart, you'll send events to a web app that will collect and display the messages.

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

När du är klar ser du att händelsedata har skickats till webbappen.When you're finished, you'll see that the event data has been sent to the web app.

Azure Event Grid Viewer-skalning i JSON-format.

Skapa en Azure Cache for Redis cacheinstansCreate an Azure Cache for Redis cache instance

  1. Om du vill skapa en cache loggar du in på Azure Portal och väljer skapa en resurs.To create a cache, sign in to the Azure portal and select Create a resource.

    Skapa en resurs markeras i det vänstra navigerings fönstret.

  2. Välj databaser på sidan nytt och välj sedan Azure cache för Redis.On the New page, select Databases and then select Azure Cache for Redis.

    På nytt markeras databaser och Azure cache för Redis är markerat.

  3. På sidan ny Redis cache konfigurerar du inställningarna för din nya cache.On the New Redis Cache page, configure the settings for your new cache.

    InställningSetting Föreslaget värdeSuggested value BeskrivningDescription
    DNS-namnDNS name Ange ett globalt unikt namn.Enter a globally unique name. Cache-namnet måste vara en sträng mellan 1 och 63 tecken som bara innehåller siffror, bokstäver eller bindestreck.The cache name must be a string between 1 and 63 characters that contains only numbers, letters, or hyphens. Namnet måste börja och sluta med en siffra eller en bokstav och får inte innehålla flera bindestreck i rad.The name must start and end with a number or letter, and can't contain consecutive hyphens. Din cacheposts värdnamn är <DNS name> . Redis.cache.Windows.net.Your cache instance's host name will be <DNS name>.redis.cache.windows.net.
    PrenumerationSubscription List rutan och välj din prenumeration.Drop down and select your subscription. Den prenumeration som du vill skapa den här nya Azure-cache för Redis-instansen för.The subscription under which to create this new Azure Cache for Redis instance.
    ResursgruppResource group List rutan och välj en resurs grupp, eller Välj Skapa ny och ange ett nytt resurs grupp namn.Drop down and select a resource group, or select Create new and enter a new resource group name. Namnet på resurs gruppen där du vill skapa cachen och andra resurser.Name for the resource group in which to create your cache and other resources. Genom att lägga till alla dina app-resurser i en resurs grupp kan du enkelt hantera eller ta bort dem tillsammans.By putting all your app resources in one resource group, you can easily manage or delete them together.
    PlatsLocation List rutan och välj en plats.Drop down and select a location. Välj en region nära andra tjänster som ska använda din cache.Select a region near other services that will use your cache.
    PrisnivåPricing tier List rutan och välj en pris nivå.Drop down and select a Pricing tier. Prisnivån avgör storlek, prestanda och funktioner som är tillgängliga för cacheminnet.The pricing tier determines the size, performance, and features that are available for the cache. Mer information finns i Översikt över Azure Cache for Redis.For more information, see Azure Cache for Redis Overview.
  4. Välj fliken nätverk eller klicka på knappen nätverk längst ned på sidan.Select the Networking tab or click the Networking button at the bottom of the page.

  5. På fliken nätverk väljer du anslutnings metod.In the Networking tab, select your connectivity method.

  6. Välj Nästa: fliken Avancerat eller klicka på Nästa: Avancerat längst ned på sidan.Select the Next: Advanced tab or click the Next: Advanced button on the bottom of the page.

  7. På fliken Avancerat för en Basic-eller standard-cachepost väljer du aktivera växling om du vill aktivera en icke-TLS-port.In the Advanced tab for a basic or standard cache instance, select the enable toggle if you want to enable a non-TLS port. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller (för hands version) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

    Redis-version 4 eller 6.

  8. På fliken Avancerat för Premium-cache-instans konfigurerar du inställningarna för icke-TLS-port, klustring och data beständighet.In the Advanced tab for premium cache instance, configure the settings for non-TLS port, clustering, and data persistence. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller (för hands version) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

  9. Välj fliken Nästa: Taggar eller klicka på knappen Nästa: Taggar längst ned på sidan.Select the Next: Tags tab or click the Next: Tags button at the bottom of the page.

  10. Alternativt går du till fliken taggar och anger namn och värde om du vill kategorisera resursen.Optionally, in the Tags tab, enter the name and value if you wish to categorize the resource.

  11. Välj Granska + skapa.Select Review + create. Du kommer till fliken Granska + skapa där Azure verifierar konfigurationen.You're taken to the Review + create tab where Azure validates your configuration.

  12. När meddelandet grön verifiering har skickats visas väljer du skapa.After the green Validation passed message appears, select Create.

Det tar en stund innan cacheminnet skulle skapas.It takes a while for the cache to create. Du kan övervaka förloppet på översikts sidan för Azure-cache för Redis.You can monitor progress on the Azure Cache for Redis Overview page. När statusen är igång är cacheminnet redo att användas.When Status shows as Running, the cache is ready to use.

Skapa en slutpunkt för meddelandenCreate a message endpoint

Innan du prenumererar på händelser för cacheinstansen ska vi skapa slutpunkten för händelsemeddelandet.Before subscribing to the events for the cache instance, let's create the endpoint for the event message. Slutpunkten utför vanligtvis åtgärder baserat på informationen om händelsen.Typically, the endpoint takes actions based on the event data. För att förenkla den här snabbstarten distribuerar du en förbyggd webbapp som visar händelsemeddelandena.To simplify this quickstart, you'll deploy a pre-built web app that displays the event messages. Den distribuerade lösningen innehåller en App Service-plan,en webbapp för App Service och källkod från GitHub.The deployed solution includes an App Service plan, an App Service web app, and source code from GitHub.

  1. Välj Distribuera till Azure i GitHub README för att distribuera lösningen till din prenumeration.Select Deploy to Azure in GitHub README to deploy the solution to your subscription.

Knappen Distribuera till Azure.

  1. Gör följande sidan Anpassad distribution:On the Custom deployment page, do the following steps:

    1. För Resursgrupp väljer du den resursgrupp som du skapade när du skapade cacheinstansen.For Resource group, select the resource group that you created when creating the cache instance. Det blir enklare för dig att rensa när du är klar med självstudien genom att ta bort resursgruppen.It will be easier for you to clean up after you are done with the tutorial by deleting the resource group.
    2. För Webbplatsnamn anger du ett namn för webbappen.For Site Name, enter a name for the web app.
    3. I Värdplansnamn anger du ett namn på App Service plan som ska användas som värd för webbappen.For Hosting plan name, enter a name for the App Service plan to use for hosting the web app.
    4. Markera kryssrutan för Jag godkänner de villkor som anges ovan.Select the check box for I agree to the terms and conditions stated above.
    5. Välj Köp.Select Purchase.
    InställningSetting Föreslaget värdeSuggested value BeskrivningDescription
    PrenumerationSubscription Välj din prenumeration i listrutan.Drop down and select your subscription. Den prenumeration som webbappen ska skapas under.The subscription under which to create this web app.
    ResursgruppResource group Välj en resursgrupp i listrutan eller välj Skapa ny och ange ett nytt resursgruppnamn.Drop down and select a resource group, or select Create new and enter a new resource group name. Genom att placera alla dina appresurser i en resursgrupp kan du enkelt hantera eller ta bort dem tillsammans.By putting all your app resources in one resource group, you can easily manage or delete them together.
    WebbplatsnamnSite Name Ange ett namn för webbappen.Enter a name for your web app. Det här värdet får inte vara tomt.This value cannot be empty.
    Namn på värdplanHosting plan name Ange ett namn för App Service plan som ska användas som värd för webbappen.Enter a name for the App Service plan to use for hosting the web app. Det här värdet får inte vara tomt.This value cannot be empty.
  2. Välj Aviseringar (klockikon) i portalen och välj sedan Gå till resursgrupp.Select Alerts (bell icon) in the portal, and then select Go to resource group.

    Azure Portal distributionsmeddelande.

  3. På sidan Resursgrupp i listan över resurser väljer du den webbapp som du skapade.On the Resource group page, in the list of resources, select the web app that you created. Du ser även App Service plan cacheinstansen i den här listan.You'll also see the App Service plan and the cache instance in this list.

  4. App Service för webbappen väljer du URL:en för att navigera till webbplatsen.On the App Service page for your web app, select the URL to navigate to the web site. URL:en ska ha det här formatet: https://<your-site-name>.azurewebsites.net .The URL should be in this format: https://<your-site-name>.azurewebsites.net.

  5. Bekräfta att du ser webbplatsen men att inga händelser har publicerats till den ännu.Confirm that you see the site but no events have been posted to it yet.

    Tom Event Grid Viewer-webbplats.

Aktivera Event Grid-resursproviderEnable Event Grid resource provider

Om du inte har använt Event Grid förut i din Azure-prenumeration kan du behöva registrera Event Grid-resursprovidern.If you haven't previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider.

I Azure-portalen:In the Azure portal:

  1. Välj prenumerationer på den vänstra menyn.Select Subscriptions on the left menu.
  2. Välj den prenumeration som du använder för Event Grid.Select the subscription you're using for Event Grid.
  3. Välj resurs leverantörer på den vänstra menyn under Inställningar.On the left menu, under Settings, select Resource providers.
  4. Hitta Microsoft.EventGrid.Find Microsoft.EventGrid.
  5. Om du inte är registrerad väljer du Registrera.If not registered, select Register.

Det kan ta en stund att slutföra registreringen.It may take a moment for the registration to finish. Välj Uppdatera för att uppdatera statusen.Select Refresh to update the status. När Status är Registrerad är du redo att fortsätta.When Status is Registered, you're ready to continue.

Prenumerera på Azure Cache for Redis instansenSubscribe to the Azure Cache for Redis instance

I det här steget prenumererar du på ett ämne för att Event Grid vilka händelser du vill spåra och vart du vill skicka händelserna.In this step, you'll subscribe to a topic to tell Event Grid which events you want to track, and where to send the events.

  1. I portalen navigerar du till den cacheinstans som du skapade tidigare.In the portal, navigate to your cache instance that you created earlier.

  2. Azure Cache for Redis väljer du Händelser på den vänstra menyn.On the Azure Cache for Redis page, select Events on the left menu.

  3. Välj Web Hook.Select Web Hook. Du skickar händelser till din tittarapp med hjälp av en web hook för slutpunkten.You are sending events to your viewer app using a web hook for the endpoint.

    Azure Portal sidan Händelser.

  4. På sidan Skapa händelseprenumeration anger du följande:On the Create Event Subscription page, enter the following:

    InställningSetting Föreslaget värdeSuggested value BeskrivningDescription
    NamnName Ange ett namn för händelseprenumerationen.Enter a name for the event subscription. Värdet måste vara mellan 3 och 64 tecken långt.The value must be between 3 and 64 characters long. Den får bara innehålla bokstäver, siffror och bindestreck.It can only contain letters, numbers, and dashes.
    HändelsetyperEvent Types I listrutan väljer du vilken eller vilka händelsetyper du vill ska skickas till målet.Drop down and select which event type(s) you want to get pushed to your destination. I den här snabbstarten skalar vi cacheinstansen.For this quickstart, we'll be scaling our cache instance. Korrigering, skalning, import och export är tillgängliga alternativ.Patching, scaling, import and export are the available options.
    Typ av slutpunktEndpoint Type Välj Web Hook.Select Web Hook. Händelsehanterare för att ta emot dina händelser.Event handler to receive your events.
    SlutpunktEndpoint Klicka på Välj en slutpunkt, ange url:en för webbappen och lägg till den i url:en för startsidan api/updates (till exempel: ) och välj sedan Bekräfta https://cache.azurewebsites.net/api/updates markering.Click Select an endpoint, and enter the URL of your web app and add api/updates to the home page URL (for example: https://cache.azurewebsites.net/api/updates), and then select Confirm Selection. Det här är URL:en för din webbapp som du skapade tidigare.This is the URL of your web app that you created earlier.
  5. På sidan Skapa händelseprenumeration väljer du Skapa för att skapa händelseprenumerationen.Now, on the Create Event Subscription page, select Create to create the event subscription.

  6. Visa ditt webbprogram igen och observera att en händelse för verifieringen av prenumerationen har skickats till den.View your web app again, and notice that a subscription validation event has been sent to it. Välj ögonikonen för att utöka informationen om händelsen.Select the eye icon to expand the event data. Händelserutnätet skickar valideringshändelsen så att slutpunkten kan bekräfta att den vill ta emot händelsedata.Event Grid sends the validation event so the endpoint can verify that it wants to receive event data. Webbappen inkluderar kod för att verifiera prenumerationen.The web app includes code to validate the subscription.

    Azure Event Grid Viewer.

Skicka en händelse till din slutpunktSend an event to your endpoint

Nu ska vi utlösa en händelse och se hur Event Grid distribuerar meddelandet till slutpunkten.Now, let's trigger an event to see how Event Grid distributes the message to your endpoint. Vi skalar din Azure Cache for Redis instans.We'll be scaling your Azure Cache for Redis instance.

  1. I Azure Portal navigerar du till din Azure Cache for Redis-instans och väljer Skala på den vänstra menyn.In the Azure portal, navigate to your Azure Cache for Redis instance and select Scale on the left menu.

  2. Välj önskad prisnivå på sidan Skala och klicka på Välj.Select the desired pricing tier from the Scale page and click Select.

    Du kan skala till en annan prisnivå med följande begränsningar:You can scale to a different pricing tier with the following restrictions:

    • Du kan inte skala från en högre prisnivå till en lägre prisnivå.You can't scale from a higher pricing tier to a lower pricing tier.
      • Du kan inte skala från en Premium-cache till en Standard- eller Basic-cache.You can't scale from a Premium cache down to a Standard or a Basic cache.
      • Du kan inte skala från en Standard-cache till en Basic-cache.You can't scale from a Standard cache down to a Basic cache.
    • Du kan skala från en Basic-cache till en standardcache, men du kan inte ändra storlek på samma gång.You can scale from a Basic cache to a Standard cache but you can't change the size at the same time. Om du behöver en annan storlek kan du göra en efterföljande skalningsåtgärd till önskad storlek.If you need a different size, you can do a subsequent scaling operation to the desired size.
    • Du kan inte skala från en Basic-cache direkt till en Premium-cache.You can't scale from a Basic cache directly to a Premium cache. Börja med att skala från Basic till Standard i en skalningsåtgärd och sedan från Standard till Premium i en efterföljande skalningsåtgärd.First, scale from Basic to Standard in one scaling operation, and then from Standard to Premium in a subsequent scaling operation.
    • Du kan inte skala från en större storlek ned till storleken C0 (250 MB).You can't scale from a larger size down to the C0 (250 MB) size.

    När cacheminnet skalar till den nya prisnivån visas skalningsstatusenbladet Azure Cache for Redis.While the cache is scaling to the new pricing tier, a Scaling status is displayed in the Azure Cache for Redis blade. När skalningen är klar ändras statusen från Skalning till Körs.When scaling is complete, the status changes from Scaling to Running.

  3. Du har utlöst händelsen och Event Grid skickade meddelandet till den slutpunkt som du konfigurerade när du prenumererade.You've triggered the event, and Event Grid sent the message to the endpoint you configured when subscribing. Meddelandet är i JSON-format och innehåller en matris med en eller flera händelser.The message is in the JSON format and it contains an array with one or more events. I följande exempel innehåller JSON-meddelandet en matris med en händelse.In the following example, the JSON message contains an array with one event. Visa webbappen och observera att en ScalingCompleted-händelse togs emot.View your web app and notice that a ScalingCompleted event was received.

    Azure Event Grid Viewer-skalning i JSON-format.

Rensa resurserClean up resources

Om du planerar att fortsätta arbeta med den här händelsen ska du inte rensa resurserna som skapades i den här snabbstarten.If you plan to continue working with this event, don't clean up the resources created in this quickstart. Annars tar du bort de resurser som du skapade i den här snabbstarten.Otherwise, delete the resources you created in this quickstart.

Välj resursgruppen och sedan Ta bort resursgrupp.Select the resource group, and select Delete resource group.

Nästa stegNext steps

Nu när du vet hur du skapar anpassade ämnen och prenumerationer på händelser kan du läsa mer om vad Event Grid kan hjälpa dig med:Now that you know how to create custom topics and event subscriptions, learn more about what Event Grid can help you do: