Partager via

Opérations de tâche de stockage

Une tâche de stockage contient un ensemble de conditions et d’opérations. Une opération est une action effectuée par une tâche de stockage sur chaque objet qui répond aux exigences de chaque condition. Cet article décrit le format JSON d’une opération de tâche de stockage. Comprendre ce format est important si vous envisagez de créer une tâche de stockage à l’aide d’un outil autre que le portail Azure (par exemple : Azure PowerShell ou Azure CLI). Cet article répertorie également les opérations, les paramètres d’opération et les valeurs autorisées de chaque paramètre.

Cet article se concentre sur les opérations. Pour en savoir plus sur les conditions, consultez Conditions de tâche de stockage.

Format de l’opération

Une opération a un nom avec zéro, un ou plusieurs paramètres. L’image suivante montre comment ces éléments apparaissent pour une opération dans le modèle JSON d’une tâche de stockage.

Diagramme montrant le format d’une opération.

Le tableau suivant décrit chaque élément.

Élément Descriptif
name Nom de l'opération. 1
parameters Une collection d’un ou plusieurs paramètres. Chaque paramètre a un nom de paramètre et une valeur de paramètre.1
onSuccess Action à entreprendre lorsque l’opération réussit pour un objet.
onFailure Action à entreprendre lorsque l’opération échoue pour un objet.

1 Pour obtenir la liste complète des noms d’opérations, des paramètres d’opération et des valeurs de paramètres, consultez la section Opérations prises en charge de cet article.

L’opération suivante applique une stratégie d’immuabilité basée sur le temps à l’objet.

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

Opérations multiples

Séparez plusieurs opérations à l’aide d’une virgule. L’image suivante montre la position de deux opérations dans la liste des opérations.

Diagramme montrant le format de deux opérations.

Le code JSON suivant montre deux opérations séparées par une virgule.

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

Opérations prises en charge

Le tableau suivant montre les opérations, paramètres et valeurs de paramètre pris en charge :

Opération Paramètres Valeurs
SetBlobTier niveau Chaud | Cool | Froid | Archiver
SetBlobExpiry expiryTime, expiryOption (expireyTime) : nombre de millisecondes
(expireyOption) : Absolu | NeverExpire | RelativeToCreation | RelativeToNow
SupprimerBlob Aucun Aucun
Annuler la suppression deBlob Aucun Aucun
SetBlobTags Nom de la balise1 Valeur de la balise
SetBlobImmutabilityPolicy untilDate, mode (untilDate) : DateTime de la fin de la stratégie

(mode) : verrouillé | déverrouillé
SetBlobLegalHold legalHold vrai | faux

1 Le nom de ce paramètre est le nom de la balise.

Voir aussi