Villkor för lagringsaktivitet

En lagringsaktivitet innehåller en uppsättning villkor och åtgärder. I den här artikeln beskrivs JSON-formatet för ett villkor. Det är viktigt att förstå formatet om du planerar att skapa en lagringsuppgift med hjälp av ett annat verktyg än Azure Portal (till exempel Azure PowerShell eller Azure CLI). Den här artikeln innehåller också de egenskaper och operatorer som du kan använda för att skapa satserna i ett villkor.

Den här artikeln fokuserar på villkor. Mer information om åtgärder finns i Åtgärder för lagringsaktivitet.

Viktigt!

Azure Storage Actions är för närvarande i förhandsversion och är tillgängligt för dessa regioner. Juridiska villkor för Azure-funktioner i betaversion, förhandsversion eller som av någon annan anledning inte har gjorts allmänt tillgängliga ännu finns i kompletterande användningsvillkor för Microsoft Azure-förhandsversioner.

Villkorsformat

Ett villkor för en samling med en eller flera satser. Varje sats innehåller en egenskap, ett värde och en operator. När lagringsaktiviteten körs använder den operatorn för att jämföra en egenskap med ett värde för att avgöra om en sats uppfylls av målobjektet. I en sats visas operatorn alltid först följt av egenskapen och sedan värdet. Följande bild visar hur varje element placeras i uttrycket.

Följande sats tillåter endast åtgärder i Microsoft Word-dokument. Den här satsen riktar sig till alla dokument som slutar med filnamnstillägget .docx. Därför är endsWithoperatorn , egenskapen är Nameoch värdet är .docx.

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

En fullständig lista över operator- och egenskapsnamn finns i avsnittet Operatorer som stöds och Egenskaper som stöds i den här artikeln.

Flera satser i ett villkor

Ett villkor kan innehålla flera satser avgränsade med ett kommatecken tillsammans med antingen strängen and eller or. Strängen and riktar sig mot objekt som uppfyller kriterierna i alla satser i villkoret medan or den riktar sig mot objekt som uppfyller kriteriet i någon av satserna i villkoret. Följande bild visar positionen för strängen and och or tillsammans med två satser.

Följande JSON visar ett villkor som innehåller två satser. Eftersom strängen and används i det här uttrycket måste båda satserna utvärderas till true innan en åtgärd utförs på objektet.

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

Grupper av villkor

Grupperade satser fungerar som en enskild enhet separat från resten av satserna. Grupperingssatser liknar att placera parenteser kring en matematisk ekvation eller ett logikuttryck. Strängen and eller or för den första satsen i gruppen gäller för hela gruppen.

Följande bild visar två satser grupperade tillsammans.

Följande villkor tillåter endast åtgärder i Microsoft Word-dokument där taggen readyForLegalHold för dokumentet är inställd på värdet Yes. Åtgärder utförs också på objekt som är större än 100 byte även om de andra två villkoren inte är sanna.

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

Kodvyn i Azure Portal

Den visuella redigeraren som är tillgänglig i Azure Portal kan generera JSON för ett villkor åt dig. Du kan definiera dina villkor med hjälp av redigeraren och sedan hämta JSON-uttrycket genom att öppna fliken Kod . Den här metoden kan vara användbar när du skapar komplicerade uppsättningar villkor eftersom JSON-uttryck kan bli stora, otympliga och svåra att skapa för hand. Följande bild visar fliken Kod i det visuella redigeringsprogrammet.

Mer information om det visuella redigeringsprogrammet finns i Definiera villkor och åtgärder för lagringsaktivitet.

Egenskaper som stöds

I följande tabell visas de egenskaper som du kan använda för att skapa varje sats i ett villkor. En sats kan innehålla egenskaper för sträng, boolesk, numerisk och datum och tid.

String	Datum och tid3	Numerisk	Booleskt
AccessTier1	AccessTierChangeTime	Innehållslängd	Borttagen
Metadata.Value	Skapandetid	TagCount	IsCurrentVersion
Name	DeletedTime
BlobType2	LastAccessTime
Container.Metadata.Value[Name]	Senast ändrad
Container.Name
Container.Metadata.Value[Name]
Container.Name
Tags.Value[Name]
VersionId

¹ Tillåtna värden är Hot, Cooleller Archive.

² Tillåtna värden är BlockBlob, PageBlobeller AppendBlob

³ Kan anges till en viss tid eller till ett metadatavärde dynamiskt som hämtas från objekt. Se Referera till ett värde från objektmetadata.

Operatorer som stöds

I följande tabell visas de operatorer som du kan använda i en -sats för att utvärdera värdet för varje typ av egenskap.

String	Datum och tid	Numerisk	Booleskt
innehåller	equals	equals	equals
empty	greater	greater	not
equals	greaterOrEquals	greaterOrEquals
endsWith	less	less
längd	lessOrEquals	lessOrEquals
startsWith	addToTime
Träffar

Se även

• Åtgärder för lagringsaktivitet
• Definiera villkor och åtgärder