Dela via

Åtgärder för lagringsaktivitet

  • Artikel

En lagringsaktivitet innehåller en uppsättning villkor och åtgärder. En åtgärd är en åtgärd som en lagringsuppgift utför på varje objekt som uppfyller kraven för varje villkor. I den här artikeln beskrivs JSON-formatet för en lagringsaktivitetsåtgärd. Det är viktigt att förstå formatet om du planerar att skapa en lagringsuppgift med hjälp av ett annat verktyg än Azure Portal (till exempel Azure PowerShell eller Azure CLI). Den här artikeln innehåller även åtgärder, åtgärdsparametrar och tillåtna värden för varje parameter.

Den här artikeln fokuserar på åtgärder. Mer information om villkor finns i Villkor för lagringsaktivitet.

Viktigt!

Azure Storage Actions är för närvarande i förhandsversion och är tillgängligt för dessa regioner. Juridiska villkor för Azure-funktioner i betaversion, förhandsversion eller som av någon annan anledning inte har gjorts allmänt tillgängliga ännu finns i kompletterande användningsvillkor för Microsoft Azure-förhandsversioner.

Åtgärdsformat

En åtgärd har ett namn tillsammans med noll, en eller flera parametrar. Följande bild visar hur dessa element visas för en åtgärd i JSON-mallen för en lagringsuppgift.

Diagram som visar formatet på en åtgärd.

I följande tabell beskrivs varje element.

Element Description
name Namnet på åtgärden.1
parameters En samling med en eller flera parametrar. Varje parameter har parameternamn och ett parametervärde.1
onSuccess Åtgärden som ska vidtas när åtgärden lyckas för ett objekt. continue är det enda tillåtna värdet under förhandsversionen.
onFailure Åtgärden som ska vidtas när åtgärden misslyckas för ett objekt. break är det enda tillåtna värdet under förhandsversionen.

1 En fullständig lista över åtgärdsnamn, åtgärdsparametrar och parametervärden finns i avsnittet Åtgärder som stöds i den här artikeln.

Följande åtgärd tillämpar en tidsbaserad oföränderlighetsprincip på objektet.

{
    "operations": [
        {
            "name": "SetBlobImmutabilityPolicy",
            "parameters": {
                "untilDate": "2024-11-15T21:54:22",
                "mode": "locked"
            },
            "onSuccess": "continue",
            "onFailure": "break"
        }
    ]
}

Flera åtgärder

Avgränsa flera åtgärder med ett kommatecken. Följande bild visar positionen för två åtgärder i listan över åtgärder.

Diagram som visar formatet för två åtgärder.

Följande JSON visar två åtgärder som är separata med kommatecken.

"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"
    }
]

Åtgärder som stöds

I följande tabell visas de åtgärder, parametrar och parametervärden som stöds:

Åtgärd Parametrar Värden
SetBlobTier nivå Hot | Lågfrekvent | Arkiv
SetBlobExpiry expiryTime, expiryOption (expiryTime): Antal millisekunder
(expiryOption): Absolut | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob Ingen Ingen
Ta bortBlob Ingen Ingen
SetBlobTags Taggnamn1 Taggvärde
SetBlobImmutabilityPolicy untilDate, mode (untilDate): DateTime för när principen slutar

(läge): låst | olåst
SetBlobLegalHold legalHold true | falsk

1 Namnet på den här parametern är namnet på taggen.

Se även