Sdílet prostřednictvím

Azure Blob Storage jako zdroj Event Gridu

Tento článek obsahuje vlastnosti a schéma pro události úložiště objektů blob. Úvod do schémat událostí najdete ve schématu událostí služby Azure Event Grid. Poskytuje také seznam rychlých startů a kurzů pro použití služby Azure Blob Storage jako zdroje událostí.

Poznámka:

Integrace událostí podporují pouze účty úložiště typu StorageV2 (pro obecné účely v2), BlockBlobStorage a BlobStorage. Úložiště (pro obecné účely v1) nepodporujeintegraci se službou Event Grid.

Dostupné typy událostí

Události služby Blob Storage

Tyto události se aktivují, když klient vytvoří, nahradí nebo odstraní objekt blob voláním rozhraní REST API objektů blob.

Poznámka:

$logs Kontejnery $blobchangefeed nejsou integrované se službou Event Grid, takže aktivita v těchto kontejnerech negeneruje události. Také použití koncového bodu (abfss://URI) dfs pro účty s povolenými ne hierarchickým oborem názvů negeneruje události, ale koncový bod objektu (wasb:// URI) blob vygeneruje události.

Název události Popis
Microsoft.Storage.BlobCreated Aktivuje se při vytvoření nebo nahrazení objektu blob.
Konkrétně se tato událost aktivuje, když klienti používají PutBloboperace , PutBlockListnebo CopyBlob operace, které jsou k dispozici v rozhraní REST API objektu blob a kdy je objekt blob bloku zcela potvrzen.
Pokud klienti používají CopyBlob operaci u účtů s povolenou funkcí hierarchického oboru názvů , CopyBlob operace funguje trochu jinak. Pokud se CopyBlob operace dokončí okamžitě, aktivuje se událost Microsoft.Storage.BlobCreated, protože blokový blob je zcela potvrzen. Pokud se však operace okamžitě nedokončí, aktivuje se místo toho událost Microsoft.Storage.AsyncOperationInitiated , která indikuje, že CopyBlob operace byla inicializována, ale objekt blob bloku ještě není úplně potvrzený.
Microsoft.Storage.BlobDeleted Aktivuje se při odstranění objektu blob.
Konkrétně se tato událost aktivuje, když klienti volají DeleteBlob operaci, která je k dispozici v rozhraní REST API objektu blob.
Microsoft.Storage.BlobTierChanged Aktivuje se při změně úrovně přístupu k objektům blob. Konkrétně platí, že když klienti volají Set Blob Tier operaci, která je k dispozici v rozhraní REST API objektu blob, tato událost se aktivuje po dokončení změny úrovně.
Microsoft.Storage.AsyncOperationInitiated Aktivuje se při zahájení operace zahrnující přesun nebo kopírování dat z archivu na horkou nebo studenou úroveň. Konkrétně se tato událost aktivuje buď v případě, že klienti volají Set Blob Tier rozhraní API, aby přesunuli objekt blob z archivní vrstvy na horkou nebo studenou úroveň, nebo když klienti volají Copy Blob rozhraní API pro kopírování dat z objektu blob v archivní vrstvě do objektu blob v horké nebo studené vrstvě.
Tato událost se může také aktivovat, pokud klienti použijí operaci CopyBlob u účtů s aktivovanou funkcí hierarchického oboru názvů a operace není okamžitě dokončena. V takovém případě se aktivuje událost Microsoft.Storage.AsyncOperationInitiated, která označuje, že operace byla inicializována, CopyBlob ale blokový blob ještě není zcela zpracován. Po úplném potvrzení objektu blob bloku se aktivuje konečná událost Microsoft.Storage.BlobCreated , která potvrdí dokončení.

Příklady událostí

Microsoft.Storage.BlobCreated – událost

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

Událost Microsoft.Storage.BlobDeleted

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

Událost Microsoft.Storage.BlobTierChanged

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

Událost Microsoft.Storage.AsyncOperationInitiated

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

Události Data Lake Storage Gen2

Tyto události se aktivují, pokud pro účet úložiště povolíte hierarchický obor názvů a klienti používají rozhraní REST API Azure Data Lake Storage Gen2. Další informace o službě Azure Data Lake Storage Gen2 najdete v tématu Úvod do Azure Data Lake Storage Gen2.

Název události Popis
Microsoft.Storage.BlobCreated Aktivuje se při vytvoření nebo nahrazení objektu blob.
Konkrétně se tato událost aktivuje, když klienti používají CreateFile a FlushWithClose operace, které jsou k dispozici v rozhraní REST API Služby Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobDeleted Aktivuje se při odstranění objektu blob.
Konkrétně se tato událost aktivuje také v případě, že klienti volají DeleteFile operaci dostupnou v rozhraní REST API Služby Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobRenamed Aktivuje se při přejmenování objektu blob.
Konkrétně se tato událost aktivuje, když klienti používají RenameFile operaci dostupnou v rozhraní REST API Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryCreated Aktivuje se při vytvoření adresáře.
Konkrétně se tato událost aktivuje, když klienti používají CreateDirectory operaci dostupnou v rozhraní REST API Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryRenamed Aktivuje se při přejmenování adresáře.
Konkrétně se tato událost aktivuje, když klienti používají RenameDirectory operaci dostupnou v rozhraní REST API Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryDeleted Aktivuje se při odstranění adresáře.
Konkrétně se tato událost aktivuje, když klienti používají DeleteDirectory operaci dostupnou v rozhraní REST API Azure Data Lake Storage Gen2.

Poznámka:

Pokud chcete zajistit, aby se událost Microsoft.Storage.BlobCreated aktivovala pouze v případě, že je objekt blob bloku zcela potvrzený, vyfiltrujte událost pro FlushWithClose volání rozhraní REST API. Toto volání rozhraní API aktivuje událost Microsoft.Storage.BlobCreated až po úplném potvrzení dat do objektu blob bloku. Informace o tom, jak vytvořit filtr, najdete v tématu Filtrování událostí pro Event Grid.

Příklady událostí

Událost Microsoft.Storage.BlobCreated (Data Lake Storage Gen2)

Pokud má účet úložiště objektů blob hierarchický obor názvů, data vypadají podobně jako v předchozím příkladu s výjimkou těchto změn:

  • Klíč data.api je nastaven na řetězec CreateFile nebo FlushWithClose.
  • Klíč contentOffset je součástí datové sady.

Poznámka:

Pokud aplikace tuto operaci používají PutBlockList k nahrání nového objektu blob do účtu, data tyto změny nebudou obsahovat.

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

Událost Microsoft.Storage.BlobDeleted (Data Lake Storage Gen2)

Pokud má účet úložiště objektů blob hierarchický obor názvů, data vypadají podobně jako v předchozím příkladu s výjimkou těchto změn:

  • Klíč data.api je nastaven na řetězec DeleteFile.
  • Klíč url obsahuje cestu dfs.core.windows.net.

Poznámka:

Pokud aplikace tuto operaci používají DeleteBlob k odstranění objektu blob z účtu, data tyto změny nebudou obsahovat.

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

Událost Microsoft.Storage.BlobRenamed (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"
}]

