Az Azure Blob Storage mint Event Grid-forrás

  • Cikk

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) nemtá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 PutBlobBlob REST API-ban elérhető, illetve CopyBlob a blokkblob teljes véglegesítésekor elérhető műveleteket PutBlockListhaszná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",
    "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",
    "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",
		"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 sztringre CreateFile vagy FlushWithClosea .
  • 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 sztringre DeleteFilevan állítva.
  • A url kulcs tartalmazza az elérési utat dfs.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.
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éke 3: .

  • A data.api kulcs a sztringre SftpCreate vagy SftpCommita .

  • A clientRequestId kulcs nem szerepel a csomagban.

  • A contentType kulcs a következőre application/octet-streamvan á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 írásakor.

[{
  "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éke 2: .

  • A data.api kulcs a sztringre SftpRemovevan állítva.

  • A clientRequestId kulcs nem szerepel a csomagban.

  • A contentType kulcs a következőre application/octet-streamvan á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 sztringre SftpRenamevan á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éke 2: .

  • A data.api kulcs a sztringre SftpMakeDirvan á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 sztringre SftpRenamevan á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 sztringre SftpRemoveDirvan á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"
}]

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": ""
        },
        "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.
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