Creación de una tarea de almacenamiento

En Azure Portal, busque Tareas de almacenamiento. A continuación, en Servicios, seleccione Tareas de Almacenamiento: Acciones de Azure Storage.

En las Acciones de almacenamiento de Azure Storage | en la página de Tareas de Storage, seleccione Crear.

Pestaña Aspectos básicos

En la pestaña Datos básicos, proporcione la información esencial para la tarea de almacenamiento. En la siguiente tabla se describen los campos de la pestaña Aspectos básicos.

En la imagen siguiente se muestra un ejemplo de la pestaña Datos básicos.

Pestaña Condiciones

En la pestaña Condiciones, defina las condiciones que deben cumplir cada objeto (contenedor o blob) y las operaciones que se van a realizar en el objeto.

Debe definir al menos una condición y una operación. Para agregar una cláusula a una condición, seleccione Agregar nueva cláusula. Para agregar operaciones, seleccione Agregar nueva operación.

En la tabla siguiente se describen los campos de la pestaña Condiciones.

En la imagen siguiente se muestra un ejemplo de la pestaña Condiciones.

Puede seleccionar Condiciones de vista previa para ver una lista de blobs que se verían afectados por las condiciones que ha definido. Para más información, consulte Vista previa del efecto de las condiciones.

Pestaña Asignaciones

Una asignación identifica una cuenta de almacenamiento y un subconjunto de objetos de esa cuenta a la que se dirige la tarea. Una asignación también define cuándo se ejecuta la tarea y dónde se almacenan los informes de ejecución.

Para agregar una asignación, seleccione Agregar asignación. Este paso es opcional. No es necesario agregar una asignación para crear la tarea.

En la tabla siguiente se describen los campos que aparecen en el panel Agregar asignación.

Seleccione el rol que desea asignar a la identidad administrada asignada por el sistema de la tarea de almacenamiento. Para garantizar una asignación de tareas correcta, use roles que tengan permisos de propietario de datos de blobs. Para más información, consulte Roles de Azure para tareas de almacenamiento.

En la imagen siguiente se muestra un ejemplo del panel Agregar asignación.

Pestaña Etiquetas

En la pestaña Etiquetas, puede especificar etiquetas de Resource Manager para ayudar a organizar los recursos de Azure. Para obtener más información, consulte Etiquetado de recursos, grupos de recursos y suscripciones para una organización lógica.

En la imagen siguiente se muestra una configuración estándar de las propiedades de etiqueta de índice para una nueva cuenta de almacenamiento.

Pestaña Revisar y crear

Cuando vaya a la pestaña Revisar y crear, Azure ejecuta la validación en la configuración de la tarea de almacenamiento que ha elegido. Si se supera la validación, puede continuar con la creación de la tarea de almacenamiento.

En cambio, si se produce un error en la validación, el portal indica qué configuración debe modificarse.

En la imagen siguiente se muestran los datos de pestaña Revisar antes de crear una nueva tarea de almacenamiento.

1. En primer lugar, instale los módulos de PowerShell necesarios. Consulte Instalación del módulo de PowerShell.

2. Defina una condición mediante JSON. Una condición es una colección de una o más cláusulas. Cada cláusula contiene una propiedad, un valor y un operador. Para más información, consulte Condiciones de tareas de almacenamiento.

   $condition = "<condition-json>"
   

3. Defina cada operación mediante el comando New-AzStorageActionTaskOperationObject . Para más información, consulte Operaciones de tareas de almacenamiento.

    $operation = New-AzStorageActionTaskOperationObject `
    -Name "<operation-name>" `
    -Parameter @{"<parameter-name>"= "<parameter-value"} `
    -OnFailure break `
    -OnSuccess continue
   
   