Událost Microsoft.Storage.DirectoryCreated (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"
}]

Událost Microsoft.Storage.DirectoryRenamed (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"
}]

Událost Microsoft.Storage.DirectoryDeleted (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"
}]

Události SFTP

Tyto události se aktivují, pokud pro účet úložiště povolíte hierarchický obor názvů a klienti používají rozhraní API SFTP. Další informace o podpoře SFTP pro Azure Blob Storage najdete v tématu SSH File Transfer Protocol (SFTP) ve službě Azure Blob Storage.

Název události Popis
Microsoft.Storage.BlobCreated Aktivuje se při vytvoření nebo přepsání objektu blob.
Konkrétně se tato událost aktivuje, když klienti používají put operaci, která odpovídá SftpCreate rozhraním API a SftpCommit rozhraním API. Při otevření souboru se vytvoří prázdný objekt blob a při zavření souboru se potvrdí nahraný obsah. SFTP Resumable Uploads Pokud je funkce Preview povolená, během nahrávání se také aktivují některé SftpWrite události.
Microsoft.Storage.BlobDeleted Aktivuje se při odstranění objektu blob.
Konkrétně se tato událost aktivuje také při volání rm operace klienty, která odpovídá SftpRemove rozhraní API.
Microsoft.Storage.BlobRenamed Aktivuje se při přejmenování objektu blob.
Konkrétně se tato událost aktivuje, když klienti používají rename operaci u souborů, která odpovídá SftpRename rozhraní API.
Microsoft.Storage.DirectoryCreated Aktivuje se při vytvoření adresáře.
Konkrétně se tato událost aktivuje, když klienti používají mkdir operaci, která odpovídá SftpMakeDir rozhraní API.
Microsoft.Storage.DirectoryRenamed Aktivuje se při přejmenování adresáře.
Konkrétně se tato událost aktivuje, když klienti používají rename operaci v adresáři, která odpovídá SftpRename rozhraní API.
Microsoft.Storage.DirectoryDeleted Aktivuje se při odstranění adresáře.
Konkrétně se tato událost aktivuje, když klienti používají rmdir operaci, která odpovídá SftpRemoveDir rozhraní API.

