Delen via

Azure Blob Storage als Event Grid-bron

  • Artikel

Dit artikel bevat de eigenschappen en het schema voor blobopslag-gebeurtenissen. Zie het Gebeurtenisschema van Azure Event Grid voor een inleiding tot gebeurtenisschema's. U krijgt ook een lijst met quickstarts en zelfstudies voor het gebruik van Azure Blob Storage als gebeurtenisbron.

Notitie

Alleen opslagaccounts van het type StorageV2 (algemeen gebruik v2), BlockBlobStorage en BlobStorage ondersteunen gebeurtenisintegratie. Opslag (algemeen gebruik v1) biedt geen ondersteuning voor integratie met Event Grid.

Beschikbare gebeurtenistypen

Blob Storage-gebeurtenissen

Deze gebeurtenissen worden geactiveerd wanneer een client een blob maakt, vervangt of verwijdert door Blob REST API's aan te roepen.

Notitie

De $logs containers en $blobchangefeed containers zijn niet geïntegreerd met Event Grid. Activiteiten in deze containers genereren dus geen gebeurtenissen. Als u ook het dfs-eindpunt (abfss://URI) gebruikt voor accounts met niet-hiërarchische naamruimte, worden er geen gebeurtenissen gegenereerd, maar genereert het blob-eindpunt (wasb:// URI) gebeurtenissen.

Gebeurtenisnaam Beschrijving
Microsoft.Storage.BlobCreated Geactiveerd wanneer een blob wordt gemaakt of vervangen.
Deze gebeurtenis wordt geactiveerd wanneer clients de PutBlob, PutBlockListof CopyBlob bewerkingen gebruiken die beschikbaar zijn in de Blob REST API en wanneer de blok-blob volledig wordt doorgevoerd.
Als clients de CopyBlob bewerking gebruiken voor accounts waarvoor de hiërarchische naamruimtefunctie is ingeschakeld, werkt de CopyBlob bewerking iets anders. In dat geval wordt de gebeurtenis Microsoft.Storage.BlobCreated geactiveerd wanneer de CopyBlob bewerking wordt gestart en niet wanneer de blok-blob volledig is doorgevoerd.
Microsoft.Storage.BlobDeleted Geactiveerd wanneer een blob wordt verwijderd.
Deze gebeurtenis wordt geactiveerd wanneer clients de DeleteBlob bewerking aanroepen die beschikbaar is in de Blob REST API.
Microsoft.Storage.BlobTierChanged Geactiveerd wanneer de blob-toegangslaag wordt gewijzigd. Wanneer clients de Set Blob Tier bewerking aanroepen die beschikbaar is in de Blob REST API, wordt deze gebeurtenis geactiveerd nadat de laagwijziging is voltooid.
Microsoft.Storage.AsyncOperationInitiated Geactiveerd wanneer een bewerking met het verplaatsen of kopiëren van gegevens uit het archief naar dynamische of statische lagen wordt gestart. Deze gebeurtenis wordt geactiveerd wanneer clients de Set Blob Tier API aanroepen om een blob te verplaatsen van archieflaag naar dynamische of statische laag, of wanneer clients de Copy Blob API aanroepen om gegevens van een blob in de archieflaag te kopiëren naar een blob in de dynamische of statische laag.

Voorbeeld van gebeurtenissen

Microsoft.Storage.BlobCreated-gebeurtenis

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/test-container/blobs/new-file.txt",
  "type": "Microsoft.Storage.BlobCreated",
  "time": "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",
    "accessTier": "Default",
    "url": "https://my-storage-account.blob.core.windows.net/testcontainer/new-file.txt",
    "sequencer": "00000000000004420000000000028963",
    "storageDiagnostics": {
      "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "specversion": "1.0"
}]

