Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
En lagringsuppgift specificerar villkoren som ska utvärderas och operationer som ska utföras på blobs. I den här artikeln beskrivs JSON-formatet för ett villkor. Detta format är viktigt om du planerar att skapa en lagringsuppgift med hjälp av ett annat verktyg än Azure-portalen, såsom Azure PowerShell eller Azure CLI. Den här artikeln listar också de egenskaper och operatorer du kan använda i klausulerna i ett villkor.
Den här artikeln fokuserar på villkor. Mer information om åtgärder finns i Åtgärder för lagringsaktivitet.
Villkorsformat
Ett villkor är ett logiskt predikat som består av en eller flera klausuler. Varje klausul innehåller en blob-egenskap, en logisk operator och ett värde. När lagringsuppgiften körs utvärderar den blob-egenskapen mot värdet genom att använda jämförelseoperatorn. I JSON-formatet visas alltid operatorn 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 operatorn endsWith, egenskapen Name och värdet .docx.
{
"condition": "[[[endsWith(Name, '.docx')]]"
}
Du kan också använda en not-operator före en annan operator i en villkorssats. Operatören not är en speciell operatör som du kan placera framför valfri operatör för att ge motsatt resultat av ett uttryck. Följande sats tillåter åtgärder på alla blobar som inte är ett Microsoft Word-dokument.
{
"condition": "[[not(endsWith(Name, '*.docx'))]]"
}
För den fullständiga listan över operatorer och egenskapsnamn, se avsnitten Stödda operatorer och Stödda egenskaper i denna artikel.
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'))]]"
}
Du kan använda en icke-operator för en grupp för att testa det motsatta resultatet av en grupp med satser. Följande villkor tillåter endast åtgärder på blobar som inte är Microsoft Word-dokument där readyForLegalHold blobens tagg ä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(not(and(endsWith(Name, '*.docx'), equals(Tags.Value[readyForLegalHold], 'Yes'))), greater(Content-Length, '100'))]]"
}
Kodvy i Azure-portalen
Använd den visuella redigeraren i Azure-portalen för att generera JSON för ett villkor och få sedan åtkomst till JSON-uttrycket genom att välja fliken Code. Denna metod är användbar när du komponerar komplexa villkor eftersom JSON-uttryck kan bli stora, otympliga och svåra att skapa för hand. Detta tillvägagångssätt gör det också möjligt att använda villkorsförhandsvisningsfunktionen i portalen för interaktiv validering av villkoret mot dina data. 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.
Förhandsversion av villkor
Funktionen för förhandsgranskning av villkor gör det möjligt att validera villkoret mot blobs i ditt testlagringskonto och se om de uppfyller eller inte uppfyller de villkor du definierat. Du kan hitta problemområden och optimera villkor innan du applicerar dem på produktionsdata. Förhandsgranskningen gör inga ändringar i objekten i ett mållagringskonto, så det är säkert att testa mot dina data.
Villkorsförhandsvisning är tillgängligt i PowerShell-, Azure CLI- och SDK-miljöer, men det enklaste sättet att förhandsgranska villkorseffekten är att använda fönstret Förhandsversionsvillkor i Azure-portalen. Du kan öppna detta fönster när du definierar villkor och när du tilldelar lagringsuppgifter.
Om du vill förhandsgranska effekten av villkor måste du ange en målprenumeration, ett lagringskonto och en container. Eftersom en förhandsvisning bara kan visa upp till 5 000 blobs kan du också ange ett prefix för att begränsa listan.
Anmärkning
Du kan inte använda jokertecken i blobprefixet.
Följande bild visar ett exempel på ett förhandsgranskningsresultat i Azure-portalen.
Förhandsgranskningsresultatet visas i en tabell över alla objekt i den valda containern, med resultatet av villkorsutvärderingen och de egenskapsvärden för objekten som användes för att utvärdera villkoret. Du kan sortera efter vilket fält som helst som visas i tabellen.
Om villkor refererar till egenskaper som inte finns i mållagringskontot visas ett fel. Blobindextaggar är till exempel inte tillgängliga för konton som har ett hierarkiskt namnområde. Om en sats i ett villkor refererar till blobindextaggar visas ett verifieringsfel.
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 regel kan innehålla egenskaper för strängar, booleanvärden, numeriska värden och datum- och tidsvärden.
| Sträng | Datum och tid3 | Numerisk | Boolean |
|---|---|---|---|
| AccessTier1 | AccessTierÄndringsTid | Innehållslängd | Borttagen |
| BlobType2 | Skapandetid | TagCount | ÄrNuvarandeVersion |
| Container.Metadata.Värde[Namn] | Borttagen tid | ||
| Behållare.Namn | SenastÅtkomsttid | ||
| Metadata.Value[Name] | Senast ändrad | ||
| Namn | |||
| Tags.Value[Name] |
1 Tillåtna värden är Hot, Cool, Cold eller Archive.
2 tillåtna värden är BlockBlob, PageBlob, eller AppendBlob.
3 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 ett uttryck för att utvärdera värdet för varje typ av egenskap.
| Sträng (skiftlägesokänslig) | Sträng (kasuskänslig) | Datum och tid | Numerisk | Boolean |
|---|---|---|---|---|
contains |
contains_cs |
equals |
equals |
equals |
empty
5 |
greater |
greater |
||
endsWith |
endsWith_cs |
greaterOrEquals |
greaterOrEquals |
|
equals |
equals_cs |
less |
less |
|
matches
4 |
matches_cs
4 |
lessOrEquals |
lessOrEquals |
|
startsWith |
startsWith_cs |
4 De matchesmatches_cs operatörerna stöds inte för Metadata.Value[Name] och Tags.Value[Name] egenskaper.
5 Operatorn empty testar om ett värde är tomt. Kasuskänslighet gäller inte, och det finns ingen empty_cs operatör.
not-operatorn är en speciell operator som du kan placera framför någon av operatorerna i denna tabell för att invertera resultatet av en villkorsklausul, även kallad det negativa resultatet.
Strängoperatorer med suffixet _cs är skiftlägeskänsliga. Till exempel endsWith(Name, '.CSV') matchar både report.CSV och report.csv, medan endsWith_cs(Name, '.CSV') endast matchar report.CSV.