Event Grid kaynağı olarak Azure Blob Depolama

  • Makale

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 Depolama V2 (genel amaçlı v2), BlockBlob Depolama ve Blob Depolama 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. Depolama. BlobOluştur Blob oluşturulduğunda veya değiştirildiğinde tetikleniyor.
Özellikle, istemciler Blob REST API'sinde kullanılabilen , PutBlockListveya CopyBlob işlemlerini kullandığında PutBlobve Blok Blobu tamamen işlendiğinde bu olay tetiklenir.
İstemciler, hiyerarşik ad alanı özelliğinin etkinleştirildiği hesaplarda işlemi kullanırsaCopyBlob, CopyBlob işlem biraz farklı çalışır. Bu durumda Microsoft.Depolama. Blok Blobu tamamen işlendiğinde CopyBlob değil, işlem başlatıldığında BlobOluşturma olayı tetiklendi.
Microsoft. Depolama. BlobDeleted Blob silindiğinde tetikleniyor.
Özellikle, istemciler Blob REST API'sinde kullanılabilen işlemi çağırdığında DeleteBlob bu olay tetiklenir.
Microsoft. Depolama. 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. Depolama. 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. Depolama. 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",
    "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. Depolama. 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",
    "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. Depolama. 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",
		"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. Depolama. 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 Depolama 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. Depolama. BlobOluştur 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. Depolama. 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. Depolama. 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. Depolama. Dizin Oluşturma 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. Depolama. 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. Depolama. DizinDeleted 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

microsoft.Depolama emin olmak istiyorsanız Azure Data Lake Storage 2. Nesil için. BlobCreated olayı yalnızca Bir Blok Blobu tamamen işlendiğinde tetiklenir ve REST API çağrısı için FlushWithClose olayı filtreleyin. Bu API çağrısı Microsoft.Depolama tetikler. BlobCreated olayı yalnızca veriler Bir Blok Blobu'na tamamen işlendikten sonra oluşturulduğunda. Filtre oluşturmayı öğrenmek için bkz . Event Grid için olayları filtreleme.

Örnek olaylar

Microsoft. Depolama. 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 veya FlushWithClosedizesine CreateFile 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. Depolama. 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 dizesine DeleteFileayarlanır.
  • url anahtarı yolunu dfs.core.windows.netiç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. Depolama. 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. Depolama. 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. Depolama. 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. Depolama. 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. Depolama. BlobOluştur 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 putSftpCreate 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.
Microsoft. Depolama. 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. Depolama. BlobRenamed Blob yeniden adlandırıldığında tetikleniyor.
Özellikle, istemciler API'ye karşılık gelen dosyalar üzerinde işlemi kullandığında renameSftpRename bu olay tetiklenmektedir.
Microsoft. Depolama. Dizin Oluşturma Dizin oluşturulduğunda tetikleniyor.
Özellikle, istemciler API'ye karşılık gelen işlemi kullandığında mkdirSftpMakeDir bu olay tetiklenmektedir.
Microsoft. Depolama. 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. Depolama. DizinDeleted Bir dizin silindiğinde tetikleniyor.
Özellikle, istemciler API'ye karşılık gelen işlemi kullandığında rmdirSftpRemoveDir 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. Depolama. 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 veya SftpCommitdizesine SftpCreate ayarlanır.

  • Anahtar clientRequestId dahil değildir.

  • contentType anahtar olarak application/octet-streamayarlanı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 dosya içeriği yazıldığında.

[{
  "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. Depolama. 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 dizesine SftpRemoveayarlanır.

  • Anahtar clientRequestId dahil değildir.

  • contentType anahtar olarak application/octet-streamayarlanı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. Depolama. 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 dizesine SftpRenameayarlanı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. Depolama. 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 dizesine SftpMakeDirayarlanı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. Depolama. 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 dizesine SftpRenameayarlanı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. Depolama. 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 dizesine SftpRemoveDirayarlanı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"
}]

Bu olaylar, bir ilke tarafından tanımlanan eylemler gerçekleştirildiğinde tetiklenir.

Olay adı Açıklama
Microsoft. Depolama. 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. Depolama. 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. Depolama. 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. Depolama. 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": ""
        },
        "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.
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 Data Lake Depolama 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 Tanılama verileri bazen Azure Depolama hizmeti tarafından dahil olur. 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