Speicheraufgabenvorgänge
Ein Speichervorgang enthält eine Reihe von Bedingungen und Vorgängen. Ein Vorgang ist eine Aktion, die eine Speicheraufgabe für jedes Objekt ausführt, das die Anforderungen jeder Bedingung erfüllt. In diesem Artikel wird das JSON-Format eines Speicheraufgabenvorgangs beschrieben. 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). In diesem Artikel werden auch die Vorgänge, Vorgangsparameter und die zulässigen Werte der einzelnen Parameter aufgeführt.
Dieser Artikel konzentriert sich auf Vorgänge. Weitere Informationen zu Bedingungen finden Sie unter Speicheraufgabenbedingungen.
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.
Vorgangsformat
Ein Vorgang hat einen Namen zusammen mit Null, 1 oder mehreren Parametern. Die folgende Abbildung zeigt, wie diese Elemente für einen Vorgang in der JSON-Vorlage einer Speicheraufgabe angezeigt werden.
In der folgenden Tabelle wird jedes Element beschrieben.
Element | Beschreibung |
---|---|
name |
Der Name des Vorgangs.1 |
parameters |
Eine Sammlung von mindestens einem Parameter. Jeder Parameter weist den Parameternamen und einen Parameterwert auf.1 |
onSuccess |
Die Aktion, die ausgeführt werden soll, wenn der Vorgang für ein Objekt erfolgreich ist. continue ist der einzige zulässige Wert während der Vorschau. |
onFailure |
Die auszuführende Aktion, wenn der Vorgang für ein Objekt fehlschlägt. break ist der einzige zulässige Wert während der Vorschau. |
1 Eine vollständige Liste der Vorgangsnamen, Vorgangsparameter und Parameterwerte finden Sie im Abschnitt Unterstützte Vorgänge in diesem Artikel.
Der folgende Vorgang wendet eine zeitbasierte Unveränderbarkeitsrichtlinie auf das Objekt an.
{
"operations": [
{
"name": "SetBlobImmutabilityPolicy",
"parameters": {
"untilDate": "2024-11-15T21:54:22",
"mode": "locked"
},
"onSuccess": "continue",
"onFailure": "break"
}
]
}
Mehrere Vorgänge
Trennen Sie mehrere Vorgänge mithilfe eines Kommas. Die folgende Abbildung zeigt die Position von zwei Vorgängen in der Liste der Vorgänge.
Der folgende JSON-Code zeigt zwei Vorgänge getrennt durch ein Komma.
"operations": [
{
"name": "SetBlobImmutabilityPolicy",
"parameters": {
"untilDate": "2024-11-15T21:54:22",
"mode": "locked"
},
"onSuccess": "continue",
"onFailure": "break"
},
{
"name": "SetBlobTags",
"parameters": {
"ImmutabilityUpdatedBy": "contosoStorageTask"
},
"onSuccess": "continue",
"onFailure": "break"
}
]
Unterstützte Vorgänge
In der folgenden Tabelle sind die unterstützten Vorgänge, Parameter und Parameterwerte aufgeführt:
Vorgang | Parameter | Werte |
---|---|---|
SetBlobTier | Ebene | Heiß | Kalt | Archiv |
SetBlobExpiry | expiryTime, expiryOption | (expiryTime): Anzahl von Millisekunden (expiryOption): Absolut | NeverExpire | RelativeToCreation | RelativeToNow |
DeleteBlob | Keine | Keine |
UndeleteBlob | Keine | Keine |
SetBlobTags | Tagname1 | Tagwert |
SetBlobImmutabilityPolicy | untilDate, mode | (untilDate): Datum/Uhrzeit des Endzeitpunkts der Richtlinie (mode): gesperrt | nicht gesperrt |
SetBlobLegalHold | legalHold | true|false |
1 Der Name dieses Parameters ist der Name des Tags.