Archiviazione BLOB di Azure come origine di Griglia di eventi

  • Articolo

Questo articolo illustra le proprietà e lo schema per gli eventi di archiviazione BLOB. Per un'introduzione agli schemi di eventi, vedere Schema di eventi di Griglia di eventi di Azure. Fornisce anche un elenco di guide introduttive ed esercitazioni da usare Archiviazione BLOB di Azure come origine evento.

Nota

Solo gli account di archiviazione di tipo Archiviazione V2 (utilizzo generico v2), BlockBlob Archiviazione e Blob Archiviazione supportano l'integrazione degli eventi. Archiviazione (utilizzo generico v1) non supporta l'integrazione con Griglia di eventi.

Tipi di evento disponibili

Eventi di Archiviazione BLOB

Questi eventi vengono attivati quando un client crea, sostituisce o elimina un BLOB chiamando le API REST blob.

Nota

I $logs contenitori e $blobchangefeed non sono integrati con Griglia di eventi, quindi l'attività in questi contenitori non genererà eventi. Inoltre, l'uso dell'endpoint (abfss://URI) dfs per gli account abilitati per gli spazi dei nomi non gerarchici non genererà eventi, ma l'endpoint (wasb:// URI) BLOB genererà eventi.

Nome evento Descrizione
Microsoft. Archiviazione. BLOBCreated Attivato quando viene creato o sostituito un BLOB.
In particolare, questo evento viene attivato quando i client usano le PutBloboperazioni , PutBlockListo CopyBlob disponibili nell'API REST BLOB e quando viene eseguito il commit completo del BLOB in blocchi.
Se i client usano l'operazione CopyBlob sugli account in cui è abilitata la funzionalità dello spazio dei nomi gerarchico, l'operazione CopyBlob funziona in modo leggermente diverso. In tal caso, microsoft.Archiviazione. L'evento BlobCreated viene attivato quando l'operazione CopyBlob viene avviata e non quando viene eseguito il commit completo del BLOB in blocchi.
Microsoft. Archiviazione. BlobDeleted Attivato quando viene eliminato un BLOB.
In particolare, questo evento viene attivato quando i client chiamano l'operazione DeleteBlob disponibile nell'API REST BLOB.
Microsoft. Archiviazione. BlobTierChanged Attivato quando viene modificato il livello di accesso al BLOB. In particolare, quando i client chiamano l'operazione Set Blob Tier disponibile nell'API REST BLOB, questo evento viene attivato al termine della modifica del livello.
Microsoft. Archiviazione. AsyncOperationInitiated Attivato quando viene avviata un'operazione che comporta lo spostamento o la copia di dati dall'archivio a livelli ad accesso frequente o sporadico. In particolare, questo evento viene attivato quando i client chiamano l'API Set Blob Tier per spostare un BLOB dal livello archivio al livello ad accesso frequente o sporadico o quando i client chiamano l'API Copy Blob per copiare dati da un BLOB nel livello di archiviazione a un BLOB nel livello ad accesso frequente o sporadico.

Eventi di esempio

Microsoft. Archiviazione. Evento BlobCreated

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/test-container/blobs/new-file.txt",
  "eventType": "Microsoft.Storage.BlobCreated",
  "eventTime": "2017-06-26T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "PutBlockList",
    "clientRequestId": "6d79dbfb-0e37-4fc4-981f-442c9ca65760",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "eTag": "\"0x8D4BCC2E4835CD0\"",
    "contentType": "text/plain",
    "contentLength": 524288,
    "blobType": "BlockBlob",
    "url": "https://my-storage-account.blob.core.windows.net/testcontainer/new-file.txt",
    "sequencer": "00000000000004420000000000028963",
    "storageDiagnostics": {
      "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento BlobDeleted

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/file-to-delete.txt",
  "eventType": "Microsoft.Storage.BlobDeleted",
  "eventTime": "2017-11-07T20:09:22.5674003Z",
  "id": "4c2359fe-001e-00ba-0e04-58586806d298",
  "data": {
    "api": "DeleteBlob",
    "requestId": "4c2359fe-001e-00ba-0e04-585868000000",
    "contentType": "text/plain",
    "blobType": "BlockBlob",
    "url": "https://my-storage-account.blob.core.windows.net/testcontainer/file-to-delete.txt",
    "sequencer": "0000000000000281000000000002F5CA",
    "storageDiagnostics": {
      "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento BlobTierChanged

{
	"topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
	"subject": "/blobServices/default/containers/testcontainer/blobs/Auto.jpg",
	"eventType": "Microsoft.Storage.BlobTierChanged",
	"eventTime": "2021-05-04T15:00:00.8350154Z",
	"id": "0fdefc06-b01e-0034-39f6-4016610696f6",
	"data": {
		"api": "SetBlobTier",
		"clientRequestId": "68be434c-1a0d-432f-9cd7-1db90bff83d7",
		"requestId": "0fdefc06-b01e-0034-39f6-401661000000",
		"contentType": "image/jpeg",
		"contentLength": 105891,
		"blobType": "BlockBlob",
		"url": "https://my-storage-account.blob.core.windows.net/testcontainer/Auto.jpg",
		"sequencer": "000000000000000000000000000089A4000000000018d6ea",
		"storageDiagnostics": {
			"batchId": "3418f7a9-7006-0014-00f6-406dc6000000"
		}
	},
	"dataVersion": "",
	"metadataVersion": "1"
}

Microsoft. Archiviazione. Evento AsyncOperationInitiated

{
	"topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
	"subject": "/blobServices/default/containers/testcontainer/blobs/00000.avro",
	"eventType": "Microsoft.Storage.AsyncOperationInitiated",
	"eventTime": "2021-05-04T14:44:59.3204652Z",
	"id": "8ea4e3f2-101e-003d-5ff4-4053b2061016",
	"data": {
		"api": "SetBlobTier",
		"clientRequestId": "777fb4cd-f890-4c5b-b024-fb47300bae62",
		"requestId": "8ea4e3f2-101e-003d-5ff4-4053b2000000",
		"contentType": "application/octet-stream",
		"contentLength": 3660,
		"blobType": "BlockBlob",
		"url": "https://my-storage-account.blob.core.windows.net/testcontainer/00000.avro",
		"sequencer": "000000000000000000000000000089A4000000000018c6d7",
		"storageDiagnostics": {
			"batchId": "34128c8a-7006-0014-00f4-406dc6000000"
		}
	},
	"dataVersion": "",
	"metadataVersion": "1"
}

Eventi di Data Lake Archiviazione Gen 2

Questi eventi vengono attivati se si abilita uno spazio dei nomi gerarchico nell'account di archiviazione e i client usano le API REST di Azure Data Lake Archiviazione Gen2. Per altre informazioni su Azure Data Lake Archiviazione Gen2, vedere Introduzione ad Azure Data Lake Archiviazione Gen2.

Nome evento Descrizione
Microsoft. Archiviazione. BLOBCreated Attivato quando viene creato o sostituito un BLOB.
In particolare, questo evento viene attivato quando i client usano le CreateFile operazioni e FlushWithClose disponibili nell'API REST di Azure Data Lake Archiviazione Gen2.
Microsoft. Archiviazione. BlobDeleted Attivato quando viene eliminato un BLOB.
In particolare, questo evento viene attivato anche quando i client chiamano l'operazione DeleteFile disponibile nell'API REST di Azure Data Lake Archiviazione Gen2.
Microsoft. Archiviazione. BlobRenamed Attivato quando un BLOB viene rinominato.
In particolare, questo evento viene attivato quando i client usano l'operazione RenameFile disponibile nell'API REST di Azure Data Lake Archiviazione Gen2.
Microsoft. Archiviazione. DirectoryCreata Attivato quando viene creata una directory.
In particolare, questo evento viene attivato quando i client usano l'operazione CreateDirectory disponibile nell'API REST di Azure Data Lake Archiviazione Gen2.
Microsoft. Archiviazione. DirectoryRenamed Attivato quando una directory viene rinominata.
In particolare, questo evento viene attivato quando i client usano l'operazione RenameDirectory disponibile nell'API REST di Azure Data Lake Archiviazione Gen2.
Microsoft. Archiviazione. DirectoryDeleted Attivato quando viene eliminata una directory.
In particolare, questo evento viene attivato quando i client usano l'operazione DeleteDirectory disponibile nell'API REST di Azure Data Lake Archiviazione Gen2.

Nota

Per Azure Data Lake Archiviazione Gen2, se si vuole assicurarsi che Microsoft.Archiviazione. L'evento BlobCreated viene attivato solo quando viene eseguito completamente il commit di un BLOB in blocchi, filtrare l'evento per la chiamata all'API FlushWithClose REST. Questa chiamata API attiva microsoft.Archiviazione. Evento BlobCreated solo dopo il commit completo dei dati in un BLOB in blocchi. Per informazioni su come creare un filtro, vedere Filtrare gli eventi per Griglia di eventi.

Eventi di esempio

Microsoft. Archiviazione. Evento BlobCreated (Data Lake Archiviazione Gen2)

Se l'account di archiviazione BLOB ha uno spazio dei nomi gerarchico, i dati sono simili all'esempio di blob Archiviazione ad eccezione di queste modifiche:

  • La dataVersion chiave è impostata su un valore di 2.

  • La data.api chiave è impostata sulla stringa CreateFile o FlushWithClose.

  • La contentOffset chiave è inclusa nel set di dati.

Nota

Se le applicazioni usano l'operazione PutBlockList per caricare un nuovo BLOB nell'account, i dati non conterranno queste modifiche.

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/new-file.txt",
  "eventType": "Microsoft.Storage.BlobCreated",
  "eventTime": "2017-06-26T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "CreateFile",
    "clientRequestId": "6d79dbfb-0e37-4fc4-981f-442c9ca65760",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "eTag": "\"0x8D4BCC2E4835CD0\"",
    "contentType": "text/plain",
    "contentLength": 0,
    "contentOffset": 0,
    "blobType": "BlockBlob",
    "url": "https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt",
    "sequencer": "00000000000004420000000000028963",  
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "2",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento BlobDeleted (Data Lake Archiviazione Gen2)

Se l'account di archiviazione BLOB ha uno spazio dei nomi gerarchico, i dati sono simili all'esempio precedente, ad eccezione di queste modifiche:

  • La dataVersion chiave è impostata su un valore di 2.

  • La data.api chiave è impostata sulla stringa DeleteFile.

  • La url chiave contiene il percorso dfs.core.windows.net.

Nota

Se le applicazioni usano l'operazione DeleteBlob per eliminare un BLOB dall'account, i dati non conterranno queste modifiche.

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/file-to-delete.txt",
  "eventType": "Microsoft.Storage.BlobDeleted",
  "eventTime": "2017-06-26T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
    "data": {
    "api": "DeleteFile",
    "clientRequestId": "6d79dbfb-0e37-4fc4-981f-442c9ca65760",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "contentType": "text/plain",
    "blobType": "BlockBlob",
    "url": "https://my-storage-account.dfs.core.windows.net/my-file-system/file-to-delete.txt",
    "sequencer": "00000000000004420000000000028963",  
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "2",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento BlobRenamed (Data Lake Archiviazione Gen2)

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/my-renamed-file.txt",
  "eventType": "Microsoft.Storage.BlobRenamed",
  "eventTime": "2017-06-26T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "RenameFile",
    "clientRequestId": "6d79dbfb-0e37-4fc4-981f-442c9ca65760",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "destinationUrl": "https://my-storage-account.dfs.core.windows.net/my-file-system/my-renamed-file.txt",
    "sourceUrl": "https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-file.txt",
    "sequencer": "00000000000004420000000000028963",  
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento DirectoryCreated (Data Lake Archiviazione Gen2)

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/my-new-directory",
  "eventType": "Microsoft.Storage.DirectoryCreated",
  "eventTime": "2017-06-26T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "CreateDirectory",
    "clientRequestId": "6d79dbfb-0e37-4fc4-981f-442c9ca65760",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "url": "https://my-storage-account.dfs.core.windows.net/my-file-system/my-new-directory",
    "sequencer": "00000000000004420000000000028963",  
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento DirectoryRenamed (Data Lake Archiviazione Gen2)

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/my-renamed-directory",
  "eventType": "Microsoft.Storage.DirectoryRenamed",
  "eventTime": "2017-06-26T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "RenameDirectory",
    "clientRequestId": "6d79dbfb-0e37-4fc4-981f-442c9ca65760",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "destinationUrl": "https://my-storage-account.dfs.core.windows.net/my-file-system/my-renamed-directory",
    "sourceUrl": "https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory",
    "sequencer": "00000000000004420000000000028963",  
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento DirectoryDeleted (Data Lake Archiviazione Gen2)

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/directory-to-delete",
  "eventType": "Microsoft.Storage.DirectoryDeleted",
  "eventTime": "2017-06-26T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "DeleteDirectory",
    "clientRequestId": "6d79dbfb-0e37-4fc4-981f-442c9ca65760",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "url": "https://my-storage-account.dfs.core.windows.net/my-file-system/directory-to-delete",
    "recursive": "true", 
    "sequencer": "00000000000004420000000000028963",  
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Eventi SFTP

Questi eventi vengono attivati se si abilita uno spazio dei nomi gerarchico nell'account di archiviazione e i client usano le API SFTP. Per altre informazioni sul supporto SFTP per Archiviazione BLOB di Azure, vedere SSH File Transfer Protocol (SFTP) in Archiviazione BLOB di Azure.

Nome evento Descrizione
Microsoft. Archiviazione. BLOBCreated Attivato quando viene creato o sovrascritto un BLOB.
In particolare, questo evento viene attivato quando i client usano l'operazione put , che corrisponde alle SftpCreate API e SftpCommit . Quando il file viene aperto, viene creato un BLOB vuoto e viene eseguito il commit del contenuto caricato quando il file viene chiuso.
Microsoft. Archiviazione. BlobDeleted Attivato quando viene eliminato un BLOB.
In particolare, questo evento viene attivato anche quando i client chiamano l'operazione rm , che corrisponde all'API SftpRemove .
Microsoft. Archiviazione. BlobRenamed Attivato quando un BLOB viene rinominato.
In particolare, questo evento viene attivato quando i client usano l'operazione rename sui file, che corrisponde all'API SftpRename .
Microsoft. Archiviazione. DirectoryCreata Attivato quando viene creata una directory.
In particolare, questo evento viene attivato quando i client usano l'operazione mkdir , che corrisponde all'API SftpMakeDir .
Microsoft. Archiviazione. DirectoryRenamed Attivato quando una directory viene rinominata.
In particolare, questo evento viene attivato quando i client usano l'operazione rename in una directory, che corrisponde all'API SftpRename .
Microsoft. Archiviazione. DirectoryDeleted Attivato quando viene eliminata una directory.
In particolare, questo evento viene attivato quando i client usano l'operazione rmdir , che corrisponde all'API SftpRemoveDir .

Eventi di esempio

Quando viene attivato un evento, il servizio Griglia di eventi invia i dati relativi all'evento all'endpoint di sottoscrizione. Questa sezione contiene un esempio dell'aspetto dei dati per ogni evento di archiviazione BLOB.

Microsoft. Archiviazione. Evento BlobCreated (SFTP)

Se l'account di archiviazione BLOB usa SFTP per creare o sovrascrivere un BLOB, i dati sono simili all'esempio precedente, ad eccezione di queste modifiche:

  • La dataVersion chiave è impostata su un valore di 3.

  • La data.api chiave è impostata sulla stringa SftpCreate o SftpCommit.

  • La clientRequestId chiave non è inclusa.

  • La contentType chiave è impostata application/octet-streamsu .

  • La contentOffset chiave è inclusa nel set di dati.

  • La identity chiave è inclusa nel set di dati. Corrisponde all'utente locale usato per l'autenticazione SFTP.

Nota

I caricamenti SFTP genereranno 2 eventi. Uno SftpCreate per un BLOB vuoto iniziale creato all'apertura del file e uno SftpCommit quando il contenuto del file viene scritto. Se si vuole assicurarsi che Microsoft. Archiviazione. L'evento BlobCreated viene attivato solo quando viene eseguito il commit completo di un BLOB in blocchi, filtrare l'evento per la chiamata ALL'API REST SftpCommit.

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/new-file.txt",
  "eventType": "Microsoft.Storage.BlobCreated",
  "eventTime": "2022-04-25T19:13:00.1522383Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "SftpCommit",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "eTag": "\"0x8D4BCC2E4835CD0\"",
    "contentType": "application/octet-stream",
    "contentLength": 0,
    "contentOffset": 0,
    "blobType": "BlockBlob",
    "url": "https://my-storage-account.blob.core.windows.net/testcontainer/new-file.txt",
    "sequencer": "00000000000004420000000000028963",
    "identity":"localuser",
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "3",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento BlobDeleted (SFTP)

Se l'account di archiviazione BLOB usa SFTP per eliminare un BLOB, i dati sono simili all'esempio precedente, ad eccezione di queste modifiche:

  • La dataVersion chiave è impostata su un valore di 2.

  • La data.api chiave è impostata sulla stringa SftpRemove.

  • La clientRequestId chiave non è inclusa.

  • La contentType chiave è impostata application/octet-streamsu .

  • La identity chiave è inclusa nel set di dati. Corrisponde all'utente locale usato per l'autenticazione SFTP.

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/new-file.txt",
  "eventType": "Microsoft.Storage.BlobDeleted",
  "eventTime": "2022-04-25T19:13:00.1522383Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "SftpRemove",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "contentType": "text/plain",
    "blobType": "BlockBlob",
    "url": "https://my-storage-account.blob.core.windows.net/testcontainer/new-file.txt",
    "sequencer": "00000000000004420000000000028963",  
    "identity":"localuser",
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "2",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento BlobRenamed (SFTP)

Se l'account di archiviazione BLOB usa SFTP per rinominare un BLOB, i dati sono simili all'esempio precedente, ad eccezione di queste modifiche:

  • La data.api chiave è impostata sulla stringa SftpRename.

  • La clientRequestId chiave non è inclusa.

  • La identity chiave è inclusa nel set di dati. Corrisponde all'utente locale usato per l'autenticazione SFTP.

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/my-renamed-file.txt",
  "eventType": "Microsoft.Storage.BlobRenamed",
  "eventTime": "2022-04-25T19:13:00.1522383Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "SftpRename",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "destinationUrl": "https://my-storage-account.blob.core.windows.net/testcontainer/my-renamed-file.txt",
    "sourceUrl": "https://my-storage-account.blob.core.windows.net/testcontainer/my-original-file.txt",
    "sequencer": "00000000000004420000000000028963",  
    "identity":"localuser",
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento DirectoryCreated (SFTP)

Se l'account di archiviazione BLOB usa SFTP per creare una directory, i dati sono simili all'esempio precedente, ad eccezione di queste modifiche:

  • La dataVersion chiave è impostata su un valore di 2.

  • La data.api chiave è impostata sulla stringa SftpMakeDir.

  • La clientRequestId chiave non è inclusa.

  • La identity chiave è inclusa nel set di dati. Corrisponde all'utente locale usato per l'autenticazione SFTP.

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/my-new-directory",
  "eventType": "Microsoft.Storage.DirectoryCreated",
  "eventTime": "2022-04-25T19:13:00.1522383Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "SftpMakeDir",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "url": "https://my-storage-account.blob.core.windows.net/testcontainer/my-new-directory",
    "sequencer": "00000000000004420000000000028963",  
    "identity":"localuser",
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "2",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento DirectoryRenamed (SFTP)

Se l'account di archiviazione BLOB usa SFTP per rinominare una directory, i dati sono simili all'esempio precedente, ad eccezione di queste modifiche:

  • La data.api chiave è impostata sulla stringa SftpRename.

  • La clientRequestId chiave non è inclusa.

  • La identity chiave è inclusa nel set di dati. Corrisponde all'utente locale usato per l'autenticazione SFTP.

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/my-renamed-directory",
  "eventType": "Microsoft.Storage.DirectoryRenamed",
  "eventTime": "2022-04-25T19:13:00.1522383Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "SftpRename",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "destinationUrl": "https://my-storage-account.blob.core.windows.net/testcontainer/my-renamed-directory",
    "sourceUrl": "https://my-storage-account.blob.core.windows.net/testcontainer/my-original-directory",
    "sequencer": "00000000000004420000000000028963",  
    "identity":"localuser",
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Microsoft. Archiviazione. Evento DirectoryDeleted (SFTP)

Se l'account di archiviazione BLOB usa SFTP per eliminare una directory, i dati sono simili all'esempio precedente, ad eccezione di queste modifiche:

  • La data.api chiave è impostata sulla stringa SftpRemoveDir.

  • La clientRequestId chiave non è inclusa.

  • La identity chiave è inclusa nel set di dati. Corrisponde all'utente locale usato per l'autenticazione SFTP.

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/directory-to-delete",
  "eventType": "Microsoft.Storage.DirectoryDeleted",
  "eventTime": "2022-04-25T19:13:00.1522383Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "api": "SftpRemoveDir",
    "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
    "url": "https://my-storage-account.blob.core.windows.net/testcontainer/directory-to-delete",
    "recursive": "false", 
    "sequencer": "00000000000004420000000000028963",  
    "identity":"localuser",
    "storageDiagnostics": {
    "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Questi eventi vengono attivati quando vengono eseguite le azioni definite da un criterio.

Nome evento Descrizione
Microsoft. Archiviazione. BlobInventoryPolicyCompleted Attivato al termine dell'esecuzione dell'inventario per una regola definita da un criterio di inventario. Questo evento si verifica anche se l'esecuzione dell'inventario ha esito negativo e viene visualizzato un errore utente prima dell'avvio dell'esecuzione. Ad esempio, un criterio non valido o un errore che si verifica quando un contenitore di destinazione non è presente attiverà l'evento.
Microsoft. Archiviazione. LifecyclePolicyCompleted Attivato quando vengono eseguite le azioni definite da un criterio di gestione del ciclo di vita.

Eventi di esempio

Quando viene attivato un evento, il servizio Griglia di eventi invia i dati relativi all'evento all'endpoint di sottoscrizione. Questa sezione contiene un esempio dell'aspetto dei dati per ogni evento di archiviazione BLOB.

Microsoft. Archiviazione. Evento BlobInventoryPolicyCompleted

{
  "topic": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/BlobInventory/providers/Microsoft.EventGrid/topics/BlobInventoryTopic",
  "subject": "BlobDataManagement/BlobInventory",
  "eventType": "Microsoft.Storage.BlobInventoryPolicyCompleted",
  "eventTime": "2021-05-28T15:03:18Z",  
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "data": {
    "scheduleDateTime": "2021-05-28T03:50:27Z",
    "accountName": "testaccount",
    "ruleName": "Rule_1",
    "policyRunStatus": "Succeeded",
    "policyRunStatusMessage": "Inventory run succeeded, refer manifest file for inventory details.",
    "policyRunId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "manifestBlobUrl": "https://testaccount.blob.core.windows.net/inventory-destination-container/2021/05/26/13-25-36/Rule_1/Rule_1.csv"
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}

Microsoft. Archiviazione. LifecyclePolicyCompleted, evento

{
    "topic": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/contosoresourcegroup/providers/Microsoft.Storage/storageAccounts/contosostorageaccount",
    "subject": "BlobDataManagement/LifeCycleManagement/SummaryReport",
    "eventType": "Microsoft.Storage.LifecyclePolicyCompleted",
    "eventTime": "2022-05-26T00:00:40.1880331",    
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "data": {
        "scheduleTime": "2022/05/24 22:57:29.3260160",
        "deleteSummary": {
            "totalObjectsCount": 16,
            "successCount": 14,
            "errorList": ""
        },
        "tierToCoolSummary": {
            "totalObjectsCount": 0,
            "successCount": 0,
            "errorList": ""
        },
        "tierToArchiveSummary": {
            "totalObjectsCount": 0,
            "successCount": 0,
            "errorList": ""
        }
    },
    "dataVersion": "1",
    "metadataVersion": "1"
}

Proprietà dell'evento

Un evento presenta i seguenti dati di primo livello:

Proprietà Type Descrzione
topic string Percorso completo della risorsa all'origine evento. Questo campo non è scrivibile. Questo valore viene specificato da Griglia di eventi.
subject string Percorso definito dall'editore all'oggetto dell'evento.
eventType string Uno dei tipi di evento registrati per l'origine evento.
eventTime string Ora di generazione dell'evento in base all'ora UTC del provider.
id string Identificatore univoco per l'evento.
data oggetto Dati relativi all'evento di archiviazione BLOB.
dataVersion string Versione dello schema dell'oggetto dati. La versione dello schema è definita dall'origine di pubblicazione.
metadataVersion string Versione dello schema dei metadati dell'evento. Lo schema delle proprietà di primo livello è definito da Griglia di eventi. Questo valore viene specificato da Griglia di eventi.

Di seguito sono elencate le proprietà dell'oggetto dati:

Proprietà Type Descrzione
api string L'operazione che ha attivato l'evento.
clientRequestId string ID richiesta fornito dal client per l'operazione dell'API di archiviazione. Questo ID può essere usato per correlare ai log di diagnostica Archiviazione di Azure usando il campo "client-request-id" nei log e può essere fornito nelle richieste client usando l'intestazione "x-ms-client-request-id". Vedere Log Format (Formato del log).
requestId string ID richiesta generato dal servizio per l'operazione dell'API di archiviazione. Può essere usato per la correlazione ai log di diagnostica di Archiviazione di Azure usando il campo "request-id-header" nei log e viene restituito dall'avvio di una chiamata API nell'intestazione 'x-ms-request-id'. Vedere Log Format (Formato del log).
eTag string Valore che è possibile usare per eseguire le operazioni in modo condizionale.
contentType string Il tipo di contenuto specificato per il BLOB.
contentLength integer La dimensione del BLOB in byte.
blobType string Il tipo di BLOB. I valori validi sono "BlockBlob" o "PageBlob".
contentOffset number Offset in byte di un'operazione di scrittura eseguita nel punto in cui l'applicazione che attiva gli eventi ha completato la scrittura nel file.
Viene visualizzato solo per gli eventi attivati sugli account di archiviazione BLOB con uno spazio dei nomi gerarchico.
destinationUrl string URL del file che esisterà al termine dell'operazione. Ad esempio, se un file viene rinominato, la destinationUrl proprietà contiene l'URL del nuovo nome file.
Viene visualizzato solo per gli eventi attivati sugli account di archiviazione BLOB con uno spazio dei nomi gerarchico.
sourceUrl string URL del file esistente prima del termine dell'operazione. Ad esempio, se un file viene rinominato, sourceUrl contiene l'URL del nome file originale prima dell'operazione di ridenominazione.
Viene visualizzato solo per gli eventi attivati sugli account di archiviazione BLOB con uno spazio dei nomi gerarchico.
url string Percorso del BLOB.
Se il client usa un'API REST BLOB, l'URL ha questa struttura: <storage-account-name>.blob.core.windows.net\<container-name>\<file-name>.
Se il client usa un'API REST di Data Lake Archiviazione, l'URL ha questa struttura: <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>.
recursive string True per eseguire l'operazione su tutte le directory figlio; in caso contrario False, .
Viene visualizzato solo per gli eventi attivati sugli account di archiviazione BLOB con uno spazio dei nomi gerarchico.
sequencer string Valore stringa opaca che rappresenta la sequenza logica di eventi per qualsiasi nome di BLOB specifico. Gli utenti possono usare il confronto tra stringhe standard per comprendere la sequenza relativa di due eventi sullo stesso nome di BLOB.
identity string Valore stringa che rappresenta l'identità associata all'evento. Per SFTP, si tratta del nome utente locale.
storageDiagnostics oggetto Dati di diagnostica occasionalmente inclusi dal servizio Archiviazione di Azure. Quando è presente, questa proprietà deve essere ignorata dai consumer di eventi.

Esercitazioni e procedure

Posizione Descrizione
Guida introduttiva: indirizzare gli eventi di archiviazione BLOB a un endpoint Web personalizzato con l'interfaccia della riga di comando di Azure Illustra come usare l'interfaccia della riga di comando di Azure per inviare gli eventi di archiviazione BLOB a un webhook.
Guida introduttiva: indirizzare gli eventi di archiviazione BLOB a un endpoint Web personalizzato con PowerShell Illustra come usare PowerShell per inviare gli eventi di archiviazione BLOB a un webhook.
Guida introduttiva: creare e instradare eventi di archiviazione BLOB con il portale di Azure Illustra come usare il portale per inviare gli eventi di archiviazione BLOB a un webhook.
Interfaccia della riga di comando di Azure: sottoscrivere eventi per un account di archiviazione BLOB Script di esempio che esegue la sottoscrizione a un evento per un account di archiviazione BLOB. Invia l'evento a un webhook.
PowerShell: sottoscrivere eventi per un account di archiviazione BLOB Script di esempio che esegue la sottoscrizione a un evento per un account di archiviazione BLOB. Invia l'evento a un webhook.
Modello di Resource Manager: creare un archivio e una sottoscrizione BLOB Consente di distribuire un account di archiviazione BLOB di Azure e di sottoscrivere eventi per quell'account di archiviazione. Invia eventi a un webhook.
Panoramica: reazione a eventi di Archiviazione BLOB di Azure Panoramica dell'integrazione dell'archivio BLOB con Griglia di eventi.

Passaggi successivi