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
Dans le hub en temps réel, sélectionnez les événements Fabric.
Sélectionnez Événements de Stockage Blob Azure dans la liste.
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 : |
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}} |