Event Grid kaynağı olarak Azure Blob Depolama
Bu makalede blob depolama olaylarının özellikleri ve şeması sağlanır. Olay şemalarına giriş için bkz . Azure Event Grid olay şeması. Ayrıca, Azure Blob Depolama olay kaynağı olarak kullanmak için hızlı başlangıçların ve öğreticilerin listesini de sunar.
Not
Yalnızca StorageV2 (genel amaçlı v2), BlockBlobStorage ve BlobStorage türünde depolama hesapları olay tümleştirmesini destekler. Depolama (genel amaçlı v1), Event Grid ile tümleştirmeyi desteklemez.
Kullanılabilir olay türleri
Blob Depolama olayları
Bu olaylar, bir istemci Blob REST API'lerini çağırarak bir blob oluşturduğunda, değiştirdiğinde veya sildiğinde tetiklenir.
Not
$logs
ve $blobchangefeed
kapsayıcıları Event Grid ile tümleştirilmediğinden, bu kapsayıcılardaki etkinlikler olay oluşturmaz. Ayrıca, hiyerarşik olmayan ad alanı etkin hesaplar için dfs uç noktasının (abfss://URI)
kullanılması olay oluşturmaz, ancak blob uç noktası (wasb:// URI)
olaylar oluşturur.
Olay adı | Açıklama |
---|---|
Microsoft.Storage.BlobCreated | Blob oluşturulduğunda veya değiştirildiğinde tetikleniyor. Özellikle, istemciler Blob REST API'sinde kullanılabilen , PutBlockList veya CopyBlob işlemlerini kullandığında PutBlob ve Blok Blobu tamamen işlendiğinde bu olay tetiklenir. İstemciler, hiyerarşik ad alanı özelliğinin etkinleştirildiği hesaplarda işlemi kullanırsa CopyBlob , CopyBlob işlem biraz farklı çalışır. Bu durumda, Blok Blobu tamamen işlendiğinde CopyBlob değil, işlem başlatıldığında Microsoft.Storage.BlobCreated olayı tetikler. |
Microsoft.Storage.BlobDeleted | Blob silindiğinde tetikleniyor. Özellikle, istemciler Blob REST API'sinde kullanılabilen işlemi çağırdığında DeleteBlob bu olay tetiklenir. |
Microsoft.Storage.BlobTierChanged | Blob erişim katmanı değiştirildiğinde tetikleniyor. Özellikle, istemciler Blob REST API'sinde bulunan işlemi çağırdığında Set Blob Tier , katman değişikliği tamamlandıktan sonra bu olay tetiklenir. |
Microsoft.Storage.AsyncOperationInitiated | Verilerin arşivden sık erişimli veya seyrek erişimli katmanlara taşınması veya kopyalanmasıyla ilgili bir işlem başlatıldığında tetikler. Özellikle, istemciler bir blobu arşiv katmanından sık erişimli veya seyrek erişimli katmana taşımak için API'yi çağırdığında Set Blob Tier veya istemciler arşiv katmanındaki bir blobdan sık erişimli veya seyrek erişimli katmandaki bir bloba veri kopyalamak için API'yi çağırdığında Copy Blob bu olay tetiklenmektedir. |
Örnek olaylar
Microsoft.Storage.BlobCreated olayı
[{
"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 olayı
[{
"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 olayı
{
"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 olayı
{
"source": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account",
"subject": "/blobServices/default/containers/testcontainer/blobs/00000.avro",
"type": "Microsoft.Storage.AsyncOperationInitiated",
"time": "2021-05-04T14:44:59.3204652Z",
"id": "8ea4e3f2-101e-003d-5ff4-4053b2061016",
"data": {
"api": "SetBlobTier",
"clientRequestId": "777fb4cd-f890-4c5b-b024-fb47300bae62",
"requestId": "8ea4e3f2-101e-003d-5ff4-4053b2000000",
"contentType": "application/octet-stream",
"contentLength": 3660,
"blobType": "BlockBlob",
"url": "https://my-storage-account.blob.core.windows.net/testcontainer/00000.avro",
"sequencer": "000000000000000000000000000089A4000000000018c6d7",
"storageDiagnostics": {
"batchId": "34128c8a-7006-0014-00f4-406dc6000000"
}
},
"specversion": "1.0"
}
Data Lake Storage 2. Nesil olayları
Depolama hesabında hiyerarşik ad alanını etkinleştirirseniz ve istemciler Azure Data Lake Storage 2. Nesil REST API'lerini kullanırsa bu olaylar tetiklenir. Azure Data Lake Storage 2. Nesil hakkında daha fazla bilgi için bkz. Azure Data Lake Storage 2. Nesil giriş.
Olay adı | Açıklama |
---|---|
Microsoft.Storage.BlobCreated | Blob oluşturulduğunda veya değiştirildiğinde tetikleniyor. Özellikle, istemciler Azure Data Lake Storage 2. Nesil REST API'sinde kullanılabilen ve FlushWithClose işlemlerini kullandığında CreateFile bu olay tetiklenir. |
Microsoft.Storage.BlobDeleted | Blob silindiğinde tetikleniyor. Özellikle, bu olay istemciler Azure Data Lake Storage 2. Nesil REST API'sinde bulunan işlemi çağırdığında DeleteFile da tetiklenir. |
Microsoft.Storage.BlobRenamed | Blob yeniden adlandırıldığında tetikleniyor. Özellikle, istemciler Azure Data Lake Storage 2. Nesil REST API'sinde bulunan işlemi kullandığında RenameFile bu olay tetiklenir. |
Microsoft.Storage.DirectoryCreated | Dizin oluşturulduğunda tetikleniyor. Özellikle, istemciler Azure Data Lake Storage 2. Nesil REST API'sinde bulunan işlemi kullandığında CreateDirectory bu olay tetiklenir. |
Microsoft.Storage.DirectoryRenamed | Dizin yeniden adlandırıldığında tetikleniyor. Özellikle, istemciler Azure Data Lake Storage 2. Nesil REST API'sinde bulunan işlemi kullandığında RenameDirectory bu olay tetiklenir. |
Microsoft.Storage.DirectoryDeleted | Bir dizin silindiğinde tetikleniyor. Özellikle, istemciler Azure Data Lake Storage 2. Nesil REST API'sinde bulunan işlemi kullandığında DeleteDirectory bu olay tetiklenir. |
Not
Azure Data Lake Storage 2. Nesil için, Microsoft.Storage.BlobCreated olayının yalnızca Bir Blok Blobu tamamen işlendiğinde tetiklendiğinden emin olmak istiyorsanız, REST API çağrısı için FlushWithClose
olayı filtreleyin. Bu API çağrısı, Microsoft.Storage.BlobCreated olayını yalnızca veriler Bir Blok Blobu'na tamamen işlendikten sonra tetikler. Filtre oluşturmayı öğrenmek için bkz . Event Grid için olayları filtreleme.
Örnek olaylar
Microsoft.Storage.BlobCreated olayı (Data Lake Storage 2. Nesil)
Blob depolama hesabının hiyerarşik ad alanı varsa, veriler aşağıdaki değişiklikler dışında önceki örneğe benzer:
data.api
Anahtar veyaFlushWithClose
dizesineCreateFile
ayarlanır.contentOffset
Anahtar, veri kümesine eklenir.
Not
Uygulamalar işlemi kullanarak PutBlockList
hesaba yeni bir blob yüklerse veriler bu değişiklikleri içermez.
[{
"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 olayı (Data Lake Storage 2. Nesil)
Blob depolama hesabının hiyerarşik ad alanı varsa, veriler aşağıdaki değişiklikler dışında önceki örneğe benzer:
data.api
anahtar dizesineDeleteFile
ayarlanır.url
anahtarı yolunudfs.core.windows.net
içerir.
Not
Uygulamalar hesaptan bir blobu silmek için işlemini kullanırsa DeleteBlob
veriler bu değişiklikleri içermez.
[{
"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 olayı (Data Lake Storage 2. Nesil)
[{
"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 olayı (Data Lake Storage 2. Nesil)
[{
"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 olayı (Data Lake Storage 2. Nesil)
[{
"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 olayı (Data Lake Storage 2. Nesil)
[{
"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 olayları
Depolama hesabında hiyerarşik ad alanını etkinleştirirseniz ve istemciler SFTP API'lerini kullanırsa bu olaylar tetiklenir. Azure Blob Depolama için SFTP desteği hakkında daha fazla bilgi için bkz. Azure Blob Depolama'de SSH Dosya Aktarım Protokolü (SFTP).
Olay adı | Açıklama |
---|---|
Microsoft.Storage.BlobCreated | Bir blob oluşturulduğunda veya üzerine yazıldığında tetikleniyor. Özellikle, istemciler ve SftpCommit API'lerine karşılık gelen işlemi kullandığında put SftpCreate bu olay tetiklenmektedir. Dosya açıldığında boş bir blob oluşturulur ve dosya kapatıldığında karşıya yüklenen içerik işlenir. SFTP Resumable Uploads Önizleme özelliği etkinleştirilirse, karşıya yükleme sırasında bazı SftpWrite olaylar da tetiklenir. |
Microsoft.Storage.BlobDeleted | Blob silindiğinde tetikleniyor. Özellikle, istemciler API'ye SftpRemove karşılık gelen işlemi çağırdığında rm da bu olay tetiklenmektedir. |
Microsoft.Storage.BlobRenamed | Blob yeniden adlandırıldığında tetikleniyor. Özellikle, istemciler API'ye karşılık gelen dosyalar üzerinde işlemi kullandığında rename SftpRename bu olay tetiklenmektedir. |
Microsoft.Storage.DirectoryCreated | Dizin oluşturulduğunda tetikleniyor. Özellikle, istemciler API'ye karşılık gelen işlemi kullandığında mkdir SftpMakeDir bu olay tetiklenmektedir. |
Microsoft.Storage.DirectoryRenamed | Dizin yeniden adlandırıldığında tetikleniyor. Özellikle, istemciler işlemi API'ye SftpRename karşılık gelen bir dizinde kullandığında rename bu olay tetiklenmektedir. |
Microsoft.Storage.DirectoryDeleted | Bir dizin silindiğinde tetikleniyor. Özellikle, istemciler API'ye karşılık gelen işlemi kullandığında rmdir SftpRemoveDir bu olay tetiklenmektedir. |
Örnek olaylar
Bir olay tetiklendiğinde Event Grid hizmeti bu olayla ilgili verileri abone olan uç noktaya gönderir. Bu bölüm, bu verilerin her blob depolama olayı için nasıl görüneceğine ilişkin bir örnek içerir.
Microsoft.Storage.BlobCreated olayı (SFTP)
Blob depolama hesabı bir blob oluşturmak veya üzerine yazmak için SFTP kullanıyorsa, veriler aşağıdaki değişiklikler dışında önceki örneğe benzer:
dataVersion
anahtar değerine ayarlanır3
.data.api
Anahtar ,SftpWrite
veyaSftpCommit
dizesineSftpCreate
ayarlanır.Anahtar
clientRequestId
dahil değildir.contentType
anahtar olarakapplication/octet-stream
ayarlanır.contentOffset
Anahtar, veri kümesine eklenir.identity
Anahtar, veri kümesine eklenir. Bu, SFTP kimlik doğrulaması için kullanılan yerel kullanıcıya karşılık gelir.
Not
SFTP karşıya yüklemeleri 2 olay oluşturur. Biri SftpCreate
dosyayı açarken oluşturulan ilk boş blob için, diğeri SftpCommit
de karşıya yüklemenin sonunda dosya içeriği işlendiğinde. SFTP Resumable Uploads
Önizleme özelliği etkinleştirilirse, karşıya yükleme sırasında bazı SftpWrite
olaylar da tetiklenir.
[{
"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 olayı (SFTP)
Blob depolama hesabı bir blobu silmek için SFTP kullanıyorsa veriler, bu değişiklikler dışında önceki örneğe benzer şekilde görünür:
dataVersion
anahtar değerine ayarlanır2
.data.api
anahtar dizesineSftpRemove
ayarlanır.Anahtar
clientRequestId
dahil değildir.contentType
anahtar olarakapplication/octet-stream
ayarlanır.identity
Anahtar, veri kümesine eklenir. Bu, SFTP kimlik doğrulaması için kullanılan yerel kullanıcıya karşılık gelir.
[{
"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 olayı (SFTP)
Blob depolama hesabı bir blobu yeniden adlandırmak için SFTP kullanıyorsa veriler, bu değişiklikler dışında önceki örneğe benzer şekilde görünür:
data.api
anahtar dizesineSftpRename
ayarlanır.Anahtar
clientRequestId
dahil değildir.identity
Anahtar, veri kümesine eklenir. Bu, SFTP kimlik doğrulaması için kullanılan yerel kullanıcıya karşılık gelir.
[{
"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 olayı (SFTP)
Blob depolama hesabı dizin oluşturmak için SFTP kullanıyorsa, veriler aşağıdaki değişiklikler dışında önceki örneğe benzer:
dataVersion
anahtar değerine ayarlanır2
.data.api
anahtar dizesineSftpMakeDir
ayarlanır.Anahtar
clientRequestId
dahil değildir.identity
Anahtar, veri kümesine eklenir. Bu, SFTP kimlik doğrulaması için kullanılan yerel kullanıcıya karşılık gelir.
[{
"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 olayı (SFTP)
Blob depolama hesabı bir dizini yeniden adlandırmak için SFTP kullanıyorsa veriler, bu değişiklikler dışında önceki örneğe benzer:
data.api
anahtar dizesineSftpRename
ayarlanır.Anahtar
clientRequestId
dahil değildir.identity
Anahtar, veri kümesine eklenir. Bu, SFTP kimlik doğrulaması için kullanılan yerel kullanıcıya karşılık gelir.
[{
"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 olayı (SFTP)
Blob depolama hesabı bir dizini silmek için SFTP kullanıyorsa veriler, bu değişiklikler dışında önceki örneğe benzer:
data.api
anahtar dizesineSftpRemoveDir
ayarlanır.Anahtar
clientRequestId
dahil değildir.identity
Anahtar, veri kümesine eklenir. Bu, SFTP kimlik doğrulaması için kullanılan yerel kullanıcıya karşılık gelir.
[{
"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"
}]
İlkeyle ilgili olaylar
Bu olaylar, bir ilke tarafından tanımlanan eylemler gerçekleştirildiğinde tetiklenir.
Olay adı | Açıklama |
---|---|
Microsoft.Storage.BlobInventoryPolicyCompleted | Envanter ilkesi tanımlanan bir kural için stok çalıştırması tamamlandığında tetiklenen. Bu olay, envanter çalıştırması çalışmaya başlamadan önce bir kullanıcı hatasıyla başarısız olursa da oluşur. Örneğin, geçersiz bir ilke veya hedef kapsayıcı mevcut olmadığında oluşan bir hata olayı tetikler. |
Microsoft.Storage.LifecyclePolicyCompleted | Bir yaşam döngüsü yönetim ilkesi tarafından tanımlanan eylemler gerçekleştirildiğinde tetiklenir. |
Örnek olaylar
Bir olay tetiklendiğinde Event Grid hizmeti bu olayla ilgili verileri abone olan uç noktaya gönderir. Bu bölüm, bu verilerin her blob depolama olayı için nasıl görüneceğine ilişkin bir örnek içerir.
Microsoft.Storage.BlobInventoryPolicyCompleted olayı
{
"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 olayı
{
"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"
}
Olay özellikleri
Bir olay aşağıdaki üst düzey verilere sahiptir:
Özellik | Türü | Veri Akışı Açıklaması |
---|---|---|
source |
Dize | Olay kaynağının tam kaynak yolu. Bu alan yazılabilir değil. Event Grid bu değeri sağlar. |
subject |
Dize | Olay konusunun yayımcı tarafından tanımlanan yolu. |
type |
Dize | Bu olay kaynağı için kayıtlı olay türlerinden biri. |
time |
Dize | Sağlayıcının UTC saati temelinde olayın oluşturulduğu saat. |
id |
Dize | Olayın benzersiz tanımlayıcısı. |
data |
nesne | Blob depolama olay verileri. |
specversion |
Dize | CloudEvents şema belirtimi sürümü. |
Veri nesnesi aşağıdaki özelliklere sahiptir:
Özellik | Türü | Veri Akışı Açıklaması |
---|---|---|
api |
Dize | Olayı tetikleyen işlem. |
clientRequestId |
Dize | depolama API'si işlemi için istemci tarafından sağlanan istek kimliği. Bu kimlik, günlüklerdeki "client-request-id" alanı kullanılarak Azure Depolama tanılama günlükleriyle ilişkilendirmek için kullanılabilir ve "x-ms-client-request-id" üst bilgisi kullanılarak istemci isteklerinde sağlanabilir. Bkz. Günlük Biçimi. |
requestId |
Dize | Depolama API'si işlemi için hizmet tarafından oluşturulan istek kimliği. Günlüklerdeki "request-id-header" alanı kullanılarak Azure Depolama tanılama günlükleri ile ilişkilendirmek için kullanılabilir ve 'x-ms-request-id' üst bilgisinde API çağrısı başlatılarak döndürülür. Bkz. Günlük Biçimi. |
eTag |
Dize | İşlemleri koşullu olarak çalıştırmak için kullanabileceğiniz değer. |
contentType |
Dize | Blob için belirtilen içerik türü. |
contentLength |
integer | Blobun bayt cinsinden boyutu. |
blobType |
Dize | Blob türü. Geçerli değerler "BlockBlob" veya "PageBlob" değerleridir. |
accessTier |
Dize | Blobun hedef katmanı. Yalnızca BlobTierChanged olayı için görünür. |
previousTier |
Dize | Blobun kaynak katmanı. Yalnızca BlobTierChanged olayı için görünür. Blob katmanı depolama hesabından çıkarıyorsa, bu alan görünmez. |
contentOffset |
Numara | Olay tetikleyen uygulamanın dosyaya yazmayı tamamladığı noktada gerçekleştirilen yazma işleminin bayt cinsinden uzaklığı. Yalnızca hiyerarşik ad alanına sahip blob depolama hesaplarında tetiklenen olaylar için görüntülenir. |
destinationUrl |
Dize | İşlem tamamlandıktan sonra var olacak dosyanın URL'si. Örneğin, bir dosya yeniden adlandırılırsa, destinationUrl özelliği yeni dosya adının URL'sini içerir. Yalnızca hiyerarşik ad alanına sahip blob depolama hesaplarında tetiklenen olaylar için görüntülenir. |
sourceUrl |
Dize | İşlem tamamlanmadan önce var olan dosyanın URL'si. Örneğin, bir dosya yeniden adlandırılırsa, sourceUrl yeniden adlandırma işleminden önce özgün dosya adının URL'sini içerir. Yalnızca hiyerarşik ad alanına sahip blob depolama hesaplarında tetiklenen olaylar için görüntülenir. |
url |
Dize | Blob yolu. İstemci bir Blob REST API kullanıyorsa, URL şu yapıya sahiptir: <storage-account-name>.blob.core.windows.net\<container-name>\<file-name> . İstemci bir Data Lake Storage REST API kullanıyorsa URL şu yapıya sahiptir: <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name> . |
recursive |
Dize | True tüm alt dizinlerde işlemi çalıştırmak için; aksi takdirde False . Yalnızca hiyerarşik ad alanına sahip blob depolama hesaplarında tetiklenen olaylar için görüntülenir. |
sequencer |
Dize | Belirli bir blob adı için olayların mantıksal sırasını temsil eden opak dize değeri. Kullanıcılar, aynı blob adındaki iki olayın göreli sırasını anlamak için standart dize karşılaştırmasını kullanabilir. |
identity |
Dize | Olayla ilişkili kimliği temsil eden bir dize değeri. SFTP için bu, yerel kullanıcı adıdır. |
storageDiagnostics |
nesne | Azure Depolama hizmeti tarafından zaman zaman eklenen tanılama verileri. Mevcut olduğunda, olay tüketicileri tarafından yoksayılmalıdır. |
Öğreticiler ve nasıl yapılır kılavuzları
Ünvan | Açıklama |
---|---|
Hızlı Başlangıç: Azure CLI ile Blob depolama olaylarını özel bir web uç noktasına yönlendirme | Web Kancası'na blob depolama olayları göndermek için Azure CLI'nin nasıl kullanılacağını gösterir. |
Hızlı Başlangıç: PowerShell ile Blob depolama olaylarını özel bir web uç noktasına yönlendirme | Blob depolama olaylarını Web Kancası'na göndermek için Azure PowerShell'in nasıl kullanılacağını gösterir. |
Hızlı Başlangıç: Azure portalı ile Blob depolama olaylarını oluşturma ve yönlendirme | Web Kancası'na blob depolama olayları göndermek için portalın nasıl kullanılacağını gösterir. |
Azure CLI: Blob depolama hesabı için olaylara abone olma | Blob depolama hesabı için olaya abone olan örnek betik. Olayı bir Web Kancası'na gönderir. |
PowerShell: Blob depolama hesabı için olaylara abone olma | Blob depolama hesabı için olaya abone olan örnek betik. Olayı bir Web Kancası'na gönderir. |
Resource Manager şablonu: Blob depolama ve abonelik oluşturma | Bir Azure Blob depolama hesabı dağıtır ve o depolama hesabı için olaylara abone olur. Olayları bir Web Kancasına gönderir. |
Genel bakış: Blob depolama olaylarına tepki verme | Blob depolamayı Event Grid ile tümleştirmeye genel bakış. |
Sonraki adımlar
- Azure Event Grid'e giriş için bkz. Event Grid nedir?
- Azure Event Grid aboneliği oluşturma hakkında daha fazla bilgi için bkz . Event Grid abonelik şeması.
- Blob depolama olaylarıyla çalışmaya giriş için bkz . Blob depolama olaylarını yönlendirme - Azure CLI.