Tárolási feladat feltételei
A tárolási feladatok feltételek és műveletek készletét tartalmazzák. Ez a cikk egy feltétel JSON-formátumát ismerteti. Ennek a formátumnak a megértése akkor fontos, ha az Azure Portaltól eltérő eszközzel szeretne létrehozni egy tárolási feladatot (például: Azure PowerShell vagy Azure CLI). Ez a cikk a feltételek záradékainak megírásához használható tulajdonságokat és operátorokat is felsorolja.
Ez a cikk a feltételekre összpontosít. A műveletekről a Storage-feladatműveletek című témakörben olvashat bővebben.
Fontos
Az Azure Storage Actions jelenleg előzetes verzióban érhető el, és ezek a régiók érhetők el. A bétaverziójú, előzetes verziójú vagy másként még általánosan nem elérhető Azure-szolgáltatások jogi feltételeit lásd: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.
Feltételformátum
Egy feltétel, amely egy vagy több záradékot tartalmaz. Minden záradék tartalmaz egy tulajdonságot, egy értéket és egy operátort. A tárolási feladat futtatásakor az operátorral összehasonlít egy tulajdonságot egy értékkel annak megállapításához, hogy a célobjektum megfelel-e egy záradéknak. Egy záradékban az operátor mindig megjelenik először, majd a tulajdonság, majd az érték. Az alábbi képen az egyes elemek elhelyezkedése látható a kifejezésben.
Az alábbi záradék csak Microsoft Word-dokumentumokon engedélyezi a műveleteket. Ez a záradék a fájlkiterjesztéssel .docx
végződő összes dokumentumot célozza meg. Ezért az operátor az endsWith
, a tulajdonság Name
, és az érték ..docx
{
"condition": "[[[endsWith(Name, '.docx')]]"
}
Az operátorok és a tulajdonságnevek teljes listáját a jelen cikk Támogatott operátorok és támogatott tulajdonságok szakaszában találja.
Több záradék egy feltételben
A feltétel tartalmazhat vesszővel elválasztott több záradékot, valamint a sztringet and
vagy or
a . A sztring and
azokat az objektumokat célozza meg, amelyek megfelelnek a feltétel összes záradékában szereplő feltételeknek, míg or
azokat az objektumokat célozza meg, amelyek megfelelnek a feltétel bármelyik záradékában szereplő feltételnek. Az alábbi képen a sztring és or
a and
két záradék elhelyezkedése látható.
Az alábbi JSON egy két záradékot tartalmazó feltételt mutat be. Mivel a sztringet ebben a and
kifejezésben használják, mindkét záradéknak ki kell értékelnie, mielőtt true
műveletet hajtanak végre az objektumon.
{
"condition": "[[and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes'))]]"
}
Feltételek csoportjai
A csoportosított záradékok a többi záradéktól különálló egységként működnek. A csoportosítási záradékok hasonlóak ahhoz, hogy zárójeleket helyezzenek egy matematikai egyenlet vagy logikai kifejezés köré. A and
csoport első záradékának vagy or
sztringjének karakterlánca a teljes csoportra vonatkozik.
Az alábbi képen két záradék van csoportosítva.
Az alábbi feltétel csak olyan Microsoft Word-dokumentumokon engedélyezi a műveleteket, ahol a readyForLegalHold
dokumentum címkéje értékre Yes
van állítva. A műveletek 100 bájtnál nagyobb objektumokon is végrehajthatók, még akkor is, ha a másik két feltétel nem igaz.
{
"condition": "[[[or(and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes')), greater(Content-Length, '100'))]]"
}
Kódnézet az Azure Portalon
Az Azure Portalon elérhető vizualizációszerkesztő létrehozhatja egy feltétel JSON-ját. A feltételeket a szerkesztővel határozhatja meg, majd a JSON-kifejezést a Kód lap megnyitásával szerezheti be. Ez a megközelítés akkor lehet hasznos, ha bonyolult feltételkészleteket hoz létre, mivel a JSON-kifejezések nagyok, nem bonyolultak és nehezen hozhatók létre kézzel. Az alábbi képen a Kód lap látható a vizualizációszerkesztőben.
A vizualizációszerkesztővel kapcsolatos további információkért lásd : Tárolási feladatok feltételeinek és műveleteinek meghatározása.
Támogatott tulajdonságok
Az alábbi táblázat azokat a tulajdonságokat mutatja be, amelyekkel egy feltétel egyes záradékait megírhatja. A záradék tartalmazhat sztring- és logikai, numerikus, valamint dátum- és időtulajdonságokat.
Sztring | Dátum és idő3 | Numerikus | Logikai |
---|---|---|---|
AccessTier1 | AccessTierChangeTime | Tartalomhossz | Törölve |
Metadata.Value | Létrehozási idő | TagCount | IsCurrentVersion |
Név | DeletedTime | ||
BlobType2 | LastAccessTime | ||
Container.Metadata.Value[Név] | Utolsó módosítás | ||
Container.Name | |||
Container.Metadata.Value[Név] | |||
Container.Name | |||
Tags.Value[Name] | |||
VersionId |
1 Az engedélyezett értékek a következőkHot
: vagy Archive
Cool
.
2 Az engedélyezett értékek a következők BlockBlob
: , PageBlob
vagy AppendBlob
3 Beállítható egy adott időpontra vagy egy objektumból dinamikusan lekért metaadat-értékre. Lásd: Objektum metaadataiból származó értékre mutató hivatkozás.
Támogatott operátorok
Az alábbi táblázat azokat az operátorokat mutatja be, amelyeket egy záradékban használhat az egyes típusú tulajdonságok értékének kiértékeléséhez.
Sztring | Dátum és idő | Numerikus | Logikai |
---|---|---|---|
contains | egyenlő | egyenlő | egyenlő |
üres | Nagyobb | Nagyobb | nem |
egyenlő | greaterOrEquals | greaterOrEquals | |
endsWith | kevesebb | kevesebb | |
length (hossz) | lessOrEquals | lessOrEquals | |
startsWith | addToTime | ||
Egyezik |