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.

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.
onFailure Die auszuführende Aktion, wenn der Vorgang für ein Objekt fehlschlägt.

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ß | Cool | Kalt | Archiv
Ablaufdatum für Blob festlegen Ablaufzeit, Ablaufoption (expiryTime): Anzahl von Millisekunden
(expiryOption): Absolut | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob Keine Keine
UndeleteBlob Keine Keine
SetBlobTags Tagname1 Tagwert
SetBlobImmutabilityPolicy untilDate, Modus (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

  • Last updated on