Sdílet prostřednictvím


Podmínky úloh úložiště

Úloha úložiště obsahuje sadu podmínek a operací. Tento článek popisuje formát JSON podmínky. Pochopení formátu je důležité, pokud plánujete vytvořit úlohu úložiště pomocí jiného nástroje než webu Azure Portal (například Azure PowerShell nebo Azure CLI). Tento článek také uvádí vlastnosti a operátory, které můžete použít k vytvoření klauzulí podmínky.

Tento článek se zaměřuje na podmínky. Další informace o operacích najdete v tématu Operace úloh úložiště.

Důležité

Akce služby Azure Storage jsou aktuálně ve verzi PREVIEW a jsou k dispozici v těchto oblastech. Právní podmínky, které platí pro funkce Azure, které jsou ve verzi beta, verzi Preview nebo které zatím nejsou veřejně dostupné, najdete v Dodatečných podmínkách použití pro Microsoft Azure verze Preview.

Formát podmínky

Podmínka kolekce jedné nebo více klauzulí. Každá klauzule obsahuje vlastnost, hodnotu a operátor. Při spuštění úlohy úložiště používá operátor k porovnání vlastnosti s hodnotou k určení, zda je klauzule splněna cílovým objektem. V klauzuli se operátor vždy zobrazí jako první následovaný vlastností a poté hodnotou. Následující obrázek ukazuje, jak je každý prvek umístěn ve výrazu.

Diagram znázorňující formát jednoduché podmínky s operátorem, vlastností a hodnotou

Následující klauzule umožňuje operace pouze v dokumentech aplikace Microsoft Word. Tato klauzule cílí na všechny dokumenty, které končí příponou .docxsouboru . Proto je operátor , vlastnost je endsWithNamea hodnota je .docx.

{
   "condition": "[[[endsWith(Name, '.docx')]]"
}

Úplný seznam názvů operátorů a vlastností najdete v části Podporované operátory a podporované vlastnosti tohoto článku.

Více klauzulí v podmínce

Podmínka může obsahovat více klauzulí oddělených čárkou spolu s řetězcem and nebo or. Řetězec and cílí na objekty, které splňují kritéria ve všech klauzulích v podmínce, zatímco or cíle objekty, které splňují kritérium v některé z klauzulí v podmínce. Následující obrázek znázorňuje pozici and řetězce a or dvě klauzule.

Diagram znázorňující formát podmínky, která obsahuje dvě klauzule

Následující json ukazuje podmínku, která obsahuje dvě klauzule. Vzhledem k tomu, že and se řetězec používá v tomto výrazu, musí se obě klauzule vyhodnotit na true před provedením operace u objektu.

{
"condition": "[[and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes'))]]"
}

Skupiny podmínek

Seskupené klauzule fungují jako jedna jednotka oddělená od ostatních klauzulí. Klauzule seskupení se podobají umístění závorek kolem matematické rovnice nebo logického výrazu. or Řetězec and nebo první klauzule ve skupině se vztahuje na celou skupinu.

Následující obrázek znázorňuje dvě klauzule seskupené dohromady.

Diagram znázorňující formát podmínky, která obsahuje dvě klauzule seskupené dohromady

Následující podmínka umožňuje operace pouze na dokumentech aplikace Microsoft Word, kde readyForLegalHold je značka dokumentu nastavena na hodnotu Yes. Operace se provádějí také u objektů, které jsou větší než 100 bajtů, i když ostatní dvě podmínky nejsou pravdivé.

{
"condition": "[[[or(and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes')), greater(Content-Length, '100'))]]"
}

Zobrazení kódu na webu Azure Portal

Editor vizuálů dostupný na webu Azure Portal může vygenerovat JSON podmínky za vás. Podmínky můžete definovat pomocí editoru a pak ho získat otevřením karty Kód . Tento přístup může být užitečný při vytváření složitých sad podmínek, protože výrazy JSON se můžou stát velkými, nepraktnými a obtížně vytvářet ručně. Následující obrázek znázorňuje kartu Kód v editoru vizuálů.

Snímek obrazovky json podmínky, který se zobrazí na kartě Kód vizuálního návrháře

Další informace o editoru vizuálů najdete v tématu Definování podmínek úloh úložiště a operací.

Podporované vlastnosti

Následující tabulka uvádí vlastnosti, které můžete použít k vytvoření každé klauzule podmínky. Klauzule může obsahovat vlastnosti typu string, boolean, numeric a date and time.

String Datum a čas3 Číslo Logická hodnota
AccessTier1 AccessTierChangeTime Délka obsahu Odstraněné
Metadata.Value Čas vytvoření TagCount IsCurrentVersion
Název DeletedTime
BlobType2 LastAccessTime
Container.Metadata.Value[Name] Naposledy změněno
Container.Name
Container.Metadata.Value[Name]
Container.Name
Tags.Value[Name]
Id verze

1 Povolené hodnoty jsou Hot, Coolnebo Archive.

2 Povolené hodnoty jsou BlockBlob, PageBlobnebo AppendBlob

3 Lze nastavit na určitý čas nebo na hodnotu metadat dynamicky získanou z objektů. Viz Odkaz na hodnotu z metadat objektu.

Podporované operátory

Následující tabulka ukazuje operátory, které můžete použít v klauzuli k vyhodnocení hodnoty každého typu vlastnosti.

String Datum a čas Číslo Logická hodnota
obsahuje rovná se rovná se rovná se
empty greater greater not
rovná se greaterOrEquals greaterOrEquals
endsWith less less
length lessOrEquals lessOrEquals
startsWith addToTime
Shody

Viz také