Compartir a través de

Operaciones de tareas de almacenamiento

  • Artículo

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.

Importante

Las acciones de Azure Storage se encuentran actualmente en versión preliminar y están disponibles en estas regiones. Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.

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. continue es el único valor permitido durante la versión preliminar.
onFailure Acción que se va a realizar cuando se produce un error en la operación para un objeto. break es el único valor permitido durante la versión preliminar.

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 Frecuente | Esporádico | Archivo
SetBlobExpiry expiryTime, expiryOption (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