Membuat dan mengelola penetapan tugas penyimpanan

Penugasan mengidentifikasi akun penyimpanan dan subset objek di akun tersebut yang akan ditargetkan tugas. Penugasan juga menentukan kapan tugas berjalan dan di mana laporan eksekusi disimpan.

Artikel ini membantu Anda membuat tugas, lalu mengaktifkan penugasan tersebut untuk dijalankan. Untuk mempelajari selengkapnya tentang penetapan tugas penyimpanan, lihat Penetapan tugas penyimpanan.

Penting

Sebelum Mengaktifkan penetapan tugas penyimpanan, pastikan Anda memberikan akses ke layanan Azure tepercaya di pengaturan jaringan setiap akun penyimpanan target. Untuk mempelajari selengkapnya, lihat Memberikan akses ke layanan Azure tepercaya.

Membuat dan mengelola penugasan

Buat penugasan untuk setiap akun penyimpanan yang ingin Anda targetkan. Tugas penyimpanan dapat berisi hingga 50 penugasan.

Nota

Dalam rilis saat ini, Anda hanya dapat menargetkan akun penyimpanan yang berada di wilayah yang sama dengan tugas penyimpanan.

Portal

Membuat penugasan dari menu tugas penyimpanan

Anda dapat membuat tugas dalam konteks tugas penyimpanan. Opsi ini bisa lebih mudah jika Anda adalah penulis tugas dan Anda ingin menargetkan beberapa akun penyimpanan. Untuk setiap penugasan, Anda akan mengidentifikasi akun penyimpanan yang ingin Anda targetkan.

Navigasi ke tugas penyimpanan di portal Microsoft Azure lalu di bawah Manajemen tugas penyimpanan, pilih Penugasan.

Di halaman Penugasan , pilih + Tambahkan penugasan dan panel Tambahkan penugasan akan muncul.

Membuat penugasan dari menu akun penyimpanan

Anda juga dapat membuat tugas dalam konteks akun penyimpanan. Opsi ini bisa nyaman jika Anda ingin menggunakan tugas yang ada untuk memproses objek di akun penyimpanan Anda. Untuk setiap tugas, Anda akan mengidentifikasi tugas penyimpanan yang ingin Anda tetapkan ke akun Anda.

Navigasi ke akun penyimpanan di portal Microsoft Azure lalu di bawah Manajemen data, pilih Tugas penyimpanan.

Di halaman Tugas penyimpanan , pilih tab Penetapan tugas , pilih + Buat penugasan, lalu pilih + Tambahkan penugasan.

Panel Tambahkan penugasan muncul.

Pilih cakupan

Di bagian Pilih cakupan , pilih langganan dan beri nama penugasan. Kemudian, pilih akun penyimpanan yang ingin Anda targetkan.

Jika Anda membuka panel Tambahkan penugasan dalam konteks akun penyimpanan, Anda akan memilih tugas penyimpanan alih-alih akun penyimpanan.

Untuk deskripsi setiap properti, lihat Pengaturan penugasan.

Menambahkan penetapan peran

Di bagian Penetapan peran , di daftar drop-down Peran , pilih peran yang ingin Anda tetapkan ke identitas terkelola tugas penyimpanan. Untuk memastikan penugasan tugas berhasil, gunakan peran yang memiliki izin sebagai Pemilik Data Blob. Untuk mempelajari selengkapnya, lihat Peran Azure yang diperlukan untuk menetapkan tugas.

Nota

Anda memilih jenis identitas terkelola (ditetapkan sistem atau ditetapkan pengguna) sebagai bagian dari membuat tugas penyimpanan.

Untuk deskripsi setiap properti, lihat Pengaturan penugasan.

Tambahkan filter

Di bagian Filter objek , pilih apakah Anda ingin menargetkan subset blob berdasarkan filter. Filter membantu Anda mempersempit cakupan eksekusi. Jika Anda ingin tugas mengevaluasi semua kontainer dan blob di akun, maka Anda dapat memilih opsi Jangan filter . Contoh berikut menggunakan filter untuk menargetkan hanya blob yang ada dalam kontainer yang diberi nama mycontainer.

Untuk deskripsi setiap properti, lihat Pengaturan penugasan.

Tentukan pemicu

Di bagian Detail pemicu , pilih bagaimana Anda ingin tugas ini dijalankan. Anda dapat memilih salah satu dari tipe proses berikut:

• Jalankan sekali: Jalankan tugas satu kali.
• Eksekusi berulang: Jalankan tugas pada jadwal berulang. Pilih waktu mulai dan selesai dan tentukan jumlah hari di antara setiap eksekusi.
• Mock run: Simulasikan eksekusi tugas tanpa melakukan operasi apa pun pada blob. Uji coba memindai dan mengevaluasi blob terhadap kondisi tugas serta menghasilkan laporan terperinci yang menunjukkan blob mana yang memenuhi kondisi dan operasi apa yang akan dijalankan. Tidak ada data yang dimodifikasi. Untuk informasi selengkapnya, lihat Membuat dan menggunakan eksekusi tiruan.

Untuk semua jenis eksekusi, tentukan di mana Anda ingin menyimpan laporan eksekusi.

Untuk deskripsi setiap properti, lihat Pengaturan penugasan.

Simpan penugasan

Pilih tombol Tambahkan untuk membuat penugasan.

Panel Tambahkan penugasan ditutup. Saat penyebaran selesai, penetapan muncul di halaman Tugas. Jika Anda tidak melihat penetapan di halaman tersebut, pilih tombol Refresh .

Mengaktifkan tugas

Penugasan dinonaktifkan secara default. Untuk mengaktifkan penugasan sehingga akan dijadwalkan untuk dijalankan, pilih kotak centang yang muncul di samping penugasan, lalu pilih Aktifkan.

Setelah tugas berjalan, laporan eksekusi dibuat lalu disimpan dalam kontainer yang Anda tentukan saat membuat tugas. Untuk informasi selengkapnya tentang laporan tersebut serta cara melihat metrik yang menangkap jumlah objek yang ditargetkan, jumlah operasi yang dicoba, dan jumlah operasi yang berhasil, lihat Menganalisis eksekusi tugas penyimpanan.

Mengedit penugasan

Penugasan menjadi sub sumber daya akun penyimpanan yang ditargetkan. Oleh karena itu, setelah membuat tugas, Anda hanya dapat mengedit frekuensi eksekusinya. Bidang lain dari tugas hanya dapat dibaca. Opsi Jalankan sekali saja (hanya sekali) juga menjadi baca saja.

• Untuk mengedit frekuensi eksekusi tugas dalam konteks tugas penyimpanan, navigasikan ke tugas penyimpanan di portal Microsoft Azure lalu di bawah Manajemen tugas penyimpanan, pilih Penugasan.

• Untuk mengedit frekuensi eksekusi penugasan dalam konteks akun penyimpanan, navigasikan ke akun penyimpanan di portal Microsoft Azure lalu di bawah Manajemen data, pilih Tugas penyimpanan.

PowerShell

1. Pertama, instal modul PowerShell yang diperlukan. Lihat Menginstal modul PowerShell

2. Tentukan seberapa sering Anda ingin tugas dijalankan. Anda dapat memilih untuk menjalankan tugas hanya sekali, atau menjalankan tugas berulang. Jika Anda memutuskan untuk menjalankan tugas ini secara berulang, tentukan waktu mulai dan selesai dan tentukan jumlah hari di antara setiap eksekusi. Anda juga dapat menentukan di mana Anda ingin menyimpan laporan eksekusi. Contoh berikut membuat variabel untuk nilai pemicu.

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

3. Dapatkan tugas penyimpanan yang ingin Anda sertakan dalam penugasan Anda dengan menggunakan perintah Get-AzStorageActionTask .

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

4. Buat penetapan tugas penyimpanan dengan menggunakan New-AzStorageTaskAssignment perintah . Penugasan berikut menargetkan mycontainer kontainer akun bernama mystorageaccount. Penetapan ini menentukan bahwa tugas hanya akan berjalan satu kali, dan akan menyimpan laporan eksekusi ke folder bernama storage-tasks-report. Tugas dijadwalkan akan berjalan dalam 10 menit dari sekarang.

   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. Berikan izin tugas penyimpanan untuk melakukan operasi pada akun penyimpanan target dengan menetapkan peran ke identitas terkelola. Anda dapat memilih jenis identitas terkelola (ditetapkan sistem atau ditetapkan pengguna) saat membuat tugas penyimpanan.

   Berikut adalah perintah yang memberikan peran Storage Blob Data Owner kepada identitas terkelola yang ditetapkan oleh sistem dari tugas penyimpanan.

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

   Perintah berikut menetapkan peran Storage Blob Data Owner ke identitas terkelola yang ditetapkan pengguna.

   $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

Membuat penugasan dengan menggunakan Azure CLI

1. Tentukan seberapa sering Anda ingin tugas dijalankan. Anda dapat memilih untuk menjalankan tugas hanya sekali, atau menjalankan tugas berulang. Jika Anda memutuskan untuk menjalankan tugas ini secara berulang, tentukan waktu mulai dan selesai dan tentukan jumlah hari di antara setiap eksekusi. Anda juga dapat menentukan di mana Anda ingin menyimpan laporan eksekusi. Berikut ini membuat variabel string berformat JSON yang menentukan nama kontainer, frekuensi eksekusi tugas (RunOnce), dan waktu untuk menjalankan laporan.

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

   String yang digunakan dalam executioncontextvariable diekspresikan dengan menggunakan sintaks singkat. Sintaks singkat adalah representasi yang disederhanakan dari string JSON. Untuk mempelajari selengkapnya, lihat Cara menggunakan sintaks singkat dengan Azure CLI.

2. Dapatkan ID tugas penyimpanan yang ingin Anda sertakan dalam tugas Anda dengan menggunakan perintah az storage-actions task show , lalu kueri untuk properti tersebut id .

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

3. Buat penetapan tugas penyimpanan dengan menggunakan az storage account task-assignment create perintah .

   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. Berikan izin tugas penyimpanan untuk melakukan operasi pada akun penyimpanan target dengan menetapkan peran ke identitas terkelola. Anda dapat memilih jenis identitas terkelola (ditetapkan sistem atau ditetapkan pengguna) saat membuat tugas penyimpanan.

   Berikut adalah perintah yang memberikan peran Storage Blob Data Owner kepada identitas terkelola yang ditetapkan oleh sistem dari tugas penyimpanan.

   $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" 
   

   Perintah berikut menetapkan peran Storage Blob Data Owner ke identitas terkelola yang ditetapkan pengguna.

   $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" 
   

Bisep

Sertakan cuplikan yang mirip dengan yang berikut ini di templat Bicep Anda.

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'
  }
}

Templat

Sertakan cuplikan JSON yang mirip dengan yang berikut ini di templat Azure Resource Manager Anda.

  "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"
      ]
    }
  ]

Lihat juga

• Penetapan tugas penyimpanan
• Gambaran umum Azure Storage Actions
• Menganalisis eksekusi tugas penyimpanan