Udostępnij za pośrednictwem

Operacje zadań magazynu

  • Artykuł

Zadanie magazynu zawiera zestaw warunków i operacji. Operacja to akcja wykonywana przez zadanie magazynu dla każdego obiektu spełniającego wymagania każdego warunku. W tym artykule opisano format JSON operacji zadania magazynu. Zrozumienie tego formatu jest ważne, jeśli planujesz utworzyć zadanie magazynu przy użyciu narzędzia innego niż witryna Azure Portal (na przykład: Program Azure PowerShell lub interfejs wiersza polecenia platformy Azure). W tym artykule wymieniono również operacje, parametry operacji i dozwolone wartości każdego parametru.

Ten artykuł koncentruje się na operacjach. Aby dowiedzieć się więcej o warunkach, zobacz Warunki zadania magazynu.

Ważne

Akcje usługi Azure Storage są obecnie dostępne w wersji zapoznawczej i są dostępne w tych regionach. Zobacz Dodatkowe warunki użytkowania wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta lub wersji zapoznawczej albo w inny sposób nie zostały jeszcze wydane jako ogólnie dostępne.

Format operacji

Operacja ma nazwę z zerową, jedną lub wieloma parametrami. Na poniższej ilustracji przedstawiono sposób wyświetlania tych elementów dla operacji w szablonie JSON zadania magazynu.

Diagram przedstawiający format operacji.

W tabeli poniżej opisano każdy element.

Element opis
name Nazwa operacji.1
parameters Kolekcja co najmniej jednego parametru. Każdy parametr ma nazwę parametru i wartość parametru.1
onSuccess Akcja do wykonania, gdy operacja zakończy się pomyślnie dla obiektu. continue jest jedyną dozwoloną wartością w okresie obowiązywania wersji zapoznawczej.
onFailure Akcja do wykonania, gdy operacja zakończy się niepowodzeniem dla obiektu. break jest jedyną dozwoloną wartością w okresie obowiązywania wersji zapoznawczej.

1 Aby uzyskać pełną listę nazw operacji, parametrów operacji i wartości parametrów, zobacz sekcję Obsługiwane operacje w tym artykule.

Poniższa operacja stosuje do obiektu zasady niezmienności oparte na czasie.

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

Wiele operacji

Rozdziel wiele operacji przy użyciu przecinka. Na poniższej ilustracji przedstawiono położenie dwóch operacji na liście operacji.

Diagram przedstawiający format dwóch operacji.

Poniższy kod JSON przedstawia dwie operacje oddzielone przecinkami.

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

Obsługiwane operacje

W poniższej tabeli przedstawiono obsługiwane operacje, parametry i wartości parametrów:

Operacja Parametry Wartości
SetBlobTier warstwa Gorąca | Chłodna | Archiwum
SetBlobExpiry expiryTime, expiryOption (expiryTime): liczba milisekund
(expiryOption): Bezwzględne | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob Brak Brak
Cofnij usunięcie elementuBlob Brak Brak
SetBlobTags Nazwatagu 1 Wartość tagu
SetBlobImmutabilityPolicy untilDate, tryb (untilDate): Data/godzina zakończenia zasad

(tryb): zablokowany | Odblokowany
SetBlobLegalHold legalHold true | fałszywy

1 Nazwa tego parametru to nazwa tagu.

Zobacz też