Gebeurtenis Microsoft.Storage.BlobDeleted

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/file-to-delete.txt",
  "type": "Microsoft.Storage.BlobDeleted",
  "time": "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",
    "accessTier": "Default",
    "url": "https://my-storage-account.blob.core.windows.net/testcontainer/file-to-delete.txt",
    "sequencer": "0000000000000281000000000002F5CA",
    "storageDiagnostics": {
      "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.BlobTierChanged-gebeurtenis

{
	"source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
	"subject": "/blobServices/default/containers/testcontainer/blobs/Auto.jpg",
	"type": "Microsoft.Storage.BlobTierChanged",
	"time": "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",
		"accessTier": "Archive",
		"previousTier": "Cool",
		"url": "https://my-storage-account.blob.core.windows.net/testcontainer/Auto.jpg",
		"sequencer": "000000000000000000000000000089A4000000000018d6ea",
		"storageDiagnostics": {
			"batchId": "3418f7a9-7006-0014-00f6-406dc6000000"
		}
	},
  "specversion": "1.0"
}

Microsoft.Storage.AsyncOperationInitiated-gebeurtenis

{
	"source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
	"subject": "/blobServices/default/containers/testcontainer/blobs/00000.avro",
	"type": "Microsoft.Storage.AsyncOperationInitiated",
	"time": "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"
		}
	},
	"specversion": "1.0"
}

Data Lake Storage Gen 2-gebeurtenissen

Deze gebeurtenissen worden geactiveerd als u een hiërarchische naamruimte inschakelt voor het opslagaccount en clients azure Data Lake Storage Gen2 REST API's gebruiken. Zie Inleiding tot Azure Data Lake Storage Gen2 voor meer informatie over Azure Data Lake Storage Gen2.

Gebeurtenisnaam Beschrijving
Microsoft.Storage.BlobCreated Geactiveerd wanneer een blob wordt gemaakt of vervangen.
Deze gebeurtenis wordt geactiveerd wanneer clients gebruikmaken van de CreateFile en FlushWithClose bewerkingen die beschikbaar zijn in de REST API van Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobDeleted Geactiveerd wanneer een blob wordt verwijderd.
Deze gebeurtenis wordt ook geactiveerd wanneer clients de DeleteFile bewerking aanroepen die beschikbaar is in de REST API van Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobRenamed Geactiveerd wanneer de naam van een blob wordt gewijzigd.
Deze gebeurtenis wordt geactiveerd wanneer clients de RenameFile bewerking gebruiken die beschikbaar is in de REST API van Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryCreated Geactiveerd wanneer een map wordt gemaakt.
Deze gebeurtenis wordt geactiveerd wanneer clients de CreateDirectory bewerking gebruiken die beschikbaar is in de REST API van Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryRenamed Geactiveerd wanneer de naam van een map wordt gewijzigd.
Deze gebeurtenis wordt geactiveerd wanneer clients de RenameDirectory bewerking gebruiken die beschikbaar is in de REST API van Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryDeleted Geactiveerd wanneer een map wordt verwijderd.
Deze gebeurtenis wordt geactiveerd wanneer clients de DeleteDirectory bewerking gebruiken die beschikbaar is in de REST API van Azure Data Lake Storage Gen2.

Notitie

Als u voor Azure Data Lake Storage Gen2 ervoor wilt zorgen dat de gebeurtenis Microsoft.Storage.BlobCreated alleen wordt geactiveerd wanneer een blok-blob volledig is doorgevoerd, filtert u de gebeurtenis voor de FlushWithClose REST API-aanroep. Met deze API-aanroep wordt de gebeurtenis Microsoft.Storage.BlobCreated pas geactiveerd nadat gegevens volledig zijn doorgevoerd in een blok-blob. Zie Gebeurtenissen filteren voor Event Grid voor meer informatie over het maken van een filter.

Voorbeeld van gebeurtenissen

Microsoft.Storage.BlobCreated-gebeurtenis (Data Lake Storage Gen2)

Als het blob-opslagaccount een hiërarchische naamruimte heeft, lijken de gegevens op het vorige voorbeeld, met uitzondering van deze wijzigingen:

  • De data.api sleutel is ingesteld op de tekenreeks CreateFile of FlushWithClose.
  • De contentOffset sleutel wordt opgenomen in de gegevensset.

Notitie

Als toepassingen de PutBlockList bewerking gebruiken om een nieuwe blob naar het account te uploaden, bevatten de gegevens deze wijzigingen niet.

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/new-file.txt",
  "type": "Microsoft.Storage.BlobCreated",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.BlobDeleted-gebeurtenis (Data Lake Storage Gen2)

