Aracılığıyla paylaş

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 , PutBlobveya PutBlockList işlemlerini kullandığında CopyBlobve Blok Blobu tamamen işlendiğinde bu olay tetiklenir.
İstemciler, hiyerarşik ad alanıCopyBlobetkinleştirildiği hesaplarda işlemi kullanırsa, CopyBlob işlem biraz farklı çalışır. CopyBlob İşlem hemen tamamlanırsa, blok blobu tamamen işlendiğinden Microsoft.Storage.BlobCreated olayı tetiklenmiş olur. Ancak, işlem hemen tamamlanmazsa, bunun yerine, Microsoft.Storage.AsyncOperationInitiated olayı tetiklenir, bu da CopyBlob işlemin başlatıldığı ancak blok blobunun henüz tamamen yerleştirilmediği anlamına gelir.
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.
bu olay, istemcilerin CopyBlobhiyerarşik ad alanı özelliğinin etkinleştirildiği hesaplarda işlemi kullanması ve işlemin hemen tamamlanmaması durumunda da tetiklenebilir. Bu durumda, Microsoft.Storage.AsyncOperationInitiated olayının tetiklenmesi, işlemin başlatıldığını ancak blok blobunun henüz tamamen kaydedilmediğini belirtir. Blok blobu tamamen işlendikten sonra, tamamlanmayı onaylamak için son bir Microsoft.Storage.BlobCreated olayı tetiklanır.

Ö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 CreateFile işlemlerini kullandığında FlushWithClose 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.DizinOluşturuldu 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 veya CreateFiledizesine FlushWithClose 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 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.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 put API'lerine karşılık gelen işlemi kullandığında SftpCreateSftpCommit 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 rm karşılık gelen işlemi çağırdığında SftpRemove 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 renameSftpRename bu olay tetiklenmektedir.
Microsoft.Storage.DizinOluşturuldu Dizin oluşturulduğunda tetikleniyor.
Özellikle, istemciler API'ye karşılık gelen işlemi kullandığında mkdirSftpMakeDir bu olay tetiklenmektedir.
Microsoft.Storage.DirectoryRenamed Dizin yeniden adlandırıldığında tetikleniyor.
Özellikle, istemciler işlemi API'ye rename karşılık gelen bir dizinde kullandığında SftpRename bu olay tetiklenmektedir.
Microsoft.Storage.DirectoryDeleted 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.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 , SftpCreateveya SftpWritedizesine SftpCommitayarlanı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 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 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.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 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.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 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.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 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.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 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.Storage.BlobInventoryPolicyCompleted (Microsoft Depolama Blob Envanter Politikası Tamamlandı) 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ü Açıklama
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ü Açıklama
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 tamsayı 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

  • Last updated on