Speicheraufgabenbedingungen
Ein Speichervorgang enthält eine Reihe von Bedingungen und Vorgängen. Dieser Artikel beschreibt das JSON-Format einer Bedingung. Das Verständnis dieses Formats ist wichtig, wenn Sie beabsichtigen, eine Speicheraufgabe mithilfe eines anderen Tools als dem Azure-Portal zu erstellen (Beispiele: Azure PowerShell oder Azure CLI). Dieser Artikel führt auch die Eigenschaften und Operatoren auf, die Sie zum Verfassen der Klauseln einer Bedingung verwenden können.
Dieser Artikel konzentriert sich auf Bedingungen. Weitere Informationen zu Vorgängen finden Sie unter Speicheraufgabenvorgänge.
Wichtig
Azure Speichervorgänge befinden sich derzeit in der VORSCHAU und sind in diesen Regionen verfügbar. Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.
Bedingungsformat
Eine Bedingung ist eine Sammlung einer oder mehrerer Klauseln. Jede Klausel enthält eine Eigenschaft, einen Wert und einen Operator. Wenn die Speicheraufgabe ausgeführt wird, wird der Operator verwendet, um eine Eigenschaft mit einem Wert zu vergleichen, um zu bestimmen, ob eine Klausel vom Zielobjekt erfüllt wird. In einer Klausel erscheint der Operator immer als erstes, gefolgt von der Eigenschaftund dann dem Wert. Die folgende Abbildung zeigt, wie jedes Element im Ausdruck positioniert ist.
Die folgende Klausel ermöglicht Vorgänge nur für Microsoft Word-Dokumente. Diese Klausel zielt auf alle Dokumente ab, die mit der Dateierweiterung .docx enden. Daher ist der Operator endsWith, die Eigenschaft ist Name, und der Wert ist .docx.
{
"condition": "[[[endsWith(Name, '.docx')]]"
}
Eine vollständige Liste der Operator- und Eigenschaftennamen finden Sie in den Abschnitten Unterstützte Operatoren und Unterstützte Eigenschaften in diesem Artikel.
Mehrere Klauseln in einer Bedingung
Eine Bedingung kann mehrere Klauseln enthalten, die durch ein Komma getrennt sind, zusammen mit der Zeichenfolge and oder or. Die Zeichenfolge and zielt auf Objekte ab, die den Kriterien in allen Klauseln in der Bedingung entsprechen, während or auf Objekte zielt, die das Kriterium in einer der Klauseln in der Bedingung erfüllen. Die folgende Abbildung zeigt die Position der Zeichenfolgen and und or zusammen mit zwei Klauseln.
Der folgende JSON-Code zeigt eine Bedingung, die zwei Klauseln enthält. Da die Zeichenfolge and in diesem Ausdruck verwendet wird, müssen beide Klauseln auf true ausgewertet werden, bevor ein Vorgang für das Objekt ausgeführt wird.
{
"condition": "[[and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes'))]]"
}
Gruppen von Bedingungen
Gruppierte Klauseln werden als einzelne Einheit getrennt vom Rest der Klauseln ausgeführt. Das Gruppieren von Klauseln ist vergleichbar mit dem Einfügen von Klammern in eine mathematische Gleichung oder einen logischen Ausdruck. Die Zeichenfolge and oder or für die erste Klausel der Gruppe gilt für die gesamte Gruppe.
Die folgende Abbildung zeigt zwei miteinander gruppierte Klauseln.
Die folgende Bedingung ermöglicht Vorgänge nur für Microsoft Word-Dokumente, bei denen das Tag readyForLegalHold des Dokuments auf einen Wert Yes festgelegt ist. Vorgänge werden auch für Objekte ausgeführt, die größer als 100 Byte sind, auch wenn die zwei anderen Bedingungen nicht erfüllt sind.
{
"condition": "[[[or(and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes')), greater(Content-Length, '100'))]]"
}
Codeansicht im Azure-Portal
Der im Azure-Portal verfügbare Visualisierungseditor kann den JSON-Code einer Bedingung für Sie generieren. Sie können Ihre Bedingungen mithilfe des Editors definieren und dann den JSON-Ausdruck abrufen, indem Sie die Registerkarte Code öffnen. Dieser Ansatz kann nützlich sein, wenn komplizierte Gruppen von Bedingungen erstellt werden, da JSON-Ausdrücke groß, unhandlich und schwer von Hand zu erstellen sein können. Die folgende Abbildung zeigt die Registerkarte Code im Visualisierungseditor.
Weitere Informationen zum Visualisierungseditor finden Sie unter Definieren von Speicheraufgabenbedingungen und -vorgängen.
Unterstützte Eigenschaften
Die folgende Tabelle zeigt die Eigenschaften, die Sie zum Verfassen der einzelnen Klauseln einer Bedingung verwenden können. Eine Klausel kann Zeichenfolgen, boolesche, numerische und Datums- und Zeiteigenschaften enthalten.
| String | Datum und Zeit3 | Numeric | Boolean |
|---|---|---|---|
| AccessTier1 | AccessTierChangeTime | Inhaltslänge | Gelöscht |
| Metadata.Value | Erstellungszeit | TagCount | IsCurrentVersion |
| Name | DeletedTime | ||
| BlobType2 | LastAccessTime | ||
| Container.Metadata.Value[Name] | Last-Modified | ||
| Container.Name | |||
| Container.Metadata.Value[Name] | |||
| Container.Name | |||
| Tags.Value[Name] | |||
| VersionId |
1 Zulässige Werte sind Hot, Cool oder Archive.
2 Zulässige Werte sind BlockBlob, PageBlob oder AppendBlob
3 Kann auf eine bestimmte Zeit oder auf einen Metadatenwert festgelegt werden, der dynamisch von Objekten erhalten wird. Siehe Verweisen auf einen Wert aus Objektmetadaten.
Unterstützte Operatoren
Die folgende Tabelle zeigt die Operatoren, die Sie in einer Klausel verwenden können, um den Wert der einzelnen Eigenschaftentypen auszuwerten.
| String | Datum und Uhrzeit | Numeric | Boolean |
|---|---|---|---|
| contains | equals | equals | equals |
| empty | greater | greater | not |
| equals | greaterOrEquals | greaterOrEquals | |
| endsWith | less | less | |
| length | lessOrEquals | lessOrEquals | |
| startsWith | addToTime | ||
| Übereinstimmungen |