Quickstart: Gebeurtenissen Azure Cache voor Redis naar het web-eindpunt met de Azure PortalQuickstart: Route Azure Cache for Redis events to web endpoint with the Azure portal

Azure Event Grid is een gebeurtenisservice voor de cloud.Azure Event Grid is an eventing service for the cloud. In deze quickstart gebruikt u de Azure Portal om een Azure Cache voor Redis-exemplaar te maken, u te abonneren op gebeurtenissen voor dat exemplaar, een gebeurtenis te activeren en de resultaten weer te geven.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. Normaal gesproken verzendt u gebeurtenissen naar een eindpunt dat de gebeurtenisgegevens verwerkt en vervolgens in actie komt.Typically, you send events to an endpoint that processes the event data and takes actions. Ter vereenvoudiging van deze quickstart verzendt u echter gebeurtenissen naar een web-app waarmee de berichten worden verzameld en weergegeven.However, to simplify this quickstart, you'll send events to a web app that will collect and display the messages.

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.If you don't have an Azure subscription, create a free account before you begin.

Wanneer u klaar bent, ziet u dat de gebeurtenisgegevens naar de web-app zijn verzonden.When you're finished, you'll see that the event data has been sent to the web app.

Azure Event Grid Viewer schalen in JSON-indeling.

Een cache-Azure Cache voor Redis makenCreate an Azure Cache for Redis cache instance

  1. Als u een cache wilt maken, meldt u zich aan bij de Azure-portal en selecteert u Een resource maken.To create a cache, sign in to the Azure portal and select Create a resource.

    Een resource maken is gemarkeerd in het linkernavigatiedeelvenster.

  2. Selecteer op de pagina Nieuw de optie Databases en selecteer vervolgens Azure Cache voor Redis.On the New page, select Databases and then select Azure Cache for Redis.

    In Nieuw is Databases gemarkeerd. Azure Cache voor Redis is ook gemarkeerd.

  3. Configureer op de pagina Nieuwe Redis-cache de instellingen voor de nieuwe cache.On the New Redis Cache page, configure the settings for your new cache.

    InstellingSetting Voorgestelde waardeSuggested value BeschrijvingDescription
    DNS-naamDNS name Geef een wereldwijd unieke naam op.Enter a globally unique name. De cachenaam is een tekenreeks van 1 tot 63 tekens die alleen cijfers, letters en afbreekstreepjes mag bevatten.The cache name must be a string between 1 and 63 characters that contains only numbers, letters, or hyphens. De naam moet beginnen en eindigen met een cijfer of letter en mag geen opeenvolgende afbreekstreepjes bevatten.The name must start and end with a number or letter, and can't contain consecutive hyphens. De hostnaam van uw cache-exemplaar wordt <DNS name>.redis.cache.windows.net.Your cache instance's host name will be <DNS name>.redis.cache.windows.net.
    AbonnementSubscription Open de vervolgkeuzelijst en selecteer uw abonnement.Drop down and select your subscription. Het abonnement waarmee dit nieuwe Azure Cache voor Redis-exemplaar wordt gemaakt.The subscription under which to create this new Azure Cache for Redis instance.
    ResourcegroepResource group Open de vervolgkeuzelijst en selecteer een resourcegroep of kies Nieuwe maken en geef een naam voor de nieuwe resourcegroep op.Drop down and select a resource group, or select Create new and enter a new resource group name. Naam voor de resourcegroep waarin de cache en andere resources moeten worden gemaakt.Name for the resource group in which to create your cache and other resources. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.By putting all your app resources in one resource group, you can easily manage or delete them together.
    LocatieLocation Open de vervolgkeuzelijst en selecteer een locatie.Drop down and select a location. Selecteer een regio in de buurt van andere services die gaan gebruikmaken van de cache.Select a region near other services that will use your cache.
    PrijscategoriePricing tier Open de vervolgkeuzelijst en selecteer een Prijscategorie.Drop down and select a Pricing tier. De prijscategorie bepaalt de grootte, prestaties en functies die beschikbaar zijn voor de cache.The pricing tier determines the size, performance, and features that are available for the cache. Zie het Azure Cache voor Redis-overzicht voor meer informatie.For more information, see Azure Cache for Redis Overview.
  4. Selecteer het tabblad Netwerken of klik op de knop Netwerken onderaan de pagina.Select the Networking tab or click the Networking button at the bottom of the page.

  5. Selecteer uw verbindingsmethode op het tabblad Netwerk.In the Networking tab, select your connectivity method.

  6. Selecteer het tabblad Volgende: Geavanceerd of klik op de knop Volgende: Geavanceerd onderaan de pagina.Select the Next: Advanced tab or click the Next: Advanced button on the bottom of the page.

  7. Selecteer in het tabblad Geavanceerd voor een basic of standard cache-exemplaar de schakeloptie inschakelen als u een niet-TLS-poort wilt inschakelen.In the Advanced tab for a basic or standard cache instance, select the enable toggle if you want to enable a non-TLS port. U kunt ook selecteren welke Redis-versie u wilt gebruiken: 4 of 6 (preview).You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

    Redis-versie 4 of 6.

  8. Configureer in het tabblad Geavanceerd voor premium cache-exemplaar de instellingen voor een niet-TLS-poort, clustering en gegevenspersistentie.In the Advanced tab for premium cache instance, configure the settings for non-TLS port, clustering, and data persistence. U kunt ook selecteren welke Redis-versie u wilt gebruiken: 4 of 6 (preview).You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

  9. Selecteer het tabblad Volgende: Tags of klik op de knop Volgende: Tags onderaan de pagina.Select the Next: Tags tab or click the Next: Tags button at the bottom of the page.

  10. Voer desgewenst in het tabblad Tags de naam en waarde in om de resource te categoriseren.Optionally, in the Tags tab, enter the name and value if you wish to categorize the resource.

  11. Selecteer Controleren + maken.Select Review + create. Het tabblad Beoordelen + maken wordt weergegeven, waar uw configuratie wordt gevalideerd in Azure.You're taken to the Review + create tab where Azure validates your configuration.

  12. Selecteer Maken nadat het groene bericht Validatie geslaagd verschijnt.After the green Validation passed message appears, select Create.

