Démarrage rapide : Acheminer des événements de stockage Blob vers un point de terminaison web avec le portail AzureQuickstart: Route Blob storage events to web endpoint with the Azure portal

Azure Event Grid est un service de gestion d’événements pour le cloud.Azure Event Grid is an eventing service for the cloud. Dans cet article, vous utilisez le portail Azure pour créer un compte de stockage d’objets blob, vous abonner aux événements de ce stockage d’objets blob et déclencher un événement pour afficher le résultat.In this article, you use the Azure portal to create a Blob storage account, subscribe to events for that blob storage, and trigger an event to view the result. En règle générale, vous envoyez des événements à un point de terminaison qui traite les données d’événement et entreprend des actions.Typically, you send events to an endpoint that processes the event data and takes actions. Toutefois, pour simplifier cet article, vous envoyez les événements à une application web qui collecte et affiche les messages.However, to simplify this article, you send the events to a web app that collects and displays the messages.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.

Une fois que vous avez fini, vous voyez que les données d’événement ont été envoyées à l’application web.When you're finished, you see that the event data has been sent to the web app.

Afficher les résultats

Créez un compte de stockage.Create a storage account

  1. Connectez-vous au portail Azure.Sign in to Azure portal.

  2. Pour créer un stockage d’objets blob, sélectionnez Créer une ressource.To create a Blob storage, select Create a resource.

  3. Sélectionnez Stockage pour filtrer les options disponibles, puis Compte de stockage - blob, fichier, table, file d’attente.Select for Storage to filter the available options, and select Storage account - blob, file, table, queue.

    Sélectionner Stockage

    Pour s’abonner à des événements, créez un compte de stockage v2 à usage général ou un compte de stockage d’objets blob.To subscribe to events, create either a general-purpose v2 storage account or a Blob storage account.

  4. Dans la page Créer un compte de stockage, procédez comme suit :On the Create storage account page, do the following steps:

    1. Sélectionnez votre abonnement Azure.Select your Azure subscription.

    2. Dans le champ Groupe de ressources, créez un groupe de ressources Azure ou sélectionnez un groupe existant.For Resource group, create a new resource group or select an existing one.

    3. Entrez le nom de votre compte de stockage.Enter the name for your storage account.

    4. Sélectionnez Revoir + créer.Select Review + create.

      Étapes de démarrage

    5. Dans la page Vérifier + créer, passez en revue les paramètres, puis sélectionnez Créer.On the Review + create page, review the settings, and select Create.

      Notes

      Seuls les comptes de stockage de type StorageV2 (v2 universel) et BlobStorage prennent en charge l’intégration d’événements.Only storage accounts of kind StorageV2 (general purpose v2) and BlobStorage support event integration. Le type Stockage (v1 universel) ne prend pas en charge l’intégration à Event Grid.Storage (genral purpose v1) does not support integration with Event Grid.

Créer un point de terminaison de messageCreate a message endpoint

