Freigeben über


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.

Diagramm, welches das Format eines Vorgangs zeigt.

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.

Diagramm, welches das Format von zwei Vorgängen zeigt.

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.

Siehe auch