Explorer les événements de Stockage Blob Azure dans le hub en temps réel Fabric (préversion)

Remarque

Le hub Real-Time est actuellement en version préliminaire.

Cet article explique comment explorer les événements de Stockage Blob Azure dans le hub Fabric en temps réel. Les événements de Stockage Blob Azure vous permettent de recevoir des notifications lorsque certaines actions se produisent sur vos objets blob. Par exemple, vous pouvez recevoir une notification lorsqu’un objet blob est créé ou qu’un objet blob existant est modifié. Ces événements peuvent être utilisés pour définir une alerte sur d’autres actions ou d’autres flux de travail, tels que la mise à jour d’une base de données ou l’envoi d’une notification. Cet article fournit les propriétés et les schémas des événements de Stockage Blob Azure.

Remarque

L’utilisation d’événements Fabric via eventstream ou Data Activator n’est pas prise en charge si la région de capacité du flux d’événements ou de Data Activator se trouve dans les régions suivantes : Allemagne Centre-Ouest, USA Centre Sud, USA Ouest2, USA Ouest 3 ou Inde occidentale.

Afficher la page des détails des événements de Stockage Blob Azure

1. Dans le hub en temps réel, basculez vers l’onglet Événements Fabric.

2. Sélectionnez Événements de Stockage Blob Azure dans la liste.

   

3. Vous devez voir la page de détails des événements de Stockage Blob Azure.

   

Actions

En haut de la page de détails des événements de Stockage Blob Azure, vous voyez les deux actions suivantes.

• Créer un Eventstream : vous permet de créer un Eventstream basé sur les événements du Stockage Blob Azure sélectionné.

• Définir une alerte : vous permet de définir une alerte lorsqu’une opération est effectuée sur un artefact de Stockage Blob Azure. Par exemple, vous pouvez définir une alerte lorsqu’un objet blob est créé ou supprimé.

  

Découvrez ce qui utilise cette catégorie

Cette section présente les artefacts à l’aide des événements Stockage Blob Azure. Voici les colonnes et leurs descriptions affichées dans la liste.

Colonne	Description
Nom	Nom de l’artefact qui utilise les événements Stockage Blob Azure.
Type	Type d’artefact – Reflex ou Eventstream
Espace de travail	Espace de travail où réside l’artefact.
Source	Nom de la source (compte Stockage Blob Azure).

Profil d’événements de Stockage Blob Azure

Types d’événements

Nom du type d’événement	Description
Microsoft.Storage.BlobCreated	Cet événement est activé lorsqu’un nouvel objet blob est ajouté ou lorsqu’un objet blob existant est mis à jour. L’événement est déclenché par les clients qui utilisent les opérations CreateFile et FlushWithClose qui se trouvent dans l’API REST Azure Data Lake Stockage Gen2.
Microsoft.Storage.BlobDeleted	Cet événement est activé lorsqu’un objet blob est supprimé. Plus précisément, cet événement est déclenché quand des clients utilisent l’opération DeleteFile qui est disponible dans l’API REST Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobRenamed	Cet événement est activé lorsqu’un objet blob subit une modification de nom, en particulier lorsque les utilisateurs utilisent la fonction RenameFile trouvée dans l’API REST Azure Data Lake Stockage Gen2.
Microsoft.Storage.BlobTierChanged	Cet événement est activé lorsque le niveau d’accès d’objet blob est modifié via l’opération SetBlobTier dans l’API REST d’objet blob et est déclenché une fois que la modification est entièrement traitée.
Microsoft.Storage.AsyncOperationInitiated	Cet événement se produit lorsque les données sont déplacées ou copiées de l’archive vers les niveaux chauds ou froids. Il se déclenche quand les clients utilisent l’API SetBlobTier pour déplacer un objet blob du niveau archive vers le niveau chaud ou froid, ou quand les clients appellent l’API CopyBlob pour copier des données d’un objet blob du niveau archive vers un objet blob du niveau chaud ou froid.
Microsoft.Storage.DirectoryCreated	Cet événement est activé lorsqu’un répertoire est créé ou qu’un client utilise l’opération CreateDirectory fournie dans l’API REST Azure Data Lake Stockage Gen2 pour former un nouveau répertoire.
Microsoft.Storage.DirectoryRenamed	Cet événement est activé lorsqu’un répertoire subit une modification de nom, en particulier lorsque les clients utilisent la fonctionnalité RenameDirectory dans l’API REST Azure Data Lake Stockage Gen2.
Microsoft.Storage.DirectoryDeleted	Cet événement est activé lorsqu’un répertoire est supprimé, lorsque les clients utilisent la fonctionnalité DeleteDirectory présente dans l’API REST Azure Data Lake Stockage Gen2.
Microsoft.Storage.BlobInventoryPolicyCompleted	Cet événement est activé lorsque l’exécution de l’inventaire se termine pour une stratégie spécifiée en tant que stratégie d’inventaire. Il est également activé si l’exécution de l’inventaire échoue en raison d’une erreur utilisateur avant son début, telle qu’une stratégie erronée ou un conteneur de destination absent.
Microsoft.Storage.LifecyclePolicyCompleted	Cet événement fait référence à l’activation d’une stratégie de gestion du cycle de vie lorsque ses actions définies sont exécutées.