Als het blob-opslagaccount een hiërarchische naamruimte heeft, lijken de gegevens op het vorige voorbeeld, met uitzondering van deze wijzigingen:

  • De data.api sleutel is ingesteld op de tekenreeks DeleteFile.
  • De url sleutel bevat het pad dfs.core.windows.net.

Notitie

Als toepassingen de DeleteBlob bewerking gebruiken om een blob uit het account te verwijderen, bevatten de gegevens deze wijzigingen niet.

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/file-to-delete.txt",
  "type": "Microsoft.Storage.BlobDeleted",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.BlobRenamed-gebeurtenis (Data Lake Storage Gen2)

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/my-renamed-file.txt",
  "type": "Microsoft.Storage.BlobRenamed",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.DirectoryCreated-gebeurtenis (Data Lake Storage Gen2)

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/my-new-directory",
  "type": "Microsoft.Storage.DirectoryCreated",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.DirectoryRenamed-gebeurtenis (Data Lake Storage Gen2)

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/my-renamed-directory",
  "type": "Microsoft.Storage.DirectoryRenamed",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.DirectoryDeleted-gebeurtenis (Data Lake Storage Gen2)

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/my-file-system/blobs/directory-to-delete",
  "type": "Microsoft.Storage.DirectoryDeleted",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

SFTP-gebeurtenissen

Deze gebeurtenissen worden geactiveerd als u een hiërarchische naamruimte voor het opslagaccount inschakelt en clients SFTP-API's gebruiken. Zie SSH File Transfer Protocol (SFTP) in Azure Blob Storage voor meer informatie over SFTP-ondersteuning voor Azure Blob Storage.

Gebeurtenisnaam Beschrijving
Microsoft.Storage.BlobCreated Geactiveerd wanneer een blob wordt gemaakt of overschreven.
Deze gebeurtenis wordt geactiveerd wanneer clients de put bewerking gebruiken, die overeenkomt met de SftpCreate api's.SftpCommit Er wordt een lege blob gemaakt wanneer het bestand wordt geopend en de geüploade inhoud wordt doorgevoerd wanneer het bestand wordt gesloten. Als de SFTP Resumable Uploads preview-functie is ingeschakeld, worden sommige SftpWrite gebeurtenissen ook geactiveerd tijdens het uploaden.
Microsoft.Storage.BlobDeleted Geactiveerd wanneer een blob wordt verwijderd.
Deze gebeurtenis wordt ook geactiveerd wanneer clients de rm bewerking aanroepen, die overeenkomt met de SftpRemove API.
Microsoft.Storage.BlobRenamed Geactiveerd wanneer de naam van een blob wordt gewijzigd.
Deze gebeurtenis wordt geactiveerd wanneer clients de rename bewerking op bestanden gebruiken, die overeenkomt met de SftpRename API.
Microsoft.Storage.DirectoryCreated Geactiveerd wanneer een map wordt gemaakt.
Deze gebeurtenis wordt geactiveerd wanneer clients de mkdir bewerking gebruiken, die overeenkomt met de SftpMakeDir API.
Microsoft.Storage.DirectoryRenamed Geactiveerd wanneer de naam van een map wordt gewijzigd.
Deze gebeurtenis wordt geactiveerd wanneer clients de rename bewerking in een map gebruiken, die overeenkomt met de SftpRename API.
Microsoft.Storage.DirectoryDeleted Geactiveerd wanneer een map wordt verwijderd.
Deze gebeurtenis wordt geactiveerd wanneer clients de rmdir bewerking gebruiken, die overeenkomt met de SftpRemoveDir API.

Voorbeeld van gebeurtenissen

Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis naar geabonneerde eindpunten. Deze sectie bevat een voorbeeld van hoe die gegevens eruit zouden zien voor elke blobopslag-gebeurtenis.

Microsoft.Storage.BlobCreated-gebeurtenis (SFTP)

Als het blob-opslagaccount SFTP gebruikt om een blob te maken of te overschrijven, lijken de gegevens op het vorige voorbeeld, met uitzondering van deze wijzigingen:

  • De dataVersion sleutel wordt ingesteld op een waarde van 3.

  • De data.api sleutel is ingesteld op de tekenreeks SftpCreate, SftpWriteof SftpCommit.

  • De clientRequestId sleutel is niet inbegrepen.

  • De contentType sleutel is ingesteld op application/octet-stream.

  • De contentOffset sleutel wordt opgenomen in de gegevensset.

  • De identity sleutel wordt opgenomen in de gegevensset. Dit komt overeen met de lokale gebruiker die wordt gebruikt voor SFTP-verificatie.

Notitie

SFTP-uploads genereren twee gebeurtenissen. Een SftpCreate voor een eerste lege blob die is gemaakt bij het openen van het bestand en één SftpCommit wanneer de bestandsinhoud wordt doorgevoerd aan het einde van de upload. Als de SFTP Resumable Uploads preview-functie is ingeschakeld, worden sommige SftpWrite gebeurtenissen ook geactiveerd tijdens het uploaden.

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/new-file.txt",
  "type": "Microsoft.Storage.BlobCreated",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.BlobDeleted-gebeurtenis (SFTP)

Als het blob-opslagaccount SFTP gebruikt om een blob te verwijderen, lijken de gegevens op het vorige voorbeeld, met uitzondering van deze wijzigingen:

  • De dataVersion sleutel wordt ingesteld op een waarde van 2.

  • De data.api sleutel is ingesteld op de tekenreeks SftpRemove.

  • De clientRequestId sleutel is niet inbegrepen.

  • De contentType sleutel is ingesteld op application/octet-stream.

  • De identity sleutel wordt opgenomen in de gegevensset. Dit komt overeen met de lokale gebruiker die wordt gebruikt voor SFTP-verificatie.

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/new-file.txt",
  "type": "Microsoft.Storage.BlobDeleted",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.BlobRenamed-gebeurtenis (SFTP)

Als het blob-opslagaccount SFTP gebruikt om de naam van een blob te wijzigen, lijken de gegevens op het vorige voorbeeld, met uitzondering van deze wijzigingen:

  • De data.api sleutel is ingesteld op de tekenreeks SftpRename.

  • De clientRequestId sleutel is niet inbegrepen.

  • De identity sleutel wordt opgenomen in de gegevensset. Dit komt overeen met de lokale gebruiker die wordt gebruikt voor SFTP-verificatie.

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/my-renamed-file.txt",
  "type": "Microsoft.Storage.BlobRenamed",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.DirectoryCreated-gebeurtenis (SFTP)

Als het Blob Storage-account SFTP gebruikt om een map te maken, lijken de gegevens op het vorige voorbeeld, met uitzondering van deze wijzigingen:

  • De dataVersion sleutel wordt ingesteld op een waarde van 2.

  • De data.api sleutel is ingesteld op de tekenreeks SftpMakeDir.

  • De clientRequestId sleutel is niet inbegrepen.

  • De identity sleutel wordt opgenomen in de gegevensset. Dit komt overeen met de lokale gebruiker die wordt gebruikt voor SFTP-verificatie.

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/my-new-directory",
  "type": "Microsoft.Storage.DirectoryCreated",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.DirectoryRenamed-gebeurtenis (SFTP)

Als het blob-opslagaccount SFTP gebruikt om de naam van een map te wijzigen, lijken de gegevens op het vorige voorbeeld, met uitzondering van deze wijzigingen:

  • De data.api sleutel is ingesteld op de tekenreeks SftpRename.

  • De clientRequestId sleutel is niet inbegrepen.

  • De identity sleutel wordt opgenomen in de gegevensset. Dit komt overeen met de lokale gebruiker die wordt gebruikt voor SFTP-verificatie.

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/my-renamed-directory",
  "type": "Microsoft.Storage.DirectoryRenamed",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Microsoft.Storage.DirectoryDeleted-gebeurtenis (SFTP)

Als het blob-opslagaccount SFTP gebruikt om een map te verwijderen, lijken de gegevens op het vorige voorbeeld, met uitzondering van deze wijzigingen:

  • De data.api sleutel is ingesteld op de tekenreeks SftpRemoveDir.

  • De clientRequestId sleutel is niet inbegrepen.

  • De identity sleutel wordt opgenomen in de gegevensset. Dit komt overeen met de lokale gebruiker die wordt gebruikt voor SFTP-verificatie.

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
  "subject": "/blobServices/default/containers/testcontainer/blobs/directory-to-delete",
  "type": "Microsoft.Storage.DirectoryDeleted",
  "time": "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"
    }
  },
  "specversion": "1.0"
}]

Deze gebeurtenissen worden geactiveerd wanneer de acties die door een beleid zijn gedefinieerd, worden uitgevoerd.

Gebeurtenisnaam Beschrijving
Microsoft.Storage.BlobInventoryPolicyCompleted Geactiveerd wanneer de inventarisatieuitvoering is voltooid voor een regel die een inventarisbeleid heeft gedefinieerd. Deze gebeurtenis treedt ook op als de inventarisatieuitvoering mislukt met een gebruikersfout voordat deze wordt uitgevoerd. Een ongeldig beleid of een fout die optreedt wanneer een doelcontainer niet aanwezig is, activeert de gebeurtenis.
Microsoft.Storage.LifecyclePolicyCompleted Geactiveerd wanneer de acties die zijn gedefinieerd door een levenscyclusbeheerbeleid, worden uitgevoerd.

Voorbeeld van gebeurtenissen

Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis naar geabonneerde eindpunten. Deze sectie bevat een voorbeeld van hoe die gegevens eruit zouden zien voor elke blobopslag-gebeurtenis.

Microsoft.Storage.BlobInventoryPolicyCompleted-gebeurtenis

{
  "source": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/BlobInventory/providers/Microsoft.EventGrid/topics/BlobInventoryTopic",
  "subject": "BlobDataManagement/BlobInventory",
  "type": "Microsoft.Storage.BlobInventoryPolicyCompleted",
  "time": "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"
  },
  "specversion": "1.0"
}

Microsoft.Storage.LifecyclePolicyCompleted-gebeurtenis

{
    "source": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/contosoresourcegroup/providers/Microsoft.Storage/storageAccounts/contosostorageaccount",
    "subject": "BlobDataManagement/LifeCycleManagement/SummaryReport",
    "type": "Microsoft.Storage.LifecyclePolicyCompleted",
    "time": "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": ""
        },
        "tierToColdSummary": {
            "totalObjectsCount": 0,
            "successCount": 0,
            "errorList": ""
        },
        "tierToArchiveSummary": {
            "totalObjectsCount": 0,
            "successCount": 0,
            "errorList": ""
        }
    },
    "specversion": "1.0"
}

Eigenschappen van gebeurtenis

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap Type Omschrijving
source tekenreeks Volledig resourcepad naar de gebeurtenisbron. Dit veld kan niet worden geschreven. Event Grid biedt deze waarde.
subject tekenreeks Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
type tekenreeks Een van de geregistreerde gebeurtenistypen voor deze gebeurtenisbron.
time tekenreeks Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
id tekenreeks Unieke id voor de gebeurtenis.
data object Blob Storage-gebeurtenisgegevens.
specversion tekenreeks CloudEvents schemaspecificatieversie.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
api tekenreeks De bewerking die de gebeurtenis heeft geactiveerd.
clientRequestId tekenreeks een door de client verstrekte aanvraag-id voor de opslag-API-bewerking. Deze id kan worden gebruikt om te correleren met diagnostische logboeken van Azure Storage met behulp van het veld 'client-request-id' in de logboeken en kan worden opgegeven in clientaanvragen met behulp van de header 'x-ms-client-request-id'. Zie Logboekindeling.
requestId tekenreeks Door de service gegenereerde aanvraag-id voor de opslag-API-bewerking. Kan worden gebruikt om te correleren met diagnostische logboeken van Azure Storage met behulp van het veld request-id-header in de logboeken en wordt geretourneerd van de initiërende API-aanroep in de header 'x-ms-request-id'. Zie Logboekindeling.
eTag tekenreeks De waarde die u kunt gebruiken om bewerkingen voorwaardelijk uit te voeren.
contentType tekenreeks Het inhoudstype dat is opgegeven voor de blob.
contentLength geheel getal De grootte van de blob in bytes.
blobType tekenreeks Het type blob. Geldige waarden zijn 'BlockBlob' of 'PageBlob'.
accessTier tekenreeks De doellaag van de blob. Wordt alleen weergegeven voor de gebeurtenis BlobTierChanged.
previousTier tekenreeks De bronlaag van de blob. Wordt alleen weergegeven voor de gebeurtenis BlobTierChanged. Als de blob de laag uit het opslagaccount uitstelt, wordt dit veld niet weergegeven.
contentOffset Nummer De offset in bytes van een schrijfbewerking die is genomen op het moment waarop de gebeurtenistriggertoepassing het schrijven naar het bestand heeft voltooid.
Wordt alleen weergegeven voor gebeurtenissen die zijn geactiveerd in blobopslagaccounts met een hiërarchische naamruimte.
destinationUrl tekenreeks De URL van het bestand dat bestaat nadat de bewerking is voltooid. Als de naam van een bestand bijvoorbeeld is gewijzigd, bevat de destinationUrl eigenschap de URL van de nieuwe bestandsnaam.
Wordt alleen weergegeven voor gebeurtenissen die zijn geactiveerd in blobopslagaccounts met een hiërarchische naamruimte.
sourceUrl tekenreeks De URL van het bestand dat bestaat voordat de bewerking wordt uitgevoerd. Als de naam van een bestand bijvoorbeeld wordt gewijzigd, bevat de sourceUrl URL van de oorspronkelijke bestandsnaam voordat de naam van het bestand wordt gewijzigd.
Wordt alleen weergegeven voor gebeurtenissen die zijn geactiveerd in blobopslagaccounts met een hiërarchische naamruimte.
url tekenreeks Het pad naar de blob.
Als de client gebruikmaakt van een Blob REST API, heeft de URL deze structuur: <storage-account-name>.blob.core.windows.net\<container-name>\<file-name>.
Als de client gebruikmaakt van een Data Lake Storage REST API, heeft de URL deze structuur: <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>.
recursive tekenreeks True om de bewerking uit te voeren op alle onderliggende mappen; anders False.
Wordt alleen weergegeven voor gebeurtenissen die zijn geactiveerd in blobopslagaccounts met een hiërarchische naamruimte.
sequencer tekenreeks Een ondoorzichtige tekenreekswaarde die de logische reeks gebeurtenissen voor een bepaalde blobnaam vertegenwoordigt. Gebruikers kunnen standaardtekenreeksvergelijking gebruiken om inzicht te hebben in de relatieve volgorde van twee gebeurtenissen op dezelfde blobnaam.
identity tekenreeks Een tekenreekswaarde die de identiteit vertegenwoordigt die is gekoppeld aan de gebeurtenis. Voor SFTP is dit de lokale gebruikersnaam.
storageDiagnostics object Diagnostische gegevens worden af en toe opgenomen door de Azure Storage-service. Indien aanwezig, moet worden genegeerd door gebeurtenisgebruikers.

Zelfstudies en handleidingen

Title Beschrijving
Quickstart: Blob Storage-gebeurtenissen routeren naar een aangepast webeindpunt met Azure CLI Laat zien hoe u Azure CLI gebruikt om blobopslag-gebeurtenissen naar een WebHook te verzenden.
Quickstart: Blob Storage-gebeurtenissen routeren naar een aangepast webeindpunt met PowerShell Laat zien hoe u Azure PowerShell gebruikt om blobopslag-gebeurtenissen naar een WebHook te verzenden.
Quickstart: Blob Storage-gebeurtenissen maken en routeren met Azure Portal Laat zien hoe u de portal gebruikt om blobopslag-gebeurtenissen naar een WebHook te verzenden.
Azure CLI: abonneren op gebeurtenissen voor een Blob Storage-account Voorbeeldscript dat zich abonneert op een gebeurtenis voor een Blob Storage-account. De gebeurtenis wordt verzonden naar een WebHook.
PowerShell: abonneren op gebeurtenissen voor een Blob Storage-account Voorbeeldscript dat zich abonneert op een gebeurtenis voor een Blob Storage-account. De gebeurtenis wordt verzonden naar een WebHook.
Resource Manager-sjabloon: Blob-opslag en -abonnement maken Hiermee implementeert u een Azure Blob-opslagaccount en abonneert u zich op gebeurtenissen van die opslagaccount. Er worden gebeurtenissen naar een WebHook verzonden.
Overzicht: reageren op Blob Storage-gebeurtenissen Overzicht van het integreren van Blob Storage met Event Grid.

Volgende stappen