Az Azure Blob Storage mint Event Grid-forrás
Ez a cikk a blobtároló-események tulajdonságait és sémáját ismerteti. Az eseménysémákról az Azure Event Grid eseményséma című témakörben olvashat. Emellett felsorolja az Azure Blob Storage eseményforrásként való használatához használható rövid útmutatókat és oktatóanyagokat.
Feljegyzés
Csak a StorageV2 (általános célú v2), a BlockBlobStorage és a BlobStorage típusú tárfiókok támogatják az eseményintegrációt. A Storage (általános célú v1) nem támogatja az Event Grid-integrációt.
Elérhető eseménytípusok
Blob Storage-események
Ezek az események akkor aktiválódnak, amikor egy ügyfél Blob REST API-k meghívásával hoz létre, cserél vagy töröl egy blobot.
Feljegyzés
A $logs
tárolók és $blobchangefeed
a tárolók nincsenek integrálva az Event Griddel, így az ezekben a tárolókban végzett tevékenységek nem hoznak létre eseményeket. Az elosztott fájlrendszer végpontjának (abfss://URI)
nem hierarchikus névtérrel rendelkező fiókokhoz való használata nem hoz létre eseményeket, de a blobvégpont (wasb:// URI)
eseményeket fog generálni.
Esemény neve | Leírás |
---|---|
Microsoft.Storage.BlobCreated | Blob létrehozásakor vagy cseréjekor aktiválódik. Ez az esemény konkrétan akkor aktiválódik, ha az ügyfelek a PutBlob Blob REST API-ban elérhető, illetve CopyBlob a blokkblob teljes véglegesítésekor elérhető műveleteket PutBlockList használják. Ha az ügyfelek olyan fiókokon használják a CopyBlob műveletet, amelyeken engedélyezve van a hierarchikus névtér funkció, a CopyBlob művelet kissé másképp működik. Ebben az esetben a Microsoft.Storage.BlobCreated esemény akkor aktiválódik, amikor a CopyBlob műveletet elindítják , és nem a blokkblob teljes véglegesítésekor. |
Microsoft.Storage.BlobDeleted | Blob törlésekor aktiválódik. Ez az esemény akkor aktiválódik, amikor az ügyfelek meghívják a DeleteBlob Blob REST API-ban elérhető műveletet. |
Microsoft.Storage.BlobTierChanged | A blobelérési szint módosításakor aktiválódik. Amikor az ügyfelek meghívják a Set Blob Tier Blob REST API-ban elérhető műveletet, ez az esemény a rétegváltás befejeződése után aktiválódik. |
Microsoft.Storage.AsyncOperationInitiated | Akkor aktiválódik, ha az adatok az archívumból a gyakori vagy ritka elérésű rétegekbe való áthelyezését vagy másolását is magában foglalja. Ez az esemény akkor aktiválódik, ha az ügyfelek meghívják az Set Blob Tier API-t, hogy helyezzenek át egy blobot az archív szintről a gyakori vagy ritka elérésű szintre, vagy amikor az ügyfelek meghívják az Copy Blob API-t, hogy adatokat másoljanak az archív réteg egy blobjából egy gyakori vagy ritka elérésű rétegbeli blobba. |
Példaesemények
Microsoft.Storage.BlobCreated esemény
[{
"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"
}]
Microsoft.Storage.BlobDeleted esemény
[{
"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 esemény
{
"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 esemény
{
"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"
}
2. generációs Data Lake Storage-események
Ezek az események akkor aktiválódnak, ha engedélyezi a hierarchikus névteret a tárfiókon, és az ügyfelek az Azure Data Lake Storage Gen2 REST API-kat használják. További információ az Azure Data Lake Storage Gen2-ről: Bevezetés az Azure Data Lake Storage Gen2 használatába.
Esemény neve | Leírás |
---|---|
Microsoft.Storage.BlobCreated | Blob létrehozásakor vagy cseréjekor aktiválódik. Ez az esemény akkor aktiválódik, ha az ügyfelek az CreateFile Azure Data Lake Storage Gen2 REST API-ban elérhető és FlushWithClose elérhető műveleteket használják. |
Microsoft.Storage.BlobDeleted | Blob törlésekor aktiválódik. Ez az esemény akkor is aktiválódik, ha az ügyfelek meghívják az DeleteFile Azure Data Lake Storage Gen2 REST API-ban elérhető műveletet. |
Microsoft.Storage.BlobRenamed | A blob átnevezésekor aktiválódik. Ez az esemény akkor aktiválódik, ha az ügyfelek az RenameFile Azure Data Lake Storage Gen2 REST API-ban elérhető műveletet használják. |
Microsoft.Storage.DirectoryCreated | Könyvtár létrehozásakor aktiválódik. Ez az esemény akkor aktiválódik, ha az ügyfelek az CreateDirectory Azure Data Lake Storage Gen2 REST API-ban elérhető műveletet használják. |
Microsoft.Storage.DirectoryRenamed | A címtár átnevezésekor aktiválódik. Ez az esemény akkor aktiválódik, ha az ügyfelek az RenameDirectory Azure Data Lake Storage Gen2 REST API-ban elérhető műveletet használják. |
Microsoft.Storage.DirectoryDeleted | A címtár törlésekor aktiválódik. Ez az esemény akkor aktiválódik, ha az ügyfelek az DeleteDirectory Azure Data Lake Storage Gen2 REST API-ban elérhető műveletet használják. |
Feljegyzés
Az Azure Data Lake Storage Gen2 esetében, ha meg szeretné győződni arról, hogy a Microsoft.Storage.BlobCreated esemény csak akkor aktiválódik, ha egy blokkblob teljesen véglegesítve van, szűrje az eseményt a FlushWithClose
REST API-híváshoz. Ez az API-hívás csak akkor aktiválja a Microsoft.Storage.BlobCreated eseményt, ha az adatok teljes mértékben le lettek kötelezve egy blokkblobra. Ha szeretné megtudni, hogyan hozhat létre szűrőt, olvassa el az Event Grid eseményeinek szűrése című témakört.
Példaesemények
Microsoft.Storage.BlobCreated esemény (Data Lake Storage Gen2)
Ha a Blob Storage-fiók hierarchikus névtérrel rendelkezik, az adatok az előző példához hasonlóan néznek ki, a módosítások kivételével:
- A
data.api
kulcs a sztringreCreateFile
vagyFlushWithClose
a . - A
contentOffset
kulcs szerepel az adathalmazban.
Feljegyzés
Ha az alkalmazások a PutBlockList
művelettel feltöltenek egy új blobot a fiókba, az adatok nem tartalmazzák ezeket a módosításokat.
[{
"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 esemény (Data Lake Storage Gen2)
Ha a Blob Storage-fiók hierarchikus névtérrel rendelkezik, az adatok az előző példához hasonlóan néznek ki, a módosítások kivételével:
- A
data.api
kulcs a sztringreDeleteFile
van állítva. - A
url
kulcs tartalmazza az elérési utatdfs.core.windows.net
.
Feljegyzés
Ha az alkalmazások a DeleteBlob
művelettel törölnek egy blobot a fiókból, az adatok nem tartalmazzák ezeket a módosításokat.
[{
"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 esemény (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 esemény (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 esemény (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 esemény (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-események
Ezek az események akkor aktiválódnak, ha engedélyezi a hierarchikus névteret a tárfiókon, és az ügyfelek SFTP API-kat használnak. További információ az Azure Blob Storage SFTP-támogatásáról: SSH File Transfer Protocol (SFTP) az Azure Blob Storage-ban.
Esemény neve | Leírás |
---|---|
Microsoft.Storage.BlobCreated | Blob létrehozásakor vagy felülírásakor aktiválódik. Ez az esemény konkrétan akkor aktiválódik, ha az ügyfelek a put műveletet használják, amely megfelel az és SftpCommit az SftpCreate API-knak. A fájl megnyitásakor egy üres blob jön létre, a feltöltött tartalom pedig véglegesítve lesz a fájl bezárásakor. Ha az SFTP Resumable Uploads előzetes verziójú funkció engedélyezve van, a feltöltés során egyes SftpWrite események is aktiválódnak. |
Microsoft.Storage.BlobDeleted | Blob törlésekor aktiválódik. Ez az esemény akkor is aktiválódik, ha az ügyfelek meghívják a rm műveletet, amely megfelel az SftpRemove API-nak. |
Microsoft.Storage.BlobRenamed | A blob átnevezésekor aktiválódik. Ez az esemény akkor aktiválódik, ha az ügyfelek az rename API-nak megfelelő fájlokon használják a SftpRename műveletet. |
Microsoft.Storage.DirectoryCreated | Könyvtár létrehozásakor aktiválódik. Ez az esemény akkor aktiválódik, amikor az ügyfelek az mkdir API-nak SftpMakeDir megfelelő műveletet használják. |
Microsoft.Storage.DirectoryRenamed | A címtár átnevezésekor aktiválódik. Ez az esemény akkor aktiválódik, ha az ügyfelek az rename API-nak megfelelő könyvtárban használják a SftpRename műveletet. |
Microsoft.Storage.DirectoryDeleted | A címtár törlésekor aktiválódik. Ez az esemény akkor aktiválódik, amikor az ügyfelek az rmdir API-nak SftpRemoveDir megfelelő műveletet használják. |
Példaesemények
Az események aktiválásakor az Event Grid szolgáltatás adatokat küld a feliratkozott végpontnak az eseménnyel kapcsolatban. Ez a szakasz egy példát tartalmaz arra, hogy az adatok milyenek lesznek az egyes blobtároló-eseményekhez.
Microsoft.Storage.BlobCreated esemény (SFTP)
Ha a Blob Storage-fiók SFTP használatával hoz létre vagy ír felül egy blobot, akkor az adatok az előző példához hasonlóan néznek ki, kivéve az alábbi módosításokat:
A
dataVersion
kulcs értéke3
: .A
data.api
kulcs a sztringreSftpCreate
van állítva,SftpWrite
vagySftpCommit
.A
clientRequestId
kulcs nem szerepel a csomagban.A
contentType
kulcs a következőreapplication/octet-stream
van állítva: .A
contentOffset
kulcs szerepel az adathalmazban.A
identity
kulcs szerepel az adathalmazban. Ez megfelel az SFTP-hitelesítéshez használt helyi felhasználónak.
Feljegyzés
Az SFTP-feltöltések 2 eseményt hoznak létre. Egyet SftpCreate
a fájl megnyitásakor létrehozott kezdeti üres blobhoz, egyet SftpCommit
pedig a fájltartalom véglegesítéséhez a feltöltés végén. Ha az SFTP Resumable Uploads
előzetes verziójú funkció engedélyezve van, a feltöltés során egyes SftpWrite
események is aktiválódnak.
[{
"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 esemény (SFTP)
Ha a Blob Storage-fiók SFTP használatával töröl egy blobot, akkor az adatok az előző példához hasonlóan néznek ki, kivéve a következő módosításokat:
A
dataVersion
kulcs értéke2
: .A
data.api
kulcs a sztringreSftpRemove
van állítva.A
clientRequestId
kulcs nem szerepel a csomagban.A
contentType
kulcs a következőreapplication/octet-stream
van állítva: .A
identity
kulcs szerepel az adathalmazban. Ez megfelel az SFTP-hitelesítéshez használt helyi felhasználónak.
[{
"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 esemény (SFTP)
Ha a Blob Storage-fiók SFTP használatával nevez át egy blobot, akkor az adatok az előző példához hasonlóan néznek ki, kivéve a következő módosításokat:
A
data.api
kulcs a sztringreSftpRename
van állítva.A
clientRequestId
kulcs nem szerepel a csomagban.A
identity
kulcs szerepel az adathalmazban. Ez megfelel az SFTP-hitelesítéshez használt helyi felhasználónak.
[{
"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 esemény (SFTP)
Ha a Blob Storage-fiók SFTP használatával hoz létre egy könyvtárat, akkor az adatok az előző példához hasonlóan néznek ki, kivéve a következő módosításokat:
A
dataVersion
kulcs értéke2
: .A
data.api
kulcs a sztringreSftpMakeDir
van állítva.A
clientRequestId
kulcs nem szerepel a csomagban.A
identity
kulcs szerepel az adathalmazban. Ez megfelel az SFTP-hitelesítéshez használt helyi felhasználónak.
[{
"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 esemény (SFTP)
Ha a Blob Storage-fiók SFTP használatával nevez át egy könyvtárat, akkor az adatok az előző példához hasonlóan néznek ki, kivéve a következő módosításokat:
A
data.api
kulcs a sztringreSftpRename
van állítva.A
clientRequestId
kulcs nem szerepel a csomagban.A
identity
kulcs szerepel az adathalmazban. Ez megfelel az SFTP-hitelesítéshez használt helyi felhasználónak.
[{
"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 esemény (SFTP)
Ha a Blob Storage-fiók SFTP használatával töröl egy könyvtárat, akkor az adatok az előző példához hasonlóan néznek ki, kivéve a következő módosításokat:
A
data.api
kulcs a sztringreSftpRemoveDir
van állítva.A
clientRequestId
kulcs nem szerepel a csomagban.A
identity
kulcs szerepel az adathalmazban. Ez megfelel az SFTP-hitelesítéshez használt helyi felhasználónak.
[{
"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"
}]
Szabályzattal kapcsolatos események
Ezek az események a szabályzat által meghatározott műveletek végrehajtásakor aktiválódnak.
Esemény neve | Leírás |
---|---|
Microsoft.Storage.BlobInventoryPolicyCompleted | Akkor aktiválódik, amikor a készletfuttatás befejeződik egy készletszabályzatot definiáló szabály esetében. Ez az esemény akkor is előfordul, ha a készlet futtatása felhasználói hibával meghiúsul, mielőtt elindulna. Például egy érvénytelen szabályzat vagy egy olyan hiba, amely akkor fordul elő, ha egy céltároló nem jelenik meg, aktiválja az eseményt. |
Microsoft.Storage.LifecyclePolicyCompleted | Az életciklus-felügyeleti szabályzat által meghatározott műveletek végrehajtása aktiválódik. |
Példaesemények
Az események aktiválásakor az Event Grid szolgáltatás adatokat küld a feliratkozott végpontnak az eseménnyel kapcsolatban. Ez a szakasz egy példát tartalmaz arra, hogy az adatok milyenek lesznek az egyes blobtároló-eseményekhez.
Microsoft.Storage.BlobInventoryPolicyCompleted esemény
{
"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 esemény
{
"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"
}
Esemény tulajdonságai
Egy esemény a következő legfelső szintű adatokkal rendelkezik:
Tulajdonság | Típus | Leírás |
---|---|---|
source |
húr | Az eseményforrás teljes erőforrás-elérési útja. Ez a mező nem írható. Az értéket az Event Grid adja meg. |
subject |
húr | Az esemény tárgyra mutató, a közzétevő által megadott elérési út. |
type |
húr | Az eseményforráshoz felvett eseménytípusok egyike. |
time |
húr | Az esemény létrehozásának időpontja a szolgáltató UTC-ideje alapján. |
id |
húr | Az esemény egyedi azonosítója. |
data |
object | Blob Storage-eseményadatok. |
specversion |
húr | A CloudEvents sémaspecifikációs verziója. |
Az adatobjektum a következő tulajdonságokkal rendelkezik:
Tulajdonság | Típus | Leírás |
---|---|---|
api |
húr | Az eseményt kiváltó művelet. |
clientRequestId |
húr | egy ügyfél által megadott kérésazonosító a storage API-művelethez. Ez az azonosító az Azure Storage diagnosztikai naplóihoz való korrelációhoz használható a naplók "client-request-id" mezőjével, és az ügyfélkérésekben az "x-ms-client-request-id" fejléc használatával adható meg. Lásd: Naplóformátum. |
requestId |
húr | Szolgáltatás által generált kérésazonosító a storage API-művelethez. Az Azure Storage diagnosztikai naplóival való korrelációhoz használható a naplók "request-id-header" mezőjének használatával, és a rendszer az "x-ms-request-id" fejlécben lévő API-hívásból kapja vissza. Lásd: Naplóformátum. |
eTag |
húr | A műveletek feltételes futtatásához használható érték. |
contentType |
húr | A blobhoz megadott tartalomtípus. |
contentLength |
egész szám | A blob mérete bájtban. |
blobType |
húr | A blob típusa. Az érvényes értékek a "BlockBlob" vagy a "PageBlob" értékek. |
accessTier |
húr | A blob célszintje. Csak a BlobTierChanged eseménynél jelenik meg. |
previousTier |
húr | A blob forrásszintje. Csak a BlobTierChanged eseménynél jelenik meg. Ha a blob a tárfiókból vonja ki a réteget, ez a mező nem jelenik meg. |
contentOffset |
szám | Egy írási művelet bájtban megadott eltolása, amely azon a ponton történt, amikor az eseményindító alkalmazás befejezte a fájlba való írást. Csak hierarchikus névtérrel rendelkező Blob Storage-fiókokon aktivált események esetén jelenik meg. |
destinationUrl |
húr | A művelet befejezése után létező fájl URL-címe. Ha például átneveznek egy fájlt, a destinationUrl tulajdonság az új fájlnév URL-címét tartalmazza. Csak hierarchikus névtérrel rendelkező Blob Storage-fiókokon aktivált események esetén jelenik meg. |
sourceUrl |
húr | A művelet végrehajtása előtt létező fájl URL-címe. Ha például átneveznek egy fájlt, az sourceUrl az eredeti fájlnév URL-címét tartalmazza az átnevezési művelet előtt. Csak hierarchikus névtérrel rendelkező Blob Storage-fiókokon aktivált események esetén jelenik meg. |
url |
húr | A blob elérési útja. Ha az ügyfél Blob REST API-t használ, akkor az URL-cím a következő struktúrával rendelkezik: <storage-account-name>.blob.core.windows.net\<container-name>\<file-name> . Ha az ügyfél Egy Data Lake Storage REST API-t használ, akkor az URL-cím struktúrája a következő: <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name> . |
recursive |
húr | True a művelet futtatása az összes gyermekkönyvtárban; egyéb esetben False . Csak hierarchikus névtérrel rendelkező Blob Storage-fiókokon aktivált események esetén jelenik meg. |
sequencer |
húr | Egy átlátszatlan sztringérték, amely egy adott blobnévhez tartozó események logikai sorrendjét jelöli. A felhasználók szabványos sztring-összehasonlítást használhatnak az ugyanazon a blobnéven lévő két esemény relatív sorrendjének megértéséhez. |
identity |
húr | Az eseményhez társított identitást képviselő sztringérték. Az SFTP esetében ez a helyi felhasználónév. |
storageDiagnostics |
object | Az Azure Storage szolgáltatás időnként tartalmaz diagnosztikai adatokat. Ha jelen van, az eseményfelhasználóknak figyelmen kívül kell hagyniuk. |
Oktatóanyagok és útmutatók
Cím | Leírás |
---|---|
Rövid útmutató: Blob Storage-események átirányítása egyéni webvégpontra az Azure CLI használatával | Bemutatja, hogyan küldhet Blob Storage-eseményeket a WebHooknak az Azure CLI használatával. |
Rövid útmutató: Blob Storage-események átirányítása egyéni webvégpontra a PowerShell használatával | Bemutatja, hogyan küldhet blobtároló-eseményeket a WebHooknak az Azure PowerShell használatával. |
Rövid útmutató: Blob Storage-események létrehozása és irányítása az Azure Portallal | Bemutatja, hogyan küldhet blobtároló-eseményeket a WebHooknak a portál használatával. |
Azure CLI: Előfizethet egy Blob Storage-fiók eseményeire | Példaszkript, amely feliratkozik egy Blob Storage-fiók eseményére. Elküldi az eseményt egy WebHooknak. |
PowerShell: Feliratkozás Blob Storage-fiók eseményeire | Példaszkript, amely feliratkozik egy Blob Storage-fiók eseményére. Elküldi az eseményt egy WebHooknak. |
Resource Manager-sablon: Blob Storage és előfizetés létrehozása | Üzembe helyez egy Azure Blob Storage-fiókot, és feliratkozik a vele kapcsolatos eseményekre. Eseményeket küld egy WebHooknak. |
Áttekintés: a Blob Storage-eseményekre való reagálás | A Blob Storage és az Event Grid integrálásának áttekintése. |
Következő lépések
- Az Azure Event Grid bemutatása: Mi az az Event Grid?
- Az Azure Event Grid-előfizetések létrehozásával kapcsolatos további információkért tekintse meg az Event Grid-előfizetés sémáját.
- A Blob Storage-események használatának bemutatása: Blob Storage-események átirányítása – Azure CLI.