4. Cree una tarea de almacenamiento mediante el comando New-AzStorageActionTask y pase las condiciones y operaciones que defina. El comando siguiente crea una tarea de almacenamiento y habilita la identidad administrada por el sistema de la tarea. Las asignaciones de tareas de almacenamiento usan permisos aplicados a esa identidad administrada por el sistema para autorizar el acceso.

   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -EnableSystemAssignedIdentity:$true
   

   Si desea que las asignaciones se autoricen mediante una identidad administrada asignada por el usuario, debe proporcionar esa identidad como parámetro al comando New-AzStorageActionTask . El comando siguiente crea una tarea de almacenamiento y especifica una identidad administrada asignada por el usuario. Las asignaciones de tareas de almacenamiento usan permisos aplicados a la identidad administrada asignada por el usuario para autorizar el acceso.

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   $task = New-AzStorageActionTask `
   -Name "<storage-task-name>" `
   -ResourceGroupName "<resource-group>" `
   -Location "<location>" `
   -Enabled `
   -Description "<description>" `
   -IfCondition $condition `
   -IfOperation $operation `
   -UserAssignedIdentity $managedIdentity.Id
   

   Para obtener información sobre cómo crear una asignación mediante PowerShell, consulte Creación y administración de una asignación de tareas de almacenamiento.

1. Defina una condición mediante JSON. Una condición es una colección de una o más cláusulas. Cada cláusula contiene una propiedad, un valor y un operador. Para más información, consulte Condiciones de tareas de almacenamiento.

   conditionclause="<condition-json>"
   

   Sugerencia

   La CLI de Azure usa la sintaxis abreviada. La sintaxis abreviada es una representación simplificada de una cadena JSON. Para más información, consulte Uso de la sintaxis abreviada con la CLI de Azure.

2. Cree una tarea de almacenamiento mediante el comando az storage-actions task create y pase una expresión con formato JSON de las condiciones y operaciones. En este ejemplo se buscan blobs en el nivel de acceso esporádico y se mueven al nivel de acceso frecuente. Se eliminan todos los demás blobs. El comando siguiente crea una tarea de almacenamiento y especifica una identidad administrada asignada por el sistema. Las asignaciones de tareas de almacenamiento usan permisos aplicados a la identidad administrada asignada por el sistema para autorizar el acceso.

   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity "{type:SystemAssigned}" \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   Si quiere que las asignaciones se autoricen mediante una identidad administrada asignada por el usuario, debe proporcionar esa identidad como parámetro al comando az storage-actions task create . El comando siguiente crea una tarea de almacenamiento y especifica una identidad administrada asignada por el usuario. Las asignaciones de tareas de almacenamiento usan permisos aplicados a la identidad administrada asignada por el usuario para autorizar el acceso.

   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
   az storage-actions task create -g myresourcegroup -n mystoragetask \ 
   --identity $identityId \
   --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description myStorageTask --enabled true
   

   Para más información sobre las operaciones, consulte Operaciones de tareas de almacenamiento.

   Para obtener información sobre cómo crear una asignación mediante la CLI de Azure, consulte Creación y administración de una asignación de tareas de almacenamiento.

Incluya un fragmento de código similar al siguiente en la plantilla de Bicep. En este ejemplo se establece una directiva de inmutabilidad en documentos de word.

Para obtener un ejemplo completo, consulte Inicio rápido: Creación de una tarea de almacenamiento con Bicep.

resource storageTask 'Microsoft.StorageActions/storageTasks@2023-01-01' = {
  name: storageTaskName
  location: 'westus'
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    action: {
      if: {
        condition: '[[endsWith(Name, \'.docx\')]]'
        operations: [
         {
            name: 'SetBlobImmutabilityPolicy'
            onSuccess: 'continue'
            onFailure: 'break'
            parameters: {
              untilDate: '2025-06-20T20:34:00'
              mode: 'locked'
            }
         }
        ]
      }

    }
    description: 'My storage task'
    enabled: true
  }
}

Incluya un fragmento de código JSON similar al siguiente en la plantilla de Azure Resource Manager. En este ejemplo se establece una directiva de inmutabilidad en documentos de word.

Para obtener un ejemplo completo, consulte Inicio rápido: Crear una tarea de almacenamiento con una plantilla de Azure Resource Manager.

 "resources": [
    {
      "type": "Microsoft.StorageActions/storageTasks",
      "apiVersion": "2023-01-01",
      "name": "mystoragetask",
      "location": "westus",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "action": {
          "if": {
            "condition": "[[[endsWith(Name, '.docx')]]",
            "operations": [
              {
                "name": "SetBlobImmutabilityPolicy",
                "onSuccess": "continue",
                "onFailure": "break",
                "parameters": {
                  "untilDate": "2025-06-20T20:34:00",
                  "mode": "locked"
                }
              },
            ]
          }
        },
        "description": "my storage task",
        "enabled": true
      }
    }
  ]