Příklady událostí

Když se aktivuje událost, služba Event Grid odešle data o dané události do odebírajícího koncového bodu. Tato část obsahuje příklad toho, jak by tato data vypadala pro každou událost úložiště objektů blob.

Událost Microsoft.Storage.BlobCreated (SFTP)

Pokud účet úložiště objektů blob používá K vytvoření nebo přepsání objektu blob protokol SFTP, data vypadají podobně jako v předchozím příkladu s výjimkou těchto změn:

  • Klíč dataVersion je nastaven na hodnotu 3.

  • Klíč data.api je nastaven na řetězec SftpCreate, SftpWritenebo SftpCommit.

  • Klíč clientRequestId není zahrnutý.

  • Klíč contentType je nastaven na application/octet-streamhodnotu .

  • Klíč contentOffset je součástí datové sady.

  • Klíč identity je součástí datové sady. To odpovídá místnímu uživateli použitému pro ověřování SFTP.

Poznámka:

Nahrávání SFTP vygeneruje 2 události. Jeden SftpCreate pro počáteční prázdný objekt blob vytvořený při otevření souboru a jeden SftpCommit při potvrzení obsahu souboru na konci nahrávání. SFTP Resumable Uploads Pokud je funkce Preview povolená, během nahrávání se také aktivují některé SftpWrite události.

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

Událost Microsoft.Storage.BlobDeleted (SFTP)

Pokud účet úložiště objektů blob používá k odstranění objektu blob protokol SFTP, data vypadají podobně jako v předchozím příkladu s výjimkou těchto změn:

  • Klíč dataVersion je nastaven na hodnotu 2.

  • Klíč data.api je nastaven na řetězec SftpRemove.

  • Klíč clientRequestId není zahrnutý.

  • Klíč contentType je nastaven na application/octet-streamhodnotu .

  • Klíč identity je součástí datové sady. To odpovídá místnímu uživateli použitému pro ověřování SFTP.

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

Událost Microsoft.Storage.BlobRenamed (SFTP)

Pokud účet úložiště objektů blob používá k přejmenování objektu blob protokol SFTP, data vypadají podobně jako v předchozím příkladu s výjimkou těchto změn:

  • Klíč data.api je nastaven na řetězec SftpRename.

  • Klíč clientRequestId není zahrnutý.

  • Klíč identity je součástí datové sady. To odpovídá místnímu uživateli použitému pro ověřování SFTP.

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

Událost Microsoft.Storage.DirectoryCreated (SFTP)