Het duurt even voor de cache is gemaakt.It takes a while for the cache to create. U kunt de voortgang bekijken op de overzichtspagina van Azure Cache voor Redis.You can monitor progress on the Azure Cache for Redis Overview page. Als u bij Status Wordt uitgevoerd ziet staan, kunt u de cache gebruiken.When Status shows as Running, the cache is ready to use.

Het eindpunt van een bericht makenCreate a message endpoint

Voordat u zich abonneert op de gebeurtenissen voor het cache-exemplaar, maken we het eindpunt voor het gebeurtenisbericht.Before subscribing to the events for the cache instance, let's create the endpoint for the event message. Het eindpunt onderneemt normaal gesproken actie op basis van de gebeurtenisgegevens.Typically, the endpoint takes actions based on the event data. Ter vereenvoudiging van deze quickstart implementeert u een vooraf gebouwde web-app waarmee de gebeurtenisberichten worden weergegeven.To simplify this quickstart, you'll deploy a pre-built web app that displays the event messages. De geïmplementeerde oplossing omvat een App Service-plan, een App Service-web-app en broncode van GitHub.The deployed solution includes an App Service plan, an App Service web app, and source code from GitHub.

  1. Selecteer Implementeren in Azure in GitHub README om de oplossing in uw abonnement te implementeren.Select Deploy to Azure in GitHub README to deploy the solution to your subscription.