Schémas

Un événement contient les données générales suivantes :

Propriété	Type	Description	Exemple :
source	string	Chemin d’accès complet à la source de l’événement. Ce champ n’est pas modifiable. Event Grid fournit cette valeur.	/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account
subject	string	Chemin de l’objet de l’événement, défini par le serveur de publication.	/blobServices/default/containers/my-file-system/blobs/new-file.txt
type	string	Un des types d’événements inscrits pour cette source d’événement.	Microsoft.Storage.BlobCreated
time	string	L’heure à quelle l’événement est généré selon l’heure UTC du fournisseur.	2017-06-26T18:41:00.9584103Z
id	string	Identificateur unique de l’événement.	00000000-0000-0000-0000-000000000000
data	object	Données d’événement de stockage Blob.	{{Data object}}
specversion	string	Version de la spécification de schéma CloudEvents.	1.0
fabricsource	string	ID de l’Eventstream Fabric pour la source d’événement du stockage Blob Azure.	/tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000
fabricsubject	string	ID du lien d’événement pour la source d’événement du stockage Blob Azure.	eventLinks/00000000-0000-0000-0000-000000000000

L’objet data dispose des propriétés suivantes :

Propriété	Type	Description	Exemple :
api	string	Opération qui a déclenché l’événement.	CreateFile
clientRequestId	string	ID de requête fourni par le client pour l’opération d’API de stockage. Cet ID peut être utilisé pour mettre en corrélation les journaux de diagnostic Stockage Azure en utilisant le champ « client-request-id » dans les journaux, et peut être fourni dans des requêtes du client à l’aide de l’en-tête « x-ms-client-request-id ». Consultez Format de journal.	00000000-0000-0000-0000-000000000000
requestId	string	ID de requête généré par le service pour l’opération de l’API de stockage. Peut être utilisé pour mettre en corrélation les journaux de diagnostic de stockage Azure en utilisant le champ « request-id-header » dans les journaux d’activité et est retourné lors de l’initialisation de l’appel d’API dans l’en-tête ’x-ms-request-id’. Consultez Format de journal.	00000000-0000-0000-0000-000000000000
eTag	string	Valeur que vous pouvez utiliser pour exécuter des opérations de manière conditionnelle.	\"0x8D4BCC2E4835CD0\"
contentType	string	Type de contenu spécifié pour l’objet blob.	text/plain
contentLength	entier	Taille de l’objet blob en octets.	0
blobType	string	Type d’objet blob. Les valeurs valides sont BlockBlob ou PageBlob.	BlockBlob
contentOffset	nombre	Décalage, en octets, d’une opération d’écriture effectuée au point où l’application de déclenchement d’événement a effectué l’écriture dans le fichier. Apparaît uniquement pour les événements déclenchés sur les comptes de stockage d’objets blob qui ont un espace de noms hiérarchique.	0
destinationUrl	string	URL du fichier qui existera une fois l’opération terminée. Par exemple, si un fichier est renommé, la propriété destinationUrl contient l’URL du nouveau nom de fichier. Apparaît uniquement pour les événements déclenchés sur les comptes de stockage d’objets blob qui ont un espace de noms hiérarchique.	https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt
sourceUrl	string	URL du fichier qui existe avant que l'opération ne soit effectuée. Par exemple, si un fichier est renommé, la sourceUrl contient l’URL du nom de fichier d’origine avant l’opération de changement de nom. Apparaît uniquement pour les événements déclenchés sur les comptes de stockage d’objets blob qui ont un espace de noms hiérarchique.	https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory
url	string	Chemin de l’objet blob. Si le client utilise une API REST Blob, la structure de l'URL est la suivante :<storage-account-name>.blob.core.windows.net\<container-name>\<file-name>. Si le client utilise une API REST Data Lake Storage, la structure de l'URL est la suivante : <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>.	https://myaccount.blob.core.windows.net/container01/file.txt
recursive	string	Vrai pour exécuter l’opération sur tous les répertoires enfants ; sinon Faux. Apparaît uniquement pour les événements déclenchés sur les comptes de stockage d’objets blob qui ont un espace de noms hiérarchique.	true
sequencer	string	Une valeur de chaîne opaque représentant l’ordre logique des événements pour n’importe quel nom d’objet Blob particulier. Les utilisateurs peuvent utiliser la comparaison de chaînes standard pour comprendre l’ordre relatif de deux événements sur le même nom d’objet Blob.	00000000000004420000000000028963
identity	string	Valeur de chaîne représentant l’identité associée à l'événement. Pour SFTP, la valeur est le nom d’utilisateur local.	localuser
storageDiagnostics	object	Des données de diagnostic occasionnellement incluses par le service de stockage Azure. Le cas échéant, les consommateurs d’événements doivent l’ignorer.	{{Storage diagnostic object}}

Contenu connexe

• Explorer les événements d’élément d’espace de travail Fabric