Pokud účet úložiště objektů blob používá K vytvoření adresáře protokol SFTP, data vypadají podobně jako v předchozím příkladu s výjimkou těchto změn:

  • Klíč dataVersion je nastaven na hodnotu 2.

  • Klíč data.api je nastaven na řetězec SftpMakeDir.

  • Klíč clientRequestId není zahrnutý.

  • Klíč identity je součástí datové sady. To odpovídá místnímu uživateli použitému pro ověřování SFTP.

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

Událost Microsoft.Storage.DirectoryRenamed (SFTP)

Pokud účet úložiště objektů blob používá k přejmenování adresáře protokol SFTP, data vypadají podobně jako v předchozím příkladu s výjimkou těchto změn:

  • Klíč data.api je nastaven na řetězec SftpRename.

  • Klíč clientRequestId není zahrnutý.

  • Klíč identity je součástí datové sady. To odpovídá místnímu uživateli použitému pro ověřování SFTP.

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

Událost Microsoft.Storage.DirectoryDeleted (SFTP)

Pokud účet úložiště objektů blob používá K odstranění adresáře protokol SFTP, data vypadají podobně jako v předchozím příkladu s výjimkou těchto změn:

  • Klíč data.api je nastaven na řetězec SftpRemoveDir.

  • Klíč clientRequestId není zahrnutý.

  • Klíč identity je součástí datové sady. To odpovídá místnímu uživateli použitému pro ověřování SFTP.

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

Tyto události se aktivují při provádění akcí definovaných zásadou.

Název události Popis
Microsoft.Storage.BlobInventoryPolicyCompleted Aktivuje se, když se spuštění inventáře dokončí pro pravidlo, které je definováno zásadou inventáře. K této události dochází také v případě, že spuštění inventáře selže s chybou uživatele před tím, než se spustí. Například neplatná zásada nebo chyba, která nastane, když cílový kontejner není k dispozici, aktivuje událost.
Microsoft.Storage.LifecyclePolicyCompleted Aktivuje se při provádění akcí definovaných zásadami správy životního cyklu.

Příklady událostí

Když se aktivuje událost, služba Event Grid odešle data o dané události do odebírajícího koncového bodu. Tato část obsahuje příklad toho, jak by tato data vypadala pro každou událost úložiště objektů blob.

Microsoft.Storage.BlobInventoryPolicyCompleted – událost

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

Událost Microsoft.Storage.LifecyclePolicyCompleted

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

Vlastnosti události

Událost má následující data nejvyšší úrovně:

Vlastnost Typ Popis
source řetězec Úplná cesta prostředku ke zdroji událostí. Toto pole není zapisovatelné. Tuto hodnotu poskytuje Event Grid.
subject řetězec Cesta k předmětu události, kterou definuje vydavatel.
type řetězec Jeden z registrovaných typů události pro tento zdroj události.
time řetězec Čas vygenerování události na základě času UTC poskytovatele.
id řetězec Jedinečný identifikátor události.
data objekt Data událostí úložiště objektů blob
specversion řetězec Verze specifikace schématu CloudEvents

Datový objekt má následující vlastnosti:

