Depolama görevi ataması oluşturun ve yönetin

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.

Bu makale, bir atama oluşturmanıza ve ardından bu atamanın çalıştırılmasını etkinleştirmenize yardımcı olur. Depolama görevi atamaları hakkında daha fazla bilgi edinmek için bkz . Depolama görevi atamaları.

Önemli

Depolama görevi atamasını etkinleştirmeden önce, her hedef depolama hesabının ağ ayarlarında güvenilen Azure hizmetlerine erişim izni verin. Daha fazla bilgi edinmek için Güvenilen Azure hizmetlerine erişim izni verme bölümüne bakın.

Atama oluşturma ve yönetme

Hedeflemek istediğiniz her depolama hesabı için bir atama oluşturun. Depolama görevi en fazla 50 atama içerebilir.

Uyarı

Geçerli sürümde, yalnızca depolama görevleriyle aynı bölgede yer alan depolama hesaplarını hedefleyebilirsiniz.

Portal

Depolama görevi menüsünden atama oluşturma

Depolama görevi bağlamında atama oluşturabilirsiniz. Görev yazarıysanız ve birden çok depolama hesabını hedeflemek istiyorsanız bu seçenek kullanışlı olabilir. Her atama için hedeflemek istediğiniz depolama hesabını tanımlayacaksınız.

Azure portalında depolama görevine gidin ve Depolama görevi yönetimi'nin altında Atamalar'ı seçin.

Atamalar sayfasında + Ödev ekle'yi seçtiğinizde Atama ekle bölmesi görüntülenir.

Depolama hesabı menüsünden atama oluşturma

Ayrıca, depolama hesabı bağlamında bir atama da oluşturabilirsiniz. Depolama hesabınızdaki nesneleri işlemek için mevcut bir görevi kullanmak istiyorsanız bu seçenek kullanışlı olabilir. Her atama için, hesabınıza atamak istediğiniz depolama görevini tanımlayacaksınız.

Azure portalında depolama hesabına gidin ve Veri yönetimi'nin altında Depolama görevleri'ni seçin.

Depolama görevleri sayfasında Görev ataması sekmesini, + Atama oluştur'u ve ardından + Atama ekle'yi seçin.

Ödev ekle bölmesi görüntülenir.

Kapsam seçin

Kapsam seçin bölümünde bir abonelik seçin ve atamayı adlandırın. Ardından hedeflemek istediğiniz depolama hesabını seçin.

Atama ekle bölmesini depolama hesabı bağlamında açtıysanız depolama hesabı yerine bir depolama görevi seçersiniz.

Her özelliğin açıklaması için bkz . Atama ayarları.

Rol ataması ekleme

Rol ataması bölümündeki Rol açılan listesinde, depolama görevinin 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. Görevleri atamak için gereken Azure rolleri.

Uyarı

Depolama görevini oluşturma işleminin bir parçası olarak yönetilen kimlik türünü (sistem tarafından atanan veya kullanıcı tarafından atanan) seçersiniz.

Her özelliğin açıklaması için bkz . Atama ayarları.

Filtre ekleyin

Nesneleri filtrele bölümünde, bir filtreye göre blobların bir alt kümesini hedeflemek isteyip istemediğinizi seçin. Filtreler, yürütme kapsamını daraltmanıza yardımcı olur. Eğer görevin bir hesaptaki tüm kapsayıcıları ve blobları değerlendirmesini istiyorsanız, Filtreleme yok seçeneğini belirleyebilirsiniz. Aşağıdaki örnek, yalnızca adlı mycontainerbir kapsayıcıda bulunan blobları hedeflemek için bir filtre kullanır.

Her özelliğin açıklaması için bkz . Atama ayarları.

Tetikleyiciyi tanımlama

Tetikleyici ayrıntıları bölümünde, bu görevin nasıl çalışmasını istediğinizi seçin. Aşağıdaki çalıştırma türleri arasından seçim yapabilirsiniz:

• Bir kez çalıştır: Görevi tek bir kez yürütür.
• Yinelenen çalıştırma: Görevi yinelenen bir zamanlamaya göre çalıştırın. Bir başlangıç ve bitiş saati seçin ve her çalıştırma arasındaki gün sayısını belirtin.
• Sahte çalıştırma: Bloblarda herhangi bir işlem gerçekleştirmeden görev yürütme benzetimi yapın. Deneme çalıştırması, blob’ları görev koşullarına göre tarayıp değerlendirir ve hangi blob’ların eşleştiğini ve hangi işlemlerin gerçekleştirileceğini gösteren ayrıntılı bir rapor oluşturur. Hiçbir veri değiştirilmez. Daha fazla bilgi için Deneme çalıştırması oluşturma ve kullanma bölümüne bakın.

Tüm çalıştırma türleri için yürütme raporlarını depolamak istediğiniz yeri belirtin.

Her özelliğin açıklaması için bkz . Atama ayarları.

Ödevi kaydetme

Ödevi oluşturmak için Ekle düğmesini seçin.

Atama ekle bölmesi kapanır. Dağıtım tamamlandığında atama Atamalar sayfasında görünür. Ödevi bu sayfada görmüyorsanız Yenile düğmesini seçin.

Atamayı etkinleştirme

Atama varsayılan olarak devre dışıdır. Atamanın çalışmasını zamanlamak ve etkinleştirmek için, atamanın yanında görünen onay kutusunu seçin ve ardından Etkinleştir seçin.

Görev çalıştırıldıktan sonra bir yürütme raporu oluşturulur ve atamayı oluştururken belirttiğiniz kapsayıcıda depolanır. Bu rapor hakkında daha fazla bilgi ve hedeflenen nesne sayısını, denenen işlem sayısını ve başarılı olan işlem sayısını yakalayan ölçümleri görüntüleme hakkında daha fazla bilgi için bkz. Depolama görevi çalıştırmalarını analiz etme.

Ödevi düzenleme

Atama, hedeflenen depolama hesabının alt kaynağı olur. Bu nedenle, atamayı oluşturduktan sonra yalnızca çalışma sıklığını düzenleyebilirsiniz. Atamanın diğer alanları salt okunur hale gelir. Tek çalıştırma (yalnızca bir kez) seçeneği de salt okunur hale gelir.

• Atamanın çalışma sıklığını depolama görevi bağlamında düzenlemek için Azure portalında depolama görevine gidin ve Depolama görevi yönetimi'nin altında Atamalar'ı seçin.

• Atamanın çalışma sıklığını depolama hesabı bağlamında düzenlemek için Azure portalında depolama hesabına gidin ve Veri yönetimi'nin altında Depolama görevleri'ni seçin.

PowerShell

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

2. Görevin ne sıklıkta çalıştırılmasını istediğinizi belirtin. Bir görevi yalnızca bir kez çalıştırmayı veya yinelenen görevi çalıştırmayı seçebilirsiniz. Bu görevi yinelenen olarak çalıştırmaya karar verirseniz, bir başlangıç ve bitiş saati belirtin ve her çalıştırma arasındaki gün sayısını belirtin. Yürütme raporlarını depolamak istediğiniz yeri de belirtebilirsiniz. Aşağıdaki örnek tetikleyici değerleri için değişken oluşturur.

   $startTime = $startTime = (Get-Date).AddMinutes(10) 
   $reportPrefix = "my-storage-task-report"
   $triggerType = RunOnce
   $targetPrefix = "mycontainer/"
   

3. Get-AzStorageActionTask komutunu kullanarak atamanıza eklemek istediğiniz depolama görevini alın.

   $task = Get-AzStorageActionTask -Name <"storage-task-name"> -ResourceGroupName "<resource-group>"
   

4. New-AzStorageTaskAssignment komutunu kullanarak bir depolama görevi ataması oluşturun. Aşağıdaki atama, mycontainer kapsayıcısını mystorageaccount adlı bir hesabın hedefler. Bu atama, görevin yalnızca bir kez çalışacağını ve yürütme raporlarını adlı storage-tasks-reportbir klasöre kaydedeceğini belirtir. Görev, şu andan itibaren 10 dakika sonra çalışacak şekilde zamanlanmıştır.

   New-AzStorageTaskAssignment `
   -ResourceGroupName "<resource-group>" `
   -AccountName "<storage-account-name>" `
   -name "<storage-task-assignment-name>" `
   -TaskId $task.ID `
   -ReportPrefix $reportPrefix `
   -TriggerType $triggerType `
   -StartOn $startTime.ToUniversalTime() `
   -Description "<description>" `
   -Enabled:$true `
   -TargetPrefix $targetPrefix
   

5. Yönetilen kimliğe bir rol atayarak depolama görevine hedef depolama hesabında işlem gerçekleştirme izni verin. Depolama görevini oluştururken yönetilen kimlik türünü (sistem tarafından atanan veya kullanıcı tarafından atanan) seçebilirsiniz.

   Aşağıdaki komutlar, Storage Blob Data Owner rolünü depolama görevinin sistem tarafından atanan yönetilen kimliğine atar.

   New-AzRoleAssignment `
   -ResourceGroupName "<resource-group>" `
   -ResourceName "<storage-account-name>" `
   -ResourceType "Microsoft.Storage/storageAccounts" `
   -ObjectId $task.IdentityPrincipalId  `
   -RoleDefinitionName "Storage Blob Data Owner"
   

   Aşağıdaki komutlar, rolü Storage Blob Data Owner kullanıcı tarafından atanan yönetilen kimliğe atar.

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   New-AzRoleAssignment `
   -ResourceGroupName "<resource-group>" `
   -ResourceName "<storage-account-name>" `
   -ResourceType "Microsoft.Storage/storageAccounts" `
   -ObjectId $managedIdentity.Id  `
   -RoleDefinitionName "Storage Blob Data Owner"
   

Azure CLI

Azure CLI kullanarak atama oluşturma

1. Görevin ne sıklıkta çalıştırılmasını istediğinizi belirtin. Bir görevi yalnızca bir kez çalıştırmayı veya yinelenen görevi çalıştırmayı seçebilirsiniz. Bu görevi yinelenen olarak çalıştırmaya karar verirseniz, bir başlangıç ve bitiş saati belirtin ve her çalıştırma arasındaki gün sayısını belirtin. Yürütme raporlarını depolamak istediğiniz yeri de belirtebilirsiniz. Aşağıda kapsayıcı adını, görev çalıştırma sıklığını ()RunOnce ve raporu çalıştırma süresini belirten JSON biçimli bir dize değişkeni oluşturulur.

      current_datetime=$(date +"%Y-%m-%dT%H:%M:%S")
      executioncontextvariable="{target:{prefix:[mycontainer/],excludePrefix:[]},trigger:{type:'RunOnce',parameters:{startOn:'"${current_datetime}"'}}}"
   

   içinde executioncontextvariable kullanılan dize, kısaltma söz dizimi kullanılarak ifade edilir. 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 show komutunu kullanarak ve ardından özelliği sorgulayarak atamanıza eklemek istediğiniz depolama görevinin id kimliğini alın.

 id=$(az storage-actions task show -g "<resource-group>" -n "<storage-task-name>" --query "id")

3. az storage account task-assignment create komutunu kullanarak bir depolama görevi ataması oluşturun.

   az storage account task-assignment create \
      -g '<resource-group>' \
      -n '<storage-task-assignment-name>' \
      --account-name '<storage-account-name>' \
      --description '<description>' \
      --enabled true \
      --task-id $id \
      --execution-context $executioncontextvariable \
      --report "{prefix:storage-tasks-report}"
   

4. Yönetilen kimliğe bir rol atayarak depolama görevine hedef depolama hesabında işlem gerçekleştirme izni verin. Depolama görevini oluştururken yönetilen kimlik türünü (sistem tarafından atanan veya kullanıcı tarafından atanan) seçebilirsiniz.

   Aşağıdaki komutlar, Storage Blob Data Owner rolünü depolama görevinin sistem tarafından atanan yönetilen kimliğine atar.

   $storageAccountID=az storage account show --name <storage-account-name> --resource-group <resource-group> --query "id"
   $roleDefinitionId="b7e6dc6d-f1e8-4753-8033-0f276bb0955b" \
   
   
   az role assignment create \
      --assignee-object-id $principalID \
      --scope $storageAccountID \
      --role $roleDefinitionId \
      --description "My role assignment" 
   

   Aşağıdaki komutlar, rolü Storage Blob Data Owner kullanıcı tarafından atanan yönetilen kimliğe atar.

   $storageAccountID=az storage account show --name <storage-account-name> --resource-group <resource-group> --query "id"
   $roleDefinitionId="b7e6dc6d-f1e8-4753-8033-0f276bb0955b"
   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
    az role assignment create \
    --assignee-object-id $identityId 
      --role $roleDefinitionId \
      --description "My role assignment" 
   

Biceps

Bicep şablonunuzda aşağıdakine benzer bir kod parçacığı ekleyin.

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-02-01' = {
  name: 'mystorageaccount'
  location: 'westus'
  kind: 'StorageV2'
  sku: {
    name: 'Standard_LRS'
  }
}

resource storageAccountName_storageTaskAssignment 'Microsoft.Storage/storageAccounts/storageTaskAssignments@2023-05-01' = {
  parent: storageAccount
  name: 'mystoragetaskassignment'
  properties: {
    taskId: '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.StorageActions/storageTasks/mystoragetask'
    enabled: true
    executionContext: {
      target: {
        prefix: [
          'mycontainer/'
        ]
        excludePrefix: []
      }
      trigger: {
        type: 'RunOnce'
        parameters: {
          startOn: '2025-04-20T21:34:00'
        }
      }
    }
    report: {
      prefix: 'storage-tasks-report'
    }
    description: 'mystoragetaskassignment'
  }
}

Şablon

Azure Resource Manager şablonunuzda aşağıdakine benzer bir JSON kod parçacığı ekleyin.

  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-02-01",
      "name": "mystorageaccount",
      "location": "westus",
      "kind": "StorageV2",
      "sku": {
        "name": "Standard_LRS"
      }
    },
    {
      "type": "Microsoft.Storage/storageAccounts/storageTaskAssignments",
      "apiVersion": "2023-05-01",
      "name": "storagetaskassignmentname",
      "properties": {
        "taskId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.StorageActions/storageTasks/mystoragetask",
        "enabled": true,
        "executionContext": {
          "target": {
            "prefix": [
              "mycontainer/"
            ],
            "excludePrefix": []
          },
          "trigger": {
            "type": "RunOnce",
            "parameters": {
              "startOn": "2025-04-20T21:34:00"
            }
          }
        },
        "report": {
          "prefix": "storage-tasks-report"
        },
        "description": "[parameters('storageTaskAssignmentDescription')]"
      },
      "dependsOn": [
        "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount"
      ]
    }
  ]

Ayrıca bakınız

• Depolama görevi atamaları
• Azure Depolama Eylemlerine genel bakış
• Depolama görev çalıştırmalarının analizi