Partager via

Opérations de tâche de stockage

  • Article

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.

Important

Azure Storage Actions est actuellement en PRÉVERSION et est disponible dans ces régions. Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

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.

Element Description
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. continue est la seule valeur autorisée pendant la préversion.
onFailure Action à entreprendre lorsque l’opération échoue pour un objet. break est la seule valeur autorisée pendant la préversion.

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 tier Chaud | Froid | Archive
SetBlobExpiry expiryTime, expiryOption (expireyTime) : nombre de millisecondes
(expireyOption) : Absolu | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob None None
UndeleteBlob None None
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 true | false

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

Voir aussi