Avant de nous abonner aux événements du stockage d’objets blob, nous allons créer le point de terminaison pour le message de l’événement.Before subscribing to the events for the Blob storage, let's create the endpoint for the event message. En règle générale, le point de terminaison entreprend des actions en fonction des données d’événement.Typically, the endpoint takes actions based on the event data. Pour simplifier ce guide de démarrage rapide, déployez une application web prédéfinie qui affiche les messages d’événement.To simplify this quickstart, you deploy a pre-built web app that displays the event messages. La solution déployée comprend un plan App Service, une offre App Service Web Apps et du code source en provenance de GitHub.The deployed solution includes an App Service plan, an App Service web app, and source code from GitHub.

  1. Sélectionnez Déployer sur Azure pour déployer la solution sur votre abonnement.Select Deploy to Azure to deploy the solution to your subscription.

    Button to Deploy to Aquent.

  2. Dans la page Déploiement personnalisé, procédez comme suit :On the Custom deployment page, do the following steps:

    1. Pour Groupe de ressources, sélectionnez le groupe de ressources que vous avez créé lors de la création du compte de stockage.For Resource group, select the resource group that you created when creating the storage account. Il sera plus facile pour vous de nettoyer une fois que vous aurez terminé le tutoriel en supprimant le groupe de ressources.It will be easier for you to clean up after you are done with the tutorial by deleting the resource group.

    2. Pour Nom du site, entrez un nom pour l’application web.For Site Name, enter a name for the web app.

    3. Pour Nom du plan d’hébergement, entrez un nom pour le plan App Service à utiliser pour l’hébergement de l’application web.For Hosting plan name, enter a name for the App Service plan to use for hosting the web app.

    4. Cochez la case J’accepte les termes et conditions mentionnés ci-dessus.Select the check box for I agree to the terms and conditions stated above.

    5. Sélectionnez Achat.Select Purchase.

      Paramètres de déploiement

  3. Le déploiement peut prendre quelques minutes.The deployment may take a few minutes to complete. Sélectionnez Alertes (icône représentant une cloche) dans le portail, puis Accéder au groupe de ressources.Select Alerts (bell icon) in the portal, and then select Go to resource group.

    Alerte - Accéder au groupe de ressources

  4. Dans la page Groupe de ressources, dans la liste des ressources, sélectionnez l’application web que vous avez créée.On the Resource group page, in the list of resources, select the web app that you created. Vous pouvez également voir le plan App Service et le compte de stockage dans cette liste.You also see the App Service plan and the storage account in this list.

    Sélectionner un site web

  5. Dans la page App Service de votre application web, sélectionnez l’URL pour accéder au site web.On the App Service page for your web app, select the URL to navigate to the web site. L’URL doit être au format suivant : https://<your-site-name>.azurewebsites.net.The URL should be in this format: https://<your-site-name>.azurewebsites.net.

    Accéder au site web

  6. Confirmez que vous voyez le site, mais qu’aucun événement n’a encore été posté sur celui-ci.Confirm that you see the site but no events have been posted to it yet.

    Afficher le nouveau site

Activer le fournisseur de ressources Event GridEnable Event Grid resource provider

Si vous n’avez jamais utilisé Event Grid dans votre abonnement Azure, vous devrez peut-être inscrire le fournisseur de ressources Event Grid.If you haven't previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider.

Dans le portail Azure :In the Azure portal:

  1. Sélectionnez Abonnements dans le menu de gauche.Select Subscriptions on the left menu.
  2. Sélectionnez l’abonnement que vous utilisez pour Event Grid.Select the subscription you're using for Event Grid.
  3. Dans le menu de gauche, sous Paramètres, sélectionnez Fournisseurs de ressources.On the left menu, under Settings, select Resource providers.
  4. Recherchez Microsoft.EventGrid.Find Microsoft.EventGrid.
  5. Si l’inscription n’est pas encore faite, sélectionnez S’inscrire.If not registered, select Register.

L’inscription peut prendre un certain temps.It may take a moment for the registration to finish. Sélectionnez Actualiser pour mettre à jour l’état.Select Refresh to update the status. Lorsque l’état est Inscrit, vous êtes prêt à continuer.When Status is Registered, you're ready to continue.

S’abonner à un stockage d’objets blobSubscribe to the Blob storage

