Menentukan kondisi dan operasi tugas penyimpanan

Anda dapat menggunakan editor visual untuk menentukan kondisi dan operasi tugas penyimpanan.

Operasi adalah tindakan yang diambil pada setiap objek yang memenuhi kondisi yang ditentukan dalam tugas. Kondisi berisi satu atau beberapa klausa kondisional. Setiap klausa menentukan hubungan antara properti dan nilai. Untuk menjalankan operasi yang ditentukan dalam tugas penyimpanan, ketentuan hubungan tersebut harus dipenuhi oleh setiap objek.

Tentukan kondisi

Tentukan kondisi dengan menambahkan klausa. Klausa menentukan hubungan antara properti dan nilai. Untuk menjalankan operasi yang ditentukan dalam tugas penyimpanan, ketentuan hubungan tersebut harus dipenuhi oleh setiap objek.

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

Cuplikan layar tombol Kondisi dan editor Kondisi.

Tab Penyusun visual panel Kondisi muncul.

Menambahkan dan menghapus klausa

Untuk menambahkan klausa, pilih Tambahkan klausa baru, dan untuk menghapus klausa, pilih ikon hapus( ) yang muncul di sampingnya.

Cuplikan layar tombol Tambahkan klausa baru dan tiga klausa yang ditambahkan ke daftar klausa.

Tentukan ketentuan klausul

Untuk menentukan klausa, pilih properti, tentukan nilai untuk properti tersebut, lalu pilih operator yang menghubungkannya bersama-sama.

Pilih properti

Di daftar drop-down properti Blob, pilih properti. Lihat Properti blob yang didukung.

Contoh berikut memilih properti Nama blob.

Cuplikan layar daftar drop-down properti klausul.

Pilih nilai dan operator

Dalam kotak Nilai properti , masukkan nilai dan di daftar drop-down Operator , pilih operator. Lihat Operator yang Didukung.

Contoh berikut menentukan nilai .log bersama dengan operator Berakhir dengan . Kondisi ini memungkinkan operasi yang ditentukan dalam tugas penyimpanan ini hanya dijalankan pada blob yang memiliki .log ekstensi file.

Cuplikan layar contoh kondisi di editor visual.

Tentukan kondisi dengan menggunakan JSON. Suatu kondisi adalah kumpulan dari satu atau beberapa klausa. Setiap klausa berisi properti, nilai, dan operator. Dalam JSON berikut, propertinya adalah Name, nilainya adalah .docx, dan operatornya adalah endsWith. Klausa ini hanya memungkinkan operasi pada dokumen Microsoft Word.

$conditions = "[[endsWith(Name, '.docx')]]"

Untuk mempelajari selengkapnya tentang struktur kondisi dan daftar lengkap properti dan operator, lihat Kondisi tugas penyimpanan.

Tentukan kondisi dengan menggunakan JSON. Suatu kondisi adalah kumpulan dari satu atau beberapa klausa. Setiap klausa berisi properti, nilai, dan operator. Dalam JSON berikut, propertinya adalah Name, nilainya adalah .docx, dan operator adalah endsWith. Klausa ini hanya memungkinkan operasi pada dokumen Microsoft Word. Untuk mempelajari selengkapnya tentang struktur kondisi dan daftar lengkap properti dan operator, lihat Kondisi tugas penyimpanan.

conditionclause="[[endsWith(Name,'/.docx'/)]]"

Petunjuk / Saran

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

Menggunakan kartubebas dalam nilai string

Anda dapat menggunakan * karakter kartubebas dan ? dalam nilai properti string. Karakter * mewakili nol atau lebih karakter sementara ? karakter mewakili tepat satu karakter.

Misalnya, jika Anda ingin klausul Anda mengevaluasi ke true hanya untuk blob yang merupakan dokumen Word, Anda akan menggunakan string *.docx. Namun, jika Anda hanya ingin dokumen dinamai dengan satu karakter seperti 1.docx atau 2.docx, maka Anda akan menggunakan string ?.docx.

Anda dapat menggunakan * atau ? di mana saja dalam string. Anda dapat menghindari karakter ini dengan menambahkan \ tepat sebelum karakter.

Mereferensikan nilai dari metadata objek

Klausul yang menyertakan properti tanggal dan waktu dapat mereferensikan nilai dari metadata kontainer atau tag indeks blob. Nilai-nilai ini diperoleh secara dinamis pada runtime saat tugas dijalankan.

Di akun penyimpanan, Anda dapat menambahkan kunci ke metadata kontainer atau ke tag indeks blob. Nilai kunci tersebut harus berupa interval waktu berformat ISO 8601. Misalnya, Anda dapat menambahkan kunci bernama retainfor bersama dengan nilai PT5M string yang mewakili interval lima menit.

Untuk mereferensikan kunci, pilih tautan Edit yang muncul di kolom Nilai properti. Lalu, dalam kotak dialog Pilih nilai , pilih Metadata kontainer atau tag Indeks Blob.

Contoh berikut menambahkan properti Waktu pembuatan, operator Sebelumnya dari , dan mereferensikan kunci bernama retainFor dalam tag indeks dari setiap blob yang dievaluasi.

Cuplikan layar menentukan kunci dalam metadata kontainer sebagai bagian dari definisi kondisi.

$conditions = "[[and(endsWith(Name, '.docx'), equals(utcNow, dateTimeAdd(Creation-Time, Tags.Value[retainFor])))]]"

Klausa kondisi ini menggunakan sintaks singkat. Azure CLI mengekspresikan string berformat JSON dengan menggunakan sintaks singkat. Untuk mempelajari selengkapnya, lihat Cara menggunakan sintaks singkat dengan Azure CLI.

conditionclause="[[and(endsWith(Name, '/.docx'/),equals(utcNow,dateTimeAdd(Creation-Time,Tags.Value[retainFor])))]]"

Kondisi ini menguji apakah blob dibuat lebih awal dari durasi waktu tertentu relatif terhadap sekarang (tanggal dan waktu saat ini). Misalnya, jika nilai yang diambil dari retainFor tag adalah lima menit, maka kondisi ini memeriksa apakah blob dibuat lebih dari 5 menit yang lalu.

Jika kunci tidak ada untuk objek yang dievaluasi, maka kondisi akan dianggap salah. Jika nilai kunci adalah string yang tidak sesuai dengan standar ISO 8601 , maka kesalahan dilaporkan dalam laporan eksekusi.

Terapkan Dan / Atau ke klausul

Anda menambahkan Dan atau Atau ke klausa. Tentukan Dan jika Anda ingin menargetkan objek yang memenuhi kriteria dalam klausa saat ini dan klausa kondisi sebelumnya. Tentukan Atau untuk menargetkan objek yang memenuhi kriteria dalam klausa saat ini atau klausa sebelumnya.

Contoh berikut menunjukkan klausa yang menggunakan And. Dalam contoh ini, tugas penyimpanan menargetkan objek yang memiliki .log ekstensi dan yang memiliki tag bernama Archive-Status yang diatur ke Ready.

Cuplikan layar klausa yang menggunakan operator AND.

$conditions = "[[and(endsWith(Name, '.log'), equals(Tags.Value[Archive-Status], 'Ready'))]]"

Untuk informasi selengkapnya, lihat Beberapa klausa dalam kondisi.

conditionclause="[[and(endsWith(Name,'/.log'/),equals(Tags.Value[Archive-Status],'/Ready'/))]]"

Untuk informasi selengkapnya, lihat Beberapa klausa dalam kondisi.

Mengubah urutan klausa

Anda dapat mengatur klausa dalam urutan yang Anda yakini akan meningkatkan performa tugas yang dijalankan. Misalnya, alih-alih terlebih dahulu menguji semua blob dalam akun terhadap filter nama, Anda mungkin meningkatkan klausul yang menargetkan kontainer tertentu. Penyesuaian kecil itu dapat mencegah tugas melakukan evaluasi yang tidak perlu.

Contoh berikut membalikkan urutan klausul yang diperlihatkan dalam contoh sebelumnya. Kondisi ini terlebih dahulu mengevaluasi klausul tag indeks, kemudian klausul nama blob.

Pertama, pilih klausa. Lalu, pilih Pindahkan klausa ke atas atau Pindahkan klausa ke bawah untuk mengubah posisinya dalam daftar.

Cuplikan layar klausa muncul di posisi baru dalam daftar.

$conditions = "[[and(equals(Tags.Value[Archive-Status], 'Ready'), endsWith(Name, '.log'))]]"

conditionclause="[[and(equals(Tags.Value[Archive-Status],'/Ready'/),endsWith(Name,'/.log'/))]]"

Klausa grup dan pisahkan grup

Klausa yang dikelompokkan beroperasi sebagai satu unit terpisah dari klausul lainnya. Klausa pengelompokan mirip dengan menempatkan tanda kurung di sekitar persamaan matematika atau ekspresi logika. Operator Dan atau Atau untuk klausul pertama dalam grup berlaku untuk seluruh grup.

Contoh berikut menunjukkan dua kondisi yang dikelompokkan bersama-sama. Dalam contoh ini, operasi dijalankan jika blob memiliki .log ekstensi dan tag bernama Archive-Status diatur ke nilai Ready atau file belum diakses dalam 120 hari.

Pilih kotak centang yang muncul di samping setiap klausa yang ingin Anda kelompokkan bersama-sama. Lalu, pilih Grup.

Cuplikan layar klausul yang dikelompokkan bersama-sama.

Untuk memisahkan grup klausa, pilih ikon pisahkan grup ( ) atau pilih setiap klausa dalam grup, dan pilih Pisahkan Grup.

$conditions = "[[and(endsWith(Name,'/.log'/),or(equals(Tags.Value[Archive-Status],'/Ready'/),less(utcNow,dateTimeAdd(LastAccessTime,'/P120D'/))))]]"

Untuk informasi selengkapnya, lihat Grup kondisi.

conditionclause="[[and(endsWith(Name,'/.log'/),or(equals(Tags.Value[Archive-Status],'/Ready'/),less(utcNow,dateTimeAdd(LastAccessTime,'/P120D'/))))]]"

Untuk informasi selengkapnya, lihat Grup kondisi.

Pratinjau efek kondisi

Anda dapat melihat daftar blob yang akan terpengaruh oleh kondisi yang telah Anda tentukan.

Di editor kondisi, pilih Kondisi pratinjau.

Dalam Kondisi Pratinjau, Anda dapat menentukan langganan target, akun penyimpanan, dan kontainer. Karena hanya dapat muncul hingga 5.000 blob, Anda juga dapat menentukan awalan untuk mempersempit daftar.

Cuplikan layar halaman Kondisi.

Menentukan operasi

Operasi adalah tindakan yang diambil pada setiap objek yang memenuhi kondisi yang ditentukan dalam tugas.

Menambahkan dan menghapus operasi

Untuk menambahkan operasi, pilih Tambahkan operasi baru, dan untuk menghapus operasi, pilih ikon hapus( ) yang muncul di sampingnya.

Cuplikan layar tombol Tambahkan operasi baru dan tiga operasi yang ditambahkan ke daftar operasi.

Pilih operasi

Di daftar drop-down Operasi, pilih operasi. Lihat Operasi yang didukung.

Contoh berikut memilih properti Atur tag blob.

Cuplikan layar daftar drop-down Operasi operasi.

Pilih parameter

Masukkan atau pilih parameter yang sesuai untuk operasi.

Contoh berikut mengatur Archive-Status tag ke nilai Archived.

Cuplikan layar contoh kondisi.

Tentukan setiap operasi dengan menggunakan New-AzStorageActionTaskOperationObject perintah .

Operasi berikut menetapkan kebijakan yang memastikan kekekalan.

$policyoperation = New-AzStorageActionTaskOperationObject `
-Name SetBlobImmutabilityPolicy `
-Parameter @{"untilDate" = (Get-Date).AddDays(1); "mode" = "locked"} `
-OnFailure break `
-OnSuccess continue

Operasi berikut mengatur tag indeks blob dalam metadata dokumen Word.

$tagoperation = New-AzStorageActionTaskOperationObject -Name SetBlobTags `
-Parameter @{"tagsetImmutabilityUpdatedBy"="StorageTaskQuickstart"} `
-OnFailure break `
-OnSuccess continue

Menggabungkan operasi bersama-sama dengan menggunakan pemisah koma
```
$operation = $policyoperation,$tagoperation
```

Operasi ini dinyatakan dalam sintaks singkat. Sintaks singkat adalah representasi yang disederhanakan dari string JSON. Untuk mempelajari selengkapnya, lihat Cara menggunakan sintaks singkat dengan Azure CLI.

Tentukan setiap operasi. Contoh berikut mendefinisikan operasi yang menetapkan kebijakan kekekalan, dan operasi yang mengatur tag indeks blob dalam metadata dokumen Word.

policyoperation="{name:'SetBlobImmutabilityPolicy',parameters:{untilDate:'2024-10-20T22:30:40',mode:'locked'},onSuccess:'continue',onFailure:'break'}"
tagoperation="{name:'SetBlobTags',parameters:{'tagsetImmutabilityUpdatedBy':'StorageTaskQuickstart'},onSuccess:'continue',onFailure:'break'}"

Gabungkan operasi bersama-sama dengan menggunakan pemisah koma.

action="{if:{condition:'"${conditionclause}"',operations:["${policyoperation}","${tagoperation}"]}}"

Untuk mempelajari selengkapnya tentang struktur operasi dan untuk menemukan daftar lengkap operasi, lihat Operasi tugas penyimpanan.

Mengubah urutan operasi

Anda dapat mengatur operasi dalam urutan apa pun.

Dalam contoh ini, urutan yang ada masuk akal. Blob pertama kali diarsipkan dan tag diatur. Tidak masuk akal untuk mengatur tag sebelum mengubah tingkat untuk berjaga-jaga jika upaya untuk mengubah tingkat blob tidak berhasil. Jika operasi tag blob yang ditetapkan muncul terlebih dahulu dalam daftar, Anda mungkin mempertimbangkan untuk memindahkan operasi tersebut di bawah operasi tingkat blob yang ditetapkan.

Untuk memindahkan operasi, pilih kotak centang yang muncul di sampingnya. Kemudian, pilih Pindahkan operasi ke atas atau Pindahkan operasi ke bawah untuk mengubah posisinya dalam daftar.

Untuk memindahkan operasi, cukup ubah urutan operasi muncul dalam string berformat JSON.

$operation = $tagoperation,$policyoperation,

Untuk memindahkan operasi, cukup ubah urutan operasi muncul dalam string.

operations="'${tagoperation}','${policyoperation}'"

Lihat juga

Gambaran Umum Tindakan Azure Storage

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-05-07