Vlastnost Typ Popis
api řetězec Operace, která událost aktivovala.
clientRequestId řetězec ID požadavku poskytnutého klientem pro operaci rozhraní API úložiště. Toto ID se dá použít ke korelaci s diagnostickými protokoly Azure Storage pomocí pole client-request-id v protokolech a lze ho poskytnout v požadavcích klientů pomocí hlavičky x-ms-client-request-id. Viz Formát protokolu.
requestId řetězec ID požadavku vygenerované službou pro operaci rozhraní API úložiště. Dá se použít ke korelaci s diagnostickými protokoly Azure Storage pomocí pole request-id-header v protokolech a vrací se z inicializování volání rozhraní API v hlavičce x-ms-request-id. Viz Formát protokolu.
eTag řetězec Hodnota, kterou můžete použít ke spouštění operací podmíněně.
contentType řetězec Typ obsahu zadaný pro objekt blob.
contentLength integer Velikost objektu blob v bajtech
blobType řetězec Typ objektu blob. Platné hodnoty jsou buď BlockBlob, nebo PageBlob.
accessTier řetězec Cílová úroveň objektu blob. Zobrazí se pouze pro událost BlobTierChanged.
previousTier řetězec Zdrojová úroveň objektu blob. Zobrazí se pouze pro událost BlobTierChanged. Pokud objekt blob odvodí úroveň z účtu úložiště, toto pole se nezobrazí.
contentOffset Číslo Posun v bajtech operace zápisu pořízené v okamžiku, kdy aplikace aktivující událost dokončila zápis do souboru.
Zobrazí se pouze u událostí aktivovaných v účtech úložiště objektů blob, které mají hierarchický obor názvů.
destinationUrl řetězec Adresa URL souboru, který bude existovat po dokončení operace. Pokud je například soubor přejmenován, destinationUrl vlastnost obsahuje adresu URL nového názvu souboru.
Zobrazí se pouze u událostí aktivovaných v účtech úložiště objektů blob, které mají hierarchický obor názvů.
sourceUrl řetězec Adresa URL souboru, který existuje před provedením operace. Pokud je například soubor přejmenován, sourceUrl obsahuje adresu URL původního názvu souboru před operací přejmenování.
Zobrazí se pouze u událostí aktivovaných v účtech úložiště objektů blob, které mají hierarchický obor názvů.
url řetězec Cesta k objektu blob.
Pokud klient používá rozhraní REST API objektu blob, má adresa URL tuto strukturu: <storage-account-name>.blob.core.windows.net\<container-name>\<file-name>.
Pokud klient používá rozhraní REST API služby Data Lake Storage, má adresa URL tuto strukturu: <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>.
recursive řetězec True ke spuštění operace na všech podřízených adresářích; jinak False.
Zobrazí se pouze u událostí aktivovaných v účtech úložiště objektů blob, které mají hierarchický obor názvů.
sequencer řetězec Neprůrůzná řetězcová hodnota představující logickou sekvenci událostí pro libovolný konkrétní název objektu blob. Uživatelé můžou použít standardní porovnání řetězců, aby porozuměli relativní sekvenci dvou událostí ve stejném názvu objektu blob.
identity řetězec Řetězcová hodnota představující identitu přidruženou k události. V případě protokolu SFTP se jedná o místní uživatelské jméno.
storageDiagnostics objekt Diagnostická data občas zahrnutá službou Azure Storage Pokud je k dispozici, měli by příjemci událostí ignorovat.

Kurzy a postupy

Titulek Popis
Rychlý start: Směrování událostí služby Blob Storage do vlastního webového koncového bodu pomocí Azure CLI Ukazuje, jak pomocí Azure CLI odesílat události úložiště objektů blob do webhooku.
Rychlý start: Směrování událostí služby Blob Storage do vlastního webového koncového bodu pomocí PowerShellu Ukazuje, jak pomocí Azure PowerShellu odesílat události úložiště objektů blob do webhooku.
Rychlý start: Vytvoření a směrování událostí úložiště objektů blob pomocí webu Azure Portal Ukazuje, jak pomocí portálu odesílat události úložiště objektů blob do webhooku.
Azure CLI: Přihlášení k odběru událostí pro účet úložiště objektů blob Ukázkový skript, který se přihlásí k odběru události pro účet úložiště objektů blob Odešle událost do webhooku.
PowerShell: Přihlášení k odběru událostí pro účet úložiště objektů blob Ukázkový skript, který se přihlásí k odběru události pro účet úložiště objektů blob Odešle událost do webhooku.
Šablona Resource Manageru: Vytvoření úložiště objektů blob a předplatného Nasadí účet úložiště objektů blob v Azure a přihlásí se k odběru událostí tohoto účtu úložiště. Odesílá události do webhooku.
Přehled: Reakce na události úložiště objektů blob Přehled integrace úložiště objektů blob se službou Event Grid

Další kroky

  • Last updated on