Depolama görevi oluşturma

Depolama görevi, Azure Depolama hesabındaki bloblarda işlem gerçekleştirebilir. Görev oluştururken, her nesne (kapsayıcı veya blob) tarafından karşılanması gereken koşulları ve nesne üzerinde gerçekleştirilecek işlemleri tanımlayabilirsiniz. Ayrıca bir veya daha fazla Azure Depolama hesabı hedefi de belirleyebilirsiniz. Bkz. Azure Depolama Eylemleri nedir?

Bu nasıl yapılır makalesinde depolama görevi oluşturmayı öğreneceksiniz.

Depolama görevi oluşturma

Portal

Azure portalında Depolama Görevleri'ni arayın. Ardından Hizmetler'in altında Depolama görevleri - Azure Depolama Eylemleri'ne tıklayın.

Azure Depolama Eylemleri | Depolama Görevleri sayfasında Oluştur'u seçin.

Temel Bilgiler sekmesi

Temel Bilgiler sekmesinde, depolama göreviniz için temel bilgileri sağlayın. Aşağıdaki tabloda Temel Bilgiler sekmesindeki alanlar açıklanmaktadır .

Bölüm	Alan	Gerekli veya isteğe bağlı	Açıklama
Proje ayrıntıları	Abonelik	Zorunlu	Yeni depolama görevi için aboneliği seçin.
Proje ayrıntıları	Kaynak grubu	Zorunlu	Bu depolama görevi için yeni bir kaynak grubu oluşturun veya mevcut bir kaynak grubunu seçin. Daha fazla bilgi için bkz . Kaynak grupları.
Durum ayrıntıları	Depolama görevi adı	Zorunlu	Depolama göreviniz için benzersiz bir ad seçin. Depolama görevi adlarının uzunluğu 3 ile 18 karakter arasında olmalıdır ve yalnızca küçük harf ve sayı içerebilir.
Örnek ayrıntıları	Bölge	Zorunlu	Depolama göreviniz için uygun bölgeyi seçin. Daha fazla bilgi için bkz. Azure'da Bölgeler ve Erişilebilirlik Alanları.
Örnek ayrıntıları	Kullanıcı tarafından atanan kimlik	opsiyonel	isteğe bağlı olarak, kullanıcı tarafından atanan yönetilen kimliği bu depolama göreviyle ilişkilendirin. Kullanıcı tarafından atanan yönetilen kimlik, yönetilen kimlik, onu kullanan kaynaklardan ayrı olarak yönetilen tek başına bir Azure kaynağı olarak temsil edilir. Birini daha sonra ilişkilendiremezsiniz. Bu nedenle, kullanıcı tarafından atanan bir yönetilen kimlik kullanmak istiyorsanız, depolama görevini oluştururken birini seçmeniz gerekir. Varsayılan olarak, depolama görevi sağlandığında sistem tarafından atanan bir yönetilen kimlik oluşturulur. Daha fazla bilgi edinmek için bkz . Depolama görevi ataması Kullanıcı tarafından atanan yönetilen kimliği seçmek için Kimlik seçin'i seçin. Kullanıcı tarafından atanan yönetilen kimliği seçin sayfasında, yönetilen kimliği filtreleyin ve seçin. Ardından Ekle'yi seçin. Kullanıcı tarafından atanan yönetilen kimliği yalnızca depolama görevi oluştururken ekleyebilirsiniz.

Aşağıdaki resimde Temel Bilgiler sekmesinin bir örneği gösterilmektedir .

Koşullar sekmesi

Koşullar sekmesinde, her nesne (kapsayıcı veya blob) tarafından karşılanması gereken koşulları ve nesne üzerinde gerçekleştirilecek işlemleri tanımlayın.

En az bir koşul ve bir işlem tanımlamanız gerekir. Bir koşula yan tümce eklemek için Yeni yan tümce ekle'yi seçin. İşlem eklemek için Yeni işlem ekle'yi seçin.

Aşağıdaki tabloda, Koşullar sekmesindeki alanlar açıklanmaktadır.

Bölüm	Alan	Gerekli veya isteğe bağlı	Açıklama
Eğer	Ve/Veya	Zorunlu	İki veya daha fazla koşulu bir araya getirerek mantıksal AND veya mantıksal OR ifadesi oluşturan bir işleç.
Eğer	Blob özelliği	Zorunlu	Kullanmak istediğiniz blob veya kapsayıcı özelliği yan tümcede yer alır. Bkz. Desteklenen blob özellikleri
Eğer	Operatör	Zorunlu	Cümledeki her özelliğin karşılık gelen değerle ilişkisini tanımlayan işleç. Bkz. Desteklenen işleçler
Eğer	Özellik değeri	Zorunlu	İlgili özellik ile ilişkili değer.
Ardından	Operasyonlar	Zorunlu	Nesneler bu görevde tanımlanan koşulları karşıladığında gerçekleştirilecek eylem. Bkz. Desteklenen işlemler
Ardından	Parametre	Zorunlu	İşlem tarafından kullanılan bir değer.

Aşağıdaki görüntüde Koşullar sekmesinin bir örneği gösterilmektedir.

Tanımladığınız koşullardan etkilenecek blobların listesini görüntülemek için Önizleme Koşulları'nı seçebilirsiniz. Daha fazla bilgi edinmek için bkz. Koşulların etkisini önizleme.

Atamalar sekmesi

Atama, görevin hedeflediği depolama hesabını ve bu hesaptaki nesnelerin bir alt kümesini tanımlar. Atama ayrıca görevin ne zaman çalıştığını ve yürütme raporlarının nerede depolandığını tanımlar.

Ödev eklemek için Ödev ekle'yi seçin. Bu adım isteğe bağlıdır. Görevi oluşturmak için atama eklemeniz gerekmez.

Aşağıdaki tabloda, Atama ekle bölmesinde görüntülenen alanlar açıklanmaktadır.

depolama görevinin sistem tarafından atanan yönetilen kimliğine atamak istediğiniz rolü seçin. Başarılı bir görev ataması sağlamak için Blob Veri Sahibi izinlerine sahip rolleri kullanın. Daha fazla bilgi edinmek için bkz. Depolama görevleri için Azure rolleri

Bölüm	Alan	Gerekli veya isteğe bağlı	Açıklama
Kapsam seçin	Abonelik	Zorunlu	Bu atamaya eklemek istediğiniz depolama hesabının aboneliği.
Kapsam seçin	Depolama hesabı seçin	Zorunlu	Bu atamaya eklemek istediğiniz depolama hesabı.
Kapsam seçin	Atama adı	Zorunlu	Atamanın adı. Atama adları 2 ile 62 karakter uzunluğunda olmalıdır ve yalnızca harf ve sayı içerebilir.
Rol ataması	Atama adı	Zorunlu	Depolama görevinin yönetilen kimliğine atamak istediğiniz rol. Hangi rolü seçeceğiniz hakkında daha fazla bilgi edinmek için bkz. bir görevin işlem gerçekleştirme izni.
Nesneleri filtrele	Filtrele	Zorunlu	Nesneleri ön ek kullanarak filtreleme veya görevi depolama hesabının tamamında çalıştırma seçeneği.
Nesneleri filtrele	Blob ön ekleri	İsteğe bağlı	Görev tarafından değerlendirilen blobların kapsamını daraltmak için kullanılan dize ön eki. Bu alan yalnızca blob ön eki kullanarak filtrelemeyi seçerseniz gereklidir.
Tetikleyici ayrıntıları	Çalıştırma sıklığı	Zorunlu	Görevi bir veya birden çok kez çalıştırma seçeneği.
Tetikleyici ayrıntıları	Başlangıçtan	Zorunlu	Görevi çalıştırmaya başlamak için tarih ve saat.
Tetikleyici ayrıntıları	Son tarihi	Zorunlu	Görevi çalıştırmayı durduracak tarih ve saat.
Tetikleyici ayrıntıları	Çok yinele (gün olarak)	Zorunlu	Çalıştırmalar arasındaki aralık, gün cinsinden.
Tetikleyici ayrıntıları	Rapor dışarı aktarma kapsayıcısı	Zorunlu	Görev yürütme raporlarının depolandığı kapsayıcı.

Aşağıdaki görüntüde Atama ekle bölmesinin bir örneği gösterilmektedir.

Etiketler sekmesi

Etiketler sekmesinde, Azure kaynaklarınızı düzenlemenize yardımcı olacak Resource Manager etiketleri belirtebilirsiniz. Daha fazla bilgi için, bkz. Mantıksal kuruluş için kaynakları, kaynak gruplarını ve abonelikleri etiketleme.

Aşağıdaki görüntüde, yeni bir depolama hesabı için dizin etiketi özelliklerinin standart yapılandırması gösterilmektedir.

Gözden geçirme ve oluşturma sekmesi

Gözden Geçir ve oluştur sekmesine gittiğinizde, Azure seçtiğiniz depolama görevi ayarlarında doğrulamayı çalıştırır. Doğrulama başarılı olursa, depolama görevini oluşturmaya devam edebilirsiniz.

Doğrulama başarısız olursa portal hangi ayarların değiştirilmesi gerektiğini gösterir.

Aşağıdaki görüntüde , yeni bir depolama görevi oluşturulmadan önce Gözden Geçir sekmesi verileri gösterilmektedir.

PowerShell

1. İlk olarak, gerekli PowerShell modüllerini yükleyin. Bkz . PowerShell modülünü yükleme

2. JSON kullanarak bir koşul tanımlayın. Bir veya daha fazla yan tümceden oluşan bir koşul. Her yan tümce bir özellik, değer ve işleç içerir. Daha fazla bilgi edinmek için Depolama görevi koşulları konusuna bakın.

   $condition = "<condition-json>"
   

3. New-AzStorageActionTaskOperationObject komutunu kullanarak her işlemi tanımlayın. Daha fazla bilgi edinmek için bkz . Depolama görevi işlemleri

    $operation = New-AzStorageActionTaskOperationObject `
    -Name "<operation-name>" `
    -Parameter @{"<parameter-name>"= "<parameter-value"} `
    -OnFailure break `
    -OnSuccess continue
   
   

4. New-AzStorageActionTask komutunu kullanarak bir depolama görevi oluşturun ve tanımladığınız tüm koşulları ve işlemleri geçirin. Aşağıdaki komut bir depolama görevi oluşturur ve görevin sistem tarafından yönetilen kimliğini etkinleştirir. Depolama görevi atamaları, erişimi yetkilendirmek için bu sistem tarafından yönetilen kimliğe uygulanan izinleri kullanır.

   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -EnableSystemAssignedIdentity:$true
   

   Atamaların kullanıcı tarafından atanan yönetilen kimliği kullanarak yetkilendirmesini istiyorsanız, bu kimliği New-AzStorageActionTask komutuna parametre olarak sağlamanız gerekir. Aşağıdaki komut bir depolama görevi oluşturur ve kullanıcı tarafından atanan yönetilen kimliği belirtir. Depolama görevi atamaları, erişimi yetkilendirmek için kullanıcı tarafından atanan yönetilen kimliğe uygulanan izinleri kullanır.

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -UserAssignedIdentity $managedIdentity.Id
   

   PowerShell kullanarak atama oluşturmayı öğrenmek için bkz. Depolama görevi ataması oluşturma ve yönetme.

Azure CLI

1. JSON kullanarak bir koşul tanımlayın. Bir veya daha fazla yan tümceden oluşan bir koşul. Her yan tümce bir özellik, değer ve işleç içerir. Daha fazla bilgi edinmek için Depolama görevi koşulları konusuna bakın.

   conditionclause="<condition-json>"
   

   Tavsiye

   Azure CLI, kısaltılmış söz dizimi kullanır. Kısaltma söz dizimi, bir JSON dizesinin basitleştirilmiş bir gösterimidir. Daha fazla bilgi edinmek için bkz. Azure CLI ile kısaltma söz dizimlerini kullanma.

2. az storage-actions task create komutunu kullanarak bir depolama görevi oluşturun ve koşulların ve işlemlerin JSON biçimli bir ifadesini geçirin. Bu örnek, serin katmandaki blobları bulur ve sıcak katmana taşır. Diğer tüm bloblar silinir. Aşağıdaki komut bir depolama görevi oluşturur ve sistem tarafından atanan yönetilen kimliği belirtir. Depolama görevi atamaları, erişimi yetkilendirmek için sistem tarafından atanan yönetilen kimliğe uygulanan izinleri kullanır.

   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity "{type:SystemAssigned}" \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   Atamaların kullanıcı tarafından atanan yönetilen kimliği kullanarak yetkilendirmesini istiyorsanız, az storage-actions task create komutuna parametre olarak bu kimliği sağlamanız gerekir. Aşağıdaki komut bir depolama görevi oluşturur ve kullanıcı tarafından atanan yönetilen kimliği belirtir. Depolama görevi atamaları, erişimi yetkilendirmek için kullanıcı tarafından atanan yönetilen kimliğe uygulanan izinleri kullanır.

   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity $identityId \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   İşlemler hakkında daha fazla bilgi edinmek için bkz . Depolama görevi işlemleri.

   Azure CLI kullanarak atama oluşturmayı öğrenmek için bkz. Depolama görevi ataması oluşturma ve yönetme.

Biceps

Bicep şablonunuzda aşağıdakine benzer bir kod parçacığı ekleyin. Bu örnek, Word belgeleri üzerinde bir değişmezlik ilkesi ayarlar.

Tam bir örnek için bkz . Hızlı Başlangıç: Bicep ile depolama görevi oluşturma.

resource storageTask 'Microsoft.StorageActions/storageTasks@2023-01-01' = {
  name: storageTaskName
  location: 'westus'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    action: {
      if: {
        condition: '[[endsWith(Name, \'.docx\')]]'
        operations: [
         {
            name: 'SetBlobImmutabilityPolicy'
            onSuccess: 'continue'
            onFailure: 'break'
            parameters: {
              untilDate: '2025-06-20T20:34:00'
              mode: 'locked'
            }
         }
        ]
      }

    }
    description: 'My storage task'
    enabled: true
  }
}

Şablon

Azure Resource Manager şablonunuzda aşağıdakine benzer bir JSON kod parçacığı ekleyin. Bu örnek, Word belgeleri üzerinde bir değişmezlik ilkesi ayarlar.

Tam bir örnek için bkz . Hızlı Başlangıç: ARM şablonuyla depolama görevi oluşturma.

 "resources": [
    {
      "type": "Microsoft.StorageActions/storageTasks",
      "apiVersion": "2023-01-01",
      "name": "mystoragetask",
      "location": "westus",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "action": {
          "if": {
            "condition": "[[[endsWith(Name, '.docx')]]",
            "operations": [
              {
                "name": "SetBlobImmutabilityPolicy",
                "onSuccess": "continue",
                "onFailure": "break",
                "parameters": {
                  "untilDate": "2025-06-20T20:34:00",
                  "mode": "locked"
                }
              },
            ]
          }
        },
        "description": "my storage task",
        "enabled": true
      }
    }
  ]

Ayrıca bkz.

• Azure Depolama Eylemlerine genel bakış
• Depolama görevi oluşturma, atama ve çalıştırma
• Koşulları ve işlemleri tanımlama