Knop Implementeren in Azure.

  1. Voer op de pagina Aangepaste implementatie de volgende stappen uit:On the Custom deployment page, do the following steps:

    1. Selecteer bij Resourcegroep de resourcegroep die u hebt gemaakt bij het maken van het cache-exemplaar.For Resource group, select the resource group that you created when creating the cache instance. Het is voor u eenvoudiger om op te schonen door de resourcegroep te verwijderen wanneer u klaar bent met de zelfstudie.It will be easier for you to clean up after you are done with the tutorial by deleting the resource group.
    2. Voer in het vak Sitenaam een naam in voor de web-app.For Site Name, enter a name for the web app.
    3. Voer voor Naam van hostingplan een naam in voor het App Service-plan dat u wilt gebruiken voor het hosten van de web-app.For Hosting plan name, enter a name for the App Service plan to use for hosting the web app.
    4. Schakel het selectievakje in voor Ik ga akkoord met de bovenstaande voorwaarden.Select the check box for I agree to the terms and conditions stated above.
    5. Selecteer Aankoop.Select Purchase.
    InstellingSetting Voorgestelde waardeSuggested value BeschrijvingDescription
    AbonnementSubscription Open de vervolgkeuzelijst en selecteer uw abonnement.Drop down and select your subscription. Het abonnement waarmee u deze web-app maakt.The subscription under which to create this web app.
    ResourcegroepResource group Open de vervolgkeuzelijst en selecteer een resourcegroep of kies Nieuwe maken en geef een naam voor de nieuwe resourcegroep op.Drop down and select a resource group, or select Create new and enter a new resource group name. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.By putting all your app resources in one resource group, you can easily manage or delete them together.
    SitenaamSite Name Voer een naam in voor uw web-app.Enter a name for your web app. Deze waarde mag niet leeg zijn.This value cannot be empty.
    Naam hostingplanHosting plan name Voer een naam in voor de App Service wilt gebruiken voor het hosten van de web-app.Enter a name for the App Service plan to use for hosting the web app. Deze waarde mag niet leeg zijn.This value cannot be empty.
  2. Selecteer Waarschuwingen (belpictogram) in de portal en selecteer vervolgens Naar de resourcegroep gaan.Select Alerts (bell icon) in the portal, and then select Go to resource group.

    Azure Portal implementatiemelding.

  3. Selecteer in de lijst met resources op de pagina Resourcegroep de web-app die u hebt gemaakt.On the Resource group page, in the list of resources, select the web app that you created. U ziet ook het App Service en het cache-exemplaar in deze lijst.You'll also see the App Service plan and the cache instance in this list.

  4. Selecteer op de pagina App Service voor uw web-app de URL om naar de website te gaan.On the App Service page for your web app, select the URL to navigate to the web site. De URL moet de volgende indeling hebben: https://<your-site-name>.azurewebsites.net.The URL should be in this format: https://<your-site-name>.azurewebsites.net.

  5. Controleer of de site wordt weergegeven en dat er zijn nog geen gebeurtenissen naar zijn gepost.Confirm that you see the site but no events have been posted to it yet.

    Lege Event Grid Viewer-site.

Event Grid-resourceprovicer inschakelenEnable Event Grid resource provider

Als u Event Grid in uw Azure-abonnement nog niet eerder hebt gebruikt, moet u mogelijk de Event Grid-resourceprovider registreren.If you haven't previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider.

In Azure Portal:In the Azure portal:

  1. Selecteer Abonnementen in het menu links.Select Subscriptions on the left menu.
  2. Selecteer het abonnement dat u voor Event Grid gebruikt.Select the subscription you're using for Event Grid.
  3. Selecteer onder Instellingen in het menu links de optie Resourceproviders.On the left menu, under Settings, select Resource providers.
  4. Zoek Microsoft.EventGrid.Find Microsoft.EventGrid.
  5. Als deze niet is geregistreerd, selecteert u Registreren.If not registered, select Register.