Vous vous abonnez à une rubrique pour communiquer à Event Grid les événements qui vous intéressent, et où les envoyer.You subscribe to a topic to tell Event Grid which events you want to track, and where to send the events.

  1. Dans le portail, accédez au compte de stockage Azure que vous avez créé précédemment.In the portal, navigate to your Azure Storage account that you created earlier. Dans le menu de gauche, sélectionnez Toutes les ressources et votre compte de stockage.On the left menu, select All resources and select your storage account.

  2. Dans la page Compte de stockage, sélectionnez Événements dans le menu de gauche.On the Storage account page, select Events on the left menu.

  3. Sélectionnez Autres options, puis Webhook.Select More Options, and Web Hook. Vous envoyez des événements à votre application de visionneuse, avec un webhook comme point de terminaison.You are sending events to your viewer app using a web hook for the endpoint.

    Sélectionner Webhook

  4. Dans la page Créer un abonnement aux événements, effectuez les étapes suivantes :On the Create Event Subscription page, do the following steps:

    1. Entrez un nom pour l’abonnement aux événements.Enter a name for the event subscription.

    2. Entrez un nom pour la rubrique système.Enter a name for the system topic. Pour en savoir plus sur les rubriques système, consultez Vue d’ensemble des rubriques système.To learn about system topics, see Overview of system topics.

      Entrez des noms pour l’abonnement aux événements et la rubrique système

    3. Sélectionnez Webhook pour Type de point de terminaison.Select Web Hook for Endpoint type.

      Sélectionner le type de point de terminaison webhook

  5. Pour Point de terminaison, cliquez sur Sélectionner un point de terminaison, entrez l’URL de votre application web et ajoutez api/updates à l’URL de la page d’accueil (par exemple, https://spegridsite.azurewebsites.net/api/updates), puis sélectionnez Confirmer la sélection.For Endpoint, click Select an endpoint, and enter the URL of your web app and add api/updates to the home page URL (for example: https://spegridsite.azurewebsites.net/api/updates), and then select Confirm Selection.

    Confirmer la sélection du point de terminaison

  6. À présent, dans la page Créer un abonnement aux événements, sélectionnez Créer pour créer l’abonnement aux événements.Now, on the Create Event Subscription page, select Create to create the event subscription.

    Sélectionner des journaux d’activité

  7. Affichez à nouveau votre application web, et notez qu’un événement de validation d’abonnement lui a été envoyé.View your web app again, and notice that a subscription validation event has been sent to it. Sélectionnez l’icône en forme d’œil pour développer les données d’événements.Select the eye icon to expand the event data. Event Grid envoie l’événement de validation pour que le point de terminaison puisse vérifier qu’il souhaite recevoir des données d’événement.Event Grid sends the validation event so the endpoint can verify that it wants to receive event data. L’application web inclut du code pour valider l’abonnement.The web app includes code to validate the subscription.

    Afficher l’événement d’abonnement

Nous allons maintenant déclencher un événement pour voir comment Event Grid distribue le message à votre point de terminaison.Now, let's trigger an event to see how Event Grid distributes the message to your endpoint.

Envoyer un événement à votre point de terminaisonSend an event to your endpoint

Pour déclencher un événement pour le stockage d’objets blob, chargez un fichier.You trigger an event for the Blob storage by uploading a file. Celui-ci n’a pas besoin d’un contenu spécifique.The file doesn't need any specific content. L’article part du principe que vous disposez d’un fichier nommé testfile.txt, mais vous pouvez utiliser n’importe quel fichier.The articles assumes you have a file named testfile.txt, but you can use any file.

  1. Dans le portail Azure, accédez à votre compte de stockage d’objets blob, puis sélectionnez Conteneurs dans la page Vue d’ensemble.In the Azure portal, navigate to your Blob storage account, and select Containers on the Overview page.

    Sélectionner Objets Blob

  2. Sélectionnez + Conteneur.Select + Container. Donnez un nom à votre conteneur et utilisez n’importe quel niveau d’accès, puis sélectionnez Créer.Give you container a name, and use any access level, and select Create.

    Ajouter un conteneur

  3. Sélectionnez votre nouveau conteneur.Select your new container.

    Sélectionner un conteneur

  4. Pour charger un fichier, sélectionnez Charger.To upload a file, select Upload. Dans la page Charger l’objet blob, recherchez et sélectionnez un fichier à charger à des fins de test, puis sélectionnez Charger dans cette page.On the Upload blob page, browse and select a file that you want to upload for testing, and then select Upload on that page.

    Sélectionner Télécharger

  5. Accédez à votre fichier de test et chargez-le.Browse to your test file and upload it.

  6. Vous avez déclenché l’événement, et Event Grid a envoyé le message au point de terminaison configuré lors de l’abonnement.You've triggered the event, and Event Grid sent the message to the endpoint you configured when subscribing. Le message au format JSON contient un tableau répertoriant un ou plusieurs événements.The message is in the JSON format and it contains an array with one or more events. Dans l’exemple suivant, le message JSON contient un tableau avec un événement.In the following example, the JSON message contains an array with one event. Quand vous examinez votre application web, vous remarquerez qu’un événement créé par un objet blob a été reçu.View your web app and notice that a blob created event was received.

    Événement créé par un objet blob

Nettoyer les ressourcesClean up resources

Si vous envisagez de continuer à utiliser cet événement, ne supprimez pas les ressources créées dans cet article.If you plan to continue working with this event, don't clean up the resources created in this article. Dans le cas contraire, supprimez les ressources créées avec cet article.Otherwise, delete the resources you created in this article.

Sélectionnez le groupe de ressources, puis Supprimer le groupe de ressources.Select the resource group, and select Delete resource group.

Étapes suivantesNext steps

Maintenant que vous savez créer des rubriques et des abonnements d’événements personnalisés, vous pouvez en apprendre davantage sur Event Grid et ce qu’il peut vous offrir :Now that you know how to create custom topics and event subscriptions, learn more about what Event Grid can help you do: