Compartir a través de

Operaciones de tareas de almacenamiento

Una tarea de almacenamiento contiene un conjunto de condiciones y operaciones. Una operación es una acción que realiza una tarea de almacenamiento en cada objeto que cumple los requisitos de cada condición. En este artículo se describe el formato JSON de una operación de tarea de almacenamiento. Comprender ese formato es importante si planea crear una tarea de almacenamiento mediante una herramienta distinta de Azure Portal (por ejemplo, Azure PowerShell o la CLI de Azure). En este artículo también se enumeran las operaciones, los parámetros de operación y los valores permitidos de cada parámetro.

Este artículo se centra en operaciones. Para obtener más información sobre las condiciones, consulte Condiciones de tareas de Almacenamiento.

Formato de operación

Una operación tiene un nombre junto con cero, uno o varios parámetros. En la imagen siguiente se muestra cómo aparecen estos elementos para una operación en la plantilla JSON de una tarea de almacenamiento.

Diagrama que muestra el formato de una operación.

En esta tabla se describe cada elemento.

Elemento Descripción
name Nombre de la operación.1
parameters Colección de uno o varios parámetros. Cada parámetro tiene el nombre del parámetro y un valor de parámetro.1
onSuccess Acción que se va a realizar cuando la operación se realiza correctamente para un objeto.
onFailure Acción que se va a realizar cuando se produce un error en la operación para un objeto.

1 Para obtener una lista completa de nombres de operación, parámetros de operación y valores de parámetro, consulte la sección Operaciones admitidas de este artículo.

La siguiente operación aplica una directiva de inmutabilidad basada en tiempo al objeto.

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

Varias operaciones

Separe varias operaciones mediante una coma. En la imagen siguiente se muestra la posición de dos operaciones en la lista de operaciones.

Diagrama que muestra el formato de dos operaciones.

En el siguiente JSON se muestran dos operaciones independientes por una coma.

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

Operaciones admitidas

En la siguiente tabla se muestran las operaciones, parámetros y valores de parámetros admitidos:

Operación Parámetros Valores
SetBlobTier nivel Caliente | Fresco | Frío | Archivo
SetBlobExpiry hora de expiración, opción de expiración (expiryTime): número de milisegundos
(expiryOption): Absoluto | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob Ninguno Ninguno
UndeleteBlob Ninguno Ninguno
SetBlobTags Nombre de etiqueta1 Valor de etiqueta
SetBlobImmutabilityPolicy untilDate, modo (untilDate): DateTime de cuándo finaliza la directiva

(modo): bloqueado | Desbloqueado
SetBlobLegalHold legalHold Verdadero | falso

1 El nombre de este parámetro es el nombre de la etiqueta.

Consulte también

  • Last updated on