Het kan even duren voordat de registratie is voltooid.It may take a moment for the registration to finish. Selecteer Vernieuwen om de status bij te werken.Select Refresh to update the status. Wanneer de Status****Geregistreerde is, bent u klaar om verder te gaan.When Status is Registered, you're ready to continue.

Abonneren op het Azure Cache voor Redis exemplaarSubscribe to the Azure Cache for Redis instance

In deze stap abonneert u zich op een onderwerp om u Event Grid welke gebeurtenissen u wilt bijhouden en waar u de gebeurtenissen wilt verzenden.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. Navigeer in de portal naar het cache-exemplaar dat u eerder hebt gemaakt.In the portal, navigate to your cache instance that you created earlier.

  2. Selecteer op Azure Cache voor Redis pagina Gebeurtenissen in het menu links.On the Azure Cache for Redis page, select Events on the left menu.

  3. Selecteer Web hook.Select Web Hook. U verzendt gebeurtenissen naar uw viewer-app met behulp van een webhook voor het eindpunt.You are sending events to your viewer app using a web hook for the endpoint.

    Azure Portal pagina Gebeurtenissen.

  4. Voer op de pagina Gebeurtenisabonnement maken het volgende in:On the Create Event Subscription page, enter the following:

    InstellingSetting Voorgestelde waardeSuggested value BeschrijvingDescription
    NaamName Voer een naam in voor het gebeurtenisabonnement.Enter a name for the event subscription. De waarde moet tussen de 3 en 64 tekens lang zijn.The value must be between 3 and 64 characters long. Deze mag alleen letters, cijfers en streepjes bevatten.It can only contain letters, numbers, and dashes.
    GebeurtenistypenEvent Types Selecteer in de vervolgkeuze selecteren welk gebeurtenistype(en) u naar uw bestemming wilt pushen.Drop down and select which event type(s) you want to get pushed to your destination. Voor deze quickstart schalen we onze cache-instantie.For this quickstart, we'll be scaling our cache instance. Patchen, schalen, importeren en exporteren zijn de beschikbare opties.Patching, scaling, import and export are the available options.
    EindpunttypeEndpoint Type Selecteer Web hook.Select Web Hook. Gebeurtenis-handler om uw gebeurtenissen te ontvangen.Event handler to receive your events.
    EindpuntEndpoint Klik op Een eindpunt selecteren, voer de URL van uw web-app in en voeg toe aan de URL van de startpagina (bijvoorbeeld: ) en selecteer api/updates vervolgens Selectie https://cache.azurewebsites.net/api/updates bevestigen.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. Dit is de URL van uw web-app die u eerder hebt gemaakt.This is the URL of your web app that you created earlier.
  5. Selecteer nu op de pagina Gebeurtenisabonnement maken de optie Maken om het gebeurtenisabonnement te maken.Now, on the Create Event Subscription page, select Create to create the event subscription.

  6. Bekijk opnieuw uw web-app en u zult zien dat er een validatiegebeurtenis voor een abonnement naartoe is verzonden.View your web app again, and notice that a subscription validation event has been sent to it. Selecteer het oogpictogram om de gebeurtenisgegevens uit te breiden.Select the eye icon to expand the event data. Via Event Grid wordt de validatiegebeurtenis verzonden zodat het eindpunt kan controleren of de gebeurtenisgegevens in aanmerking komen om ontvangen te worden.Event Grid sends the validation event so the endpoint can verify that it wants to receive event data. De web-app bevat code waarmee het abonnement kan worden gevalideerd.The web app includes code to validate the subscription.

    Azure Event Grid Viewer.

Een gebeurtenis verzenden naar het eindpuntSend an event to your endpoint

Nu gaan we een gebeurtenis activeren om te zien hoe het bericht via Event Grid naar het eindpunt wordt gedistribueerd.Now, let's trigger an event to see how Event Grid distributes the message to your endpoint. We schalen uw Azure Cache voor Redis exemplaar.We'll be scaling your Azure Cache for Redis instance.

  1. Navigeer Azure Portal naar uw Azure Cache voor Redis en selecteer Schalen in het menu links.In the Azure portal, navigate to your Azure Cache for Redis instance and select Scale on the left menu.

  2. Selecteer de gewenste prijscategorie op de pagina Schaal en klik op Selecteren.Select the desired pricing tier from the Scale page and click Select.

    U kunt schalen naar een andere prijscategorie met de volgende beperkingen:You can scale to a different pricing tier with the following restrictions:

    • U kunt niet schalen van een hogere prijscategorie naar een lagere prijscategorie.You can't scale from a higher pricing tier to a lower pricing tier.
      • U kunt niet van een Premium-cache omlaag schalen naar een Standard- of Basic-cache.You can't scale from a Premium cache down to a Standard or a Basic cache.
      • U kunt niet van een Standard-cache omlaag schalen naar een Basic-cache.You can't scale from a Standard cache down to a Basic cache.
    • U kunt schalen van een Basic-cache naar een Standard-cache, maar u kunt de grootte niet tegelijkertijd wijzigen.You can scale from a Basic cache to a Standard cache but you can't change the size at the same time. Als u een andere grootte nodig hebt, kunt u een volgende schaalbewerking naar de gewenste grootte uitvoeren.If you need a different size, you can do a subsequent scaling operation to the desired size.
    • U kunt een Basic-cache niet rechtstreeks naar een Premium-cache schalen.You can't scale from a Basic cache directly to a Premium cache. Schaal eerst van Basic naar Standard in één schaalbewerking en vervolgens van Standard naar Premium in een volgende schaalbewerking.First, scale from Basic to Standard in one scaling operation, and then from Standard to Premium in a subsequent scaling operation.
    • U kunt niet van een grotere grootte naar de C0-grootte (250 MB) schalen.You can't scale from a larger size down to the C0 (250 MB) size.

    Terwijl de cache wordt geschaald naar de nieuwe prijscategorie, wordt de status Schalen weergegeven op Azure Cache voor Redis blade.While the cache is scaling to the new pricing tier, a Scaling status is displayed in the Azure Cache for Redis blade. Wanneer het schalen is voltooid, verandert de status van Schalen in Wordt uitgevoerd.When scaling is complete, the status changes from Scaling to Running.

  3. U hebt de gebeurtenis geactiveerd en Event Grid heeft het bericht verzonden naar het eindpunt dat u hebt geconfigureerd toen u zich abonneerde.You've triggered the event, and Event Grid sent the message to the endpoint you configured when subscribing. Het bericht heeft de JSON-indeling en bevat een matrix met een of meer gebeurtenissen.The message is in the JSON format and it contains an array with one or more events. In het volgende voorbeeld bevat het JSON-bericht een matrix met één gebeurtenis.In the following example, the JSON message contains an array with one event. Bekijk uw web-app en u ziet dat er een gebeurtenis ScalingCompleted is ontvangen.View your web app and notice that a ScalingCompleted event was received.

    Azure Event Grid Viewer schalen in JSON-indeling.

Resources opschonenClean up resources

Als u van plan bent om door te gaan met deze gebeurtenis, schoont u de resources die u in deze quickstart hebt gemaakt, niet op.If you plan to continue working with this event, don't clean up the resources created in this quickstart. Verwijder anders de resources die u in deze quickstart hebt gemaakt.Otherwise, delete the resources you created in this quickstart.

Selecteer de resourcegroep en klik op Resourcegroep verwijderen.Select the resource group, and select Delete resource group.

Volgende stappenNext steps

U weet nu hoe u aangepaste onderwerpen maakt en hoe u zich abonneert op een gebeurtenis. Kijk waar Event Grid u nog meer bij kan helpen:Now that you know how to create custom topics and event subscriptions, learn more about what Event Grid can help you do: