Voorwaarden voor opslagtaken

Een opslagtaak bevat een set voorwaarden en bewerkingen. In dit artikel wordt de JSON-indeling van een voorwaarde beschreven. Begrijpen dat de indeling belangrijk is als u van plan bent om een opslagtaak te maken met behulp van een ander hulpprogramma dan Azure Portal (bijvoorbeeld: Azure PowerShell of Azure CLI). Dit artikel bevat ook de eigenschappen en operators die u kunt gebruiken om de componenten van een voorwaarde op te stellen.

Dit artikel is gericht op voorwaarden. Zie Storage-taakbewerkingen voor meer informatie over bewerkingen.

Belangrijk

Azure Storage Actions is momenteel in PREVIEW en is beschikbaar voor deze regio's. Raadpleeg de Aanvullende voorwaarden voor Microsoft Azure-previews voor juridische voorwaarden die van toepassing zijn op Azure-functies die in bèta of preview zijn of die anders nog niet algemeen beschikbaar zijn.

Opmaak van voorwaarde

Een voorwaarde voor een verzameling van een of meer componenten. Elke component bevat een eigenschap, een waarde en een operator. Wanneer de opslagtaak wordt uitgevoerd, wordt de operator gebruikt om een eigenschap te vergelijken met een waarde om te bepalen of aan een component wordt voldaan door het doelobject. In een component wordt de operator altijd eerst gevolgd door de eigenschap en vervolgens de waarde weergegeven. In de volgende afbeelding ziet u hoe elk element in de expressie wordt weergegeven.

Met de volgende component kunnen bewerkingen alleen worden uitgevoerd op Microsoft Word-documenten. Deze component is gericht op alle documenten die eindigen op de bestandsextensie .docx. Daarom is endsWithde operator , de eigenschap is Nameen de waarde is .docx.

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

Zie de sectie Ondersteunde operators en ondersteunde eigenschappen van dit artikel voor een volledige lijst met operator- en eigenschapsnamen.

Meerdere componenten in een voorwaarde

Een voorwaarde kan meerdere componenten bevatten, gescheiden door een komma, samen met de tekenreeks and of or. De tekenreeks and is gericht op objecten die voldoen aan de criteria in alle componenten in de voorwaarde, terwijl or objecten worden gericht die voldoen aan het criterium in een van de componenten in de voorwaarde. In de volgende afbeelding ziet u de positie van de and en or tekenreeks, samen met twee componenten.

In de volgende JSON ziet u een voorwaarde die twee componenten bevat. Omdat de and tekenreeks in deze expressie wordt gebruikt, moeten beide componenten evalueren true voordat een bewerking op het object wordt uitgevoerd.

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

Groepen voorwaarden

Gegroepeerde componenten werken als één eenheid, gescheiden van de rest van de componenten. Groeperingsclausules zijn vergelijkbaar met het plaatsen van haakjes rond een wiskundige vergelijking of logische expressie. De and of or tekenreeks voor de eerste component in de groep is van toepassing op de hele groep.

In de volgende afbeelding ziet u twee componenten gegroepeerd.

Met de volgende voorwaarde kunnen bewerkingen alleen worden uitgevoerd op Microsoft Word-documenten waarvan de readyForLegalHold tag van het document is ingesteld op een waarde van Yes. Bewerkingen worden ook uitgevoerd op objecten die groter zijn dan 100 bytes, zelfs als de andere twee voorwaarden niet waar zijn.

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

Codeweergave in Azure Portal

De visual-editor die beschikbaar is in Azure Portal, kan de JSON van een voorwaarde voor u genereren. U kunt uw voorwaarden definiëren met behulp van de editor en vervolgens de JSON-expressie verkrijgen door het tabblad Code te openen. Deze benadering kan handig zijn bij het maken van gecompliceerde sets voorwaarden, omdat JSON-expressies groot, onhandig en moeilijk te maken kunnen worden. In de volgende afbeelding ziet u het tabblad Code in de visuele editor.

Zie Voorwaarden en bewerkingen voor opslagtaken definiëren voor meer informatie over de visual-editor.

Ondersteunde eigenschappen

In de volgende tabel ziet u de eigenschappen die u kunt gebruiken om elke component van een voorwaarde samen te stellen. Een component kan tekenreeks-, booleaanse, numerieke en datum- en tijdeigenschappen bevatten.

String	Datum en tijd3	Numeriek	Booleaanse waarde
AccessTier1	AccessTierChangeTime	Content-Length	Verwijderd
Metadata.Value	Aanmaaktijd	TagCount	IsCurrentVersion
Naam	DeletedTime
BlobType2	LastAccessTime
Container.Metadata.Value[Naam]	Laatst gewijzigd
Container.Name
Container.Metadata.Value[Naam]
Container.Name
Tags.Value[Naam]
VersionId

¹ Toegestane waarden zijn Hot, Coolof Archive.

² Toegestane waarden zijn BlockBlob, PageBlobof AppendBlob

³ Kan worden ingesteld op een specifieke tijd of op een metagegevenswaarde die dynamisch wordt verkregen van objecten. Zie Verwijzen naar een waarde uit objectmetagegevens.

Niet-ondersteunde operators

In de volgende tabel ziet u de operators die u in een component kunt gebruiken om de waarde van elk type eigenschap te evalueren.

String	Datum en tijd	Numeriek	Booleaanse waarde
bevat	equals	equals	equals
empty	greater	greater	not
equals	greaterOrEquals	greaterOrEquals
endsWith	less	less
length	lessOrEquals	lessOrEquals
startsWith	addToTime
Matches

Zie ook

• Opslagtaakbewerkingen
• Voorwaarden en bewerkingen definiëren