Azure Blob Storage som en Event Grid-källa

  • Artikel

Den här artikeln innehåller egenskaper och schema för bloblagringshändelser. En introduktion till händelsescheman finns i Händelseschema för Azure Event Grid. Du får också en lista över snabbstarter och självstudier för att använda Azure Blob Storage som händelsekälla.

Kommentar

Endast lagringskonton av typen StorageV2 (generell användning v2), BlockBlobStorage och BlobStorage stöder händelseintegrering. Lagring (generell användning v1) stöder inte integrering med Event Grid.

Tillgängliga händelsetyper

Blob Storage-händelser

Dessa händelser utlöses när en klient skapar, ersätter eller tar bort en blob genom att anropa BLOB REST API:er.

Kommentar

Containrarna $logs och $blobchangefeed är inte integrerade med Event Grid, så aktiviteten i dessa containrar genererar inte händelser. Om du använder dfs-slutpunkten (abfss://URI) för konton som inte är hierarkiska genereras inte händelser, men blobslutpunkten (wasb:// URI) genererar händelser.

Händelsenamn beskrivning
Microsoft.Storage.BlobSkapat Utlöses när en blob skapas eller ersätts.
Mer specifikt utlöses den här händelsen när klienter använder åtgärderna PutBlob, PutBlockListeller CopyBlob som är tillgängliga i BLOB REST-API: et och när blockbloben har checkats in helt.
Om klienter använder CopyBlob åtgärden på konton som har funktionen hierarkisk namnrymd aktiverad på sig, CopyBlob fungerar åtgärden lite annorlunda. I så fall utlöses händelsen Microsoft.Storage.BlobCreated när CopyBlob åtgärden initieras och inte när blockbloben har checkats in helt.
Microsoft.Storage.BlobDeleted Utlöses när en blob tas bort.
Mer specifikt utlöses den här händelsen när klienter anropar åtgärden DeleteBlob som är tillgänglig i Blob REST API.
Microsoft.Storage.BlobTierChanged Utlöses när blobåtkomstnivån ändras. När klienter anropar den Set Blob Tier åtgärd som är tillgänglig i BLOB REST API utlöses den här händelsen när nivåändringen har slutförts.
Microsoft.Storage.AsyncOperationInitiated Utlöses när en åtgärd som innebär att flytta eller kopiera data från arkivet till frekventa eller lågfrekventa nivåer initieras. Mer specifikt utlöses den här händelsen antingen när klienter anropar API:et Set Blob Tier för att flytta en blob från arkivnivå till frekvent eller lågfrekvent nivå, eller när klienter anropar API:et Copy Blob för att kopiera data från en blob på arkivnivån till en blob på den frekventa eller lågfrekventa nivån.

Exempelhändelser

Microsoft.Storage.BlobSkapad händelse

[{
  "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",
    "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"
}]

Microsoft.Storage.BlobDeleted-händelse

[{
  "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",
    "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-händelse

{
	"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",
		"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-händelse

{
	"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-händelser

Dessa händelser utlöses om du aktiverar ett hierarkiskt namnområde på lagringskontot och klienter använder REST-API:er för Azure Data Lake Storage Gen2. Mer information om Azure Data Lake Storage Gen2 finns i Introduktion till Azure Data Lake Storage Gen2.

Händelsenamn beskrivning
Microsoft.Storage.BlobSkapat Utlöses när en blob skapas eller ersätts.
Mer specifikt utlöses den här händelsen när klienter använder de CreateFile åtgärder och FlushWithClose som är tillgängliga i Rest-API:et för Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobDeleted Utlöses när en blob tas bort.
Mer specifikt utlöses även den här händelsen när klienter anropar den DeleteFile åtgärd som är tillgänglig i Rest-API:et för Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobRenamed Utlöses när en blob byter namn.
Mer specifikt utlöses den här händelsen när klienter använder den RenameFile åtgärd som är tillgänglig i Rest-API:et för Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectorySkapat Utlöses när en katalog skapas.
Mer specifikt utlöses den här händelsen när klienter använder den CreateDirectory åtgärd som är tillgänglig i Rest-API:et för Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryRenamed Utlöses när en katalog byter namn.
Mer specifikt utlöses den här händelsen när klienter använder den RenameDirectory åtgärd som är tillgänglig i Rest-API:et för Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryTa bort Utlöses när en katalog tas bort.
Mer specifikt utlöses den här händelsen när klienter använder den DeleteDirectory åtgärd som är tillgänglig i Rest-API:et för Azure Data Lake Storage Gen2.

Kommentar

För Azure Data Lake Storage Gen2 ska du filtrera händelsen för FlushWithClose REST API-anropet om du vill säkerställa att händelsen Microsoft.Storage.BlobCreated utlöses endast när en blockblob har checkats in helt. Det här API-anropet utlöser händelsen Microsoft.Storage.BlobCreated först när data har checkats in helt till en blockblob. Information om hur du skapar ett filter finns i Filtrera händelser för Event Grid.

Exempelhändelser

Microsoft.Storage.BlobCreated-händelse (Data Lake Storage Gen2)

Om bloblagringskontot har ett hierarkiskt namnområde ser data ut ungefär som i föregående exempel med undantag för dessa ändringar:

  • Nyckeln data.api är inställd på strängen CreateFile eller FlushWithClose.
  • Nyckeln contentOffset ingår i datauppsättningen.

Kommentar

Om program använder åtgärden PutBlockList för att ladda upp en ny blob till kontot innehåller inte data dessa ändringar.

[{
  "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-händelse (Data Lake Storage Gen2)

Om bloblagringskontot har ett hierarkiskt namnområde ser data ut ungefär som i föregående exempel med undantag för dessa ändringar:

  • Nyckeln data.api är inställd på strängen DeleteFile.
  • Nyckeln url innehåller sökvägen dfs.core.windows.net.

Kommentar

Om program använder åtgärden DeleteBlob för att ta bort en blob från kontot innehåller inte data dessa ändringar.

[{
  "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-händelse (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.DirectorySkapad händelse (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-händelse (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-händelse (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-händelser

Dessa händelser utlöses om du aktiverar ett hierarkiskt namnområde på lagringskontot och klienter använder SFTP-API:er. Mer information om SFTP-stöd för Azure Blob Storage finns i SSH File Transfer Protocol (SFTP) i Azure Blob Storage.

Händelsenamn beskrivning
Microsoft.Storage.BlobSkapat Utlöses när en blob skapas eller skrivs över.
Mer specifikt utlöses den här händelsen när klienter använder åtgärden put , vilket motsvarar API:erna SftpCreate och SftpCommit . En tom blob skapas när filen öppnas och det uppladdade innehållet checkas in när filen stängs.
Microsoft.Storage.BlobDeleted Utlöses när en blob tas bort.
Mer specifikt utlöses även den här händelsen när klienter anropar rm åtgärden, vilket motsvarar API:et SftpRemove .
Microsoft.Storage.BlobRenamed Utlöses när en blob byter namn.
Mer specifikt utlöses den här händelsen när klienter använder rename åtgärden på filer, vilket motsvarar API:et SftpRename .
Microsoft.Storage.DirectorySkapat Utlöses när en katalog skapas.
Mer specifikt utlöses den här händelsen när klienter använder åtgärden mkdir , vilket motsvarar API:et SftpMakeDir .
Microsoft.Storage.DirectoryRenamed Utlöses när en katalog byter namn.
Mer specifikt utlöses den här händelsen när klienter använder rename åtgärden i en katalog, vilket motsvarar API:et SftpRename .
Microsoft.Storage.DirectoryTa bort Utlöses när en katalog tas bort.
Mer specifikt utlöses den här händelsen när klienter använder åtgärden rmdir , vilket motsvarar API:et SftpRemoveDir .

Exempelhändelser

När en händelse utlöses skickar Event Grid-tjänsten data om händelsen till den prenumererande slutpunkten. Det här avsnittet innehåller ett exempel på hur dessa data skulle se ut för varje bloblagringshändelse.

Microsoft.Storage.BlobCreated-händelse (SFTP)

Om bloblagringskontot använder SFTP för att skapa eller skriva över en blob ser data ut ungefär som i föregående exempel med undantag för dessa ändringar:

  • Nyckeln dataVersion är inställd på värdet 3.

  • Nyckeln data.api är inställd på strängen SftpCreate eller SftpCommit.

  • Nyckeln clientRequestId ingår inte.

  • Nyckeln contentType är inställd på application/octet-stream.

  • Nyckeln contentOffset ingår i datauppsättningen.

  • Nyckeln identity ingår i datauppsättningen. Detta motsvarar den lokala användare som används för SFTP-autentisering.

Kommentar

SFTP-uppladdningar genererar två händelser. En SftpCreate för en första tom blob som skapas när filen öppnas och en SftpCommit när filinnehållet skrivs.

[{
  "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-händelse (SFTP)

Om bloblagringskontot använder SFTP för att ta bort en blob ser data ut ungefär som i föregående exempel med undantag för dessa ändringar:

  • Nyckeln dataVersion är inställd på värdet 2.

  • Nyckeln data.api är inställd på strängen SftpRemove.

  • Nyckeln clientRequestId ingår inte.

  • Nyckeln contentType är inställd på application/octet-stream.

  • Nyckeln identity ingår i datauppsättningen. Detta motsvarar den lokala användare som används för SFTP-autentisering.

[{
  "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-händelse (SFTP)

Om bloblagringskontot använder SFTP för att byta namn på en blob ser data ut ungefär som i föregående exempel med undantag för dessa ändringar:

  • Nyckeln data.api är inställd på strängen SftpRename.

  • Nyckeln clientRequestId ingår inte.

  • Nyckeln identity ingår i datauppsättningen. Detta motsvarar den lokala användare som används för SFTP-autentisering.

[{
  "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.DirectorySkapad händelse (SFTP)

Om bloblagringskontot använder SFTP för att skapa en katalog ser data ut ungefär som i föregående exempel med undantag för dessa ändringar:

  • Nyckeln dataVersion är inställd på värdet 2.

  • Nyckeln data.api är inställd på strängen SftpMakeDir.

  • Nyckeln clientRequestId ingår inte.

  • Nyckeln identity ingår i datauppsättningen. Detta motsvarar den lokala användare som används för SFTP-autentisering.

[{
  "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-händelse (SFTP)

Om bloblagringskontot använder SFTP för att byta namn på en katalog ser data ut ungefär som i föregående exempel med undantag för dessa ändringar:

  • Nyckeln data.api är inställd på strängen SftpRename.

  • Nyckeln clientRequestId ingår inte.

  • Nyckeln identity ingår i datauppsättningen. Detta motsvarar den lokala användare som används för SFTP-autentisering.

[{
  "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-händelse (SFTP)

Om bloblagringskontot använder SFTP för att ta bort en katalog ser data ut ungefär som i föregående exempel med undantag för dessa ändringar:

  • Nyckeln data.api är inställd på strängen SftpRemoveDir.

  • Nyckeln clientRequestId ingår inte.

  • Nyckeln identity ingår i datauppsättningen. Detta motsvarar den lokala användare som används för SFTP-autentisering.

[{
  "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"
}]

Dessa händelser utlöses när de åtgärder som definieras av en princip utförs.

Händelsenamn beskrivning
Microsoft.Storage.BlobInventoryPolicyCompleted Utlöses när inventeringskörningen slutförs för en regel som har definierat en inventeringsprincip. Den här händelsen inträffar också om inventeringskörningen misslyckas med ett användarfel innan den börjar köras. Till exempel utlöser en ogiltig princip eller ett fel som uppstår när en målcontainer inte finns händelsen.
Microsoft.Storage.LifecyclePolicyCompleted Utlöses när de åtgärder som definieras av en livscykelhanteringsprincip utförs.

Exempelhändelser

När en händelse utlöses skickar Event Grid-tjänsten data om händelsen till den prenumererande slutpunkten. Det här avsnittet innehåller ett exempel på hur dessa data skulle se ut för varje bloblagringshändelse.

Microsoft.Storage.BlobInventoryPolicyCompleted-händelse

{
  "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-händelse

{
    "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": ""
        },
        "tierToArchiveSummary": {
            "totalObjectsCount": 0,
            "successCount": 0,
            "errorList": ""
        }
    },
    "specversion": "1.0"
}

Händelseegenskaper

En händelse har följande data på den översta nivån:

Property Type Description
source sträng Fullständig resurssökväg till händelsekällan. Det här fältet kan inte skrivas. Event Grid ger det här värdet.
subject sträng Utgivardefinierad sökväg till händelseobjektet.
type sträng En av de registrerade händelsetyperna för den här händelsekällan.
time sträng Den tid då händelsen genereras baserat på leverantörens UTC-tid.
id sträng Unik identifierare för händelsen.
data objekt Händelsedata för Blob Storage.
specversion sträng CloudEvents schemaspecifikationsversion.

Dataobjektet har följande egenskaper:

Property Type Description
api sträng Åtgärden som utlöste händelsen.
clientRequestId sträng ett begärande-ID som tillhandahålls av klienten för lagrings-API-åtgärden. Det här ID:t kan användas för att korrelera med Azure Storage-diagnostikloggar med hjälp av fältet "client-request-id" i loggarna och kan anges i klientbegäranden med rubriken "x-ms-client-request-id". Se Loggformat.
requestId sträng Tjänstgenererat begärande-ID för lagrings-API-åtgärden. Kan användas för att korrelera till Azure Storage-diagnostikloggar med hjälp av fältet "request-id-header" i loggarna och returneras från att API-anropet initieras i rubriken "x-ms-request-id". Se Loggformat.
eTag sträng Det värde som du kan använda för att köra åtgärder villkorligt.
contentType sträng Den innehållstyp som angetts för bloben.
contentLength integer Storleken på bloben i byte.
blobType sträng Typen av blob. Giltiga värden är antingen "BlockBlob" eller "PageBlob".
contentOffset Nummer Förskjutningen i byte av en skrivåtgärd som utfördes vid den tidpunkt då det händelseutlösande programmet slutförde skrivning till filen.
Visas endast för händelser som utlöses på bloblagringskonton som har ett hierarkiskt namnområde.
destinationUrl sträng Url:en för filen som ska finnas när åtgärden har slutförts. Om en fil till exempel har bytt namn destinationUrl innehåller egenskapen url:en för det nya filnamnet.
Visas endast för händelser som utlöses på bloblagringskonton som har ett hierarkiskt namnområde.
sourceUrl sträng URL:en för filen som finns innan åtgärden är klar. Om en fil till exempel har bytt namn sourceUrl innehåller den url:en för det ursprungliga filnamnet före namnbytet.
Visas endast för händelser som utlöses på bloblagringskonton som har ett hierarkiskt namnområde.
url sträng Sökvägen till bloben.
Om klienten använder ett REST-API för blobar har URL:en följande struktur: <storage-account-name>.blob.core.windows.net\<container-name>\<file-name>.
Om klienten använder ett REST-API för Data Lake Storage har URL:en följande struktur: <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>.
recursive sträng True för att köra åtgärden på alla underordnade kataloger; annars False.
Visas endast för händelser som utlöses på bloblagringskonton som har ett hierarkiskt namnområde.
sequencer sträng Ett täckande strängvärde som representerar den logiska sekvensen av händelser för ett visst blobnamn. Användare kan använda standardsträngjämförelse för att förstå den relativa sekvensen av två händelser med samma blobnamn.
identity sträng Ett strängvärde som representerar den identitet som är associerad med händelsen. För SFTP är detta det lokala användarnamnet.
storageDiagnostics objekt Diagnostikdata ingår ibland i Azure Storage-tjänsten. När detta är närvarande bör ignoreras av händelsekonsumenter.

Självstudier och instruktioner

Title Description
Snabbstart: Dirigera Blob Storage-händelser till en anpassad webbslutpunkt med Azure CLI Visar hur du använder Azure CLI för att skicka bloblagringshändelser till en WebHook.
Snabbstart: Dirigera Blob Storage-händelser till en anpassad webbslutpunkt med PowerShell Visar hur du använder Azure PowerShell för att skicka bloblagringshändelser till en WebHook.
Snabbstart: Skapa och dirigera Blob Storage-händelser med Azure-portalen Visar hur du använder portalen för att skicka bloblagringshändelser till en WebHook.
Azure CLI: Prenumerera på händelser för ett Blob Storage-konto Exempelskript som prenumererar på händelsen för ett Blob Storage-konto. Händelsen skickas till en WebHook.
PowerShell: prenumerera på händelser för ett Blob Storage-konto Exempelskript som prenumererar på händelsen för ett Blob Storage-konto. Händelsen skickas till en WebHook.
Resource Manager-mall: Skapa Blob Storage och prenumeration Distribuerar ett Azure Blob storage-konto och prenumererar på händelser för detta lagringskonto. Den skickar händelser till en WebHook.
Översikt: reagera på Blob Storage-händelser Översikt över integrering av Blob Storage med Event Grid.

Nästa steg