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.
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 .docx
souboru . Proto je operátor , vlastnost je endsWith
Name
a 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.
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.
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ů.
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
, Cool
nebo Archive
.
2 Povolené hodnoty jsou BlockBlob
, PageBlob
nebo 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 |