Creación y administración de una asignación de tareas de almacenamiento

Crear una asignación desde el menú de tareas de almacenamiento

Puede crear una asignación en el contexto de una tarea de almacenamiento. Esta opción puede ser cómoda si es el autor de la tarea y quiere tener como destino varias cuentas de almacenamiento. Para cada asignación, identificará la cuenta de almacenamiento a la que desea dirigirse.

Vaya a la tarea de almacenamiento en Azure Portal y, a continuación, en Administración de tareas de almacenamiento, seleccione Asignaciones.

En la página Asignaciones , seleccione + Agregar asignación y aparecerá el panel Agregar asignación .

Crear una asignación desde el menú de la cuenta de almacenamiento

También puede crear una asignación en el contexto de una cuenta de almacenamiento. Esta opción puede ser cómoda si desea usar una tarea existente para procesar objetos en la cuenta de almacenamiento. Para cada asignación, identificarás la tarea de almacenamiento que deseas asignar a tu cuenta.

Vaya a la cuenta de almacenamiento en Azure Portal y, a continuación, en Administración de datos, seleccione Tareas de almacenamiento.

En la página Tareas de almacenamiento , seleccione la pestaña Asignación de tareas , seleccione + Crear asignación y, a continuación, seleccione + Agregar asignación.

Aparece el panel Agregar asignación .

Selección de un ámbito

En la sección Seleccionar ámbito , seleccione una suscripción y asigne un nombre a la asignación. A continuación, seleccione la cuenta de almacenamiento a la que desea dirigirse.

Si abrió el panel Agregar asignación en el contexto de la cuenta de almacenamiento, seleccionará una tarea de almacenamiento en lugar de la cuenta de almacenamiento.

Para obtener una descripción de cada propiedad, consulte Configuración de asignación.

Adición de una asignación de roles

En la sección Asignación de roles, en la lista desplegable Rol , seleccione el rol que desea asignar a la identidad administrada 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 necesarios para asignar tareas.

Para obtener una descripción de cada propiedad, consulte Configuración de asignación.

Agregar un filtro

En la sección Filtrar objetos , elija si desea establecer como destino un subconjunto de blobs basados en un filtro. Los filtros le ayudan a restringir el ámbito de ejecución. Si desea que la tarea evalúe todos los contenedores y blobs de una cuenta, puede seleccionar la opción No filtrar . En el ejemplo siguiente se usa un filtro para dirigir solo los blobs que existen en un contenedor denominado mycontainer.

Para obtener una descripción de cada propiedad, consulte Configuración de asignación.

Definición del desencadenador

En la sección Detalles del desencadenador , seleccione la frecuencia con la que desea ejecutar esta tarea. Puede optar por ejecutar esta tarea solo una vez o ejecutar la tarea periódicamente. Si decide ejecutar esta tarea de forma periódica, elija una hora de inicio y finalización y especifique el número de días entre cada ejecución. También puede especificar dónde desea almacenar los informes de ejecución.

Para obtener una descripción de cada propiedad, consulte Configuración de asignación.

Guardar la asignación

Seleccione el botón Agregar para crear la asignación.

El panel Agregar asignación se cierra. Una vez completada la implementación, la asignación aparece en la página Asignaciones . Si no ve la asignación en esa página, seleccione el botón Actualizar .

Habilitar una asignación

La asignación está deshabilitada de forma predeterminada. Para habilitar la asignación para que se programe la ejecución, active la casilla que aparece junto a la asignación y, a continuación, seleccione Habilitar.

Una vez que se ejecuta la tarea, se genera un informe de ejecución y, a continuación, se almacena en el contenedor que especificó al crear la asignación. Para obtener más información sobre ese informe, así como cómo ver las métricas que capturan el número de objetos de destino, el número de operaciones intentadas y el número de operaciones que se realizaron correctamente, consulte Análisis de ejecuciones de tareas de almacenamiento.

Edición de una asignación

Una asignación se convierte en un subrecurso de la cuenta de almacenamiento de destino. Por lo tanto, después de crear la asignación, solo se puede editar la frecuencia de ejecución. Los demás campos de una asignación se convierten en de solo lectura. La opción Ejecución única (solo una vez) también se convierte en de solo lectura.

• Para editar la frecuencia de ejecución de una asignación en el contexto de una tarea de almacenamiento, vaya a la tarea de almacenamiento en Azure Portal y, a continuación, en Administración de tareas de almacenamiento, seleccione Asignaciones.

• Para editar la frecuencia de ejecución de una asignación en el contexto de una cuenta de almacenamiento, vaya a la cuenta de almacenamiento en Azure Portal y, a continuación, en Administración de datos, seleccione Tareas de almacenamiento.

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

2. Especifique la frecuencia con la que desea que se ejecute la tarea. Puede optar por ejecutar una tarea solo una vez o ejecutar la tarea periódicamente. Si decide ejecutar esta tarea de forma periódica, especifique una hora de inicio y finalización y especifique el número de días entre cada ejecución. También puede especificar dónde desea almacenar los informes de ejecución. En el ejemplo siguiente se crea una variable para los valores de desencadenador.

   $startTime = $startTime = (Get-Date).AddMinutes(10) 
   $reportPrefix = "my-storage-task-report"
   $triggerType = RunOnce
   $targetPrefix = "mycontainer/"
   

3. Obtenga la tarea de almacenamiento que desea incluir en la asignación mediante el comando Get-AzStorageActionTask .

   $task = Get-AzStorageActionTask -Name <"storage-task-name"> -ResourceGroupName "<resource-group>"
   

4. Cree una asignación de tareas de almacenamiento mediante el New-AzStorageTaskAssignment comando . La siguiente asignación tiene como destino el mycontainer contenedor de una cuenta denominada mystorageaccount. Esta asignación especifica que la tarea solo se ejecutará una vez y guardará los informes de ejecución en una carpeta denominada storage-tasks-report. La tarea está programada para ejecutarse 10 minutos a partir de ahora.

   New-AzStorageTaskAssignment `
   -ResourceGroupName "<resource-group>" `
   -AccountName "<storage-account-name>" `
   -name "<storage-task-assignment-name>" `
   -TaskId $task.ID `
   -ReportPrefix $reportPrefix `
   -TriggerType $triggerType `
   -StartOn $startTime.ToUniversalTime() `
   -Description "<description>" `
   -Enabled:$true `
   -TargetPrefix $targetPrefix `
   -TargetExcludePrefix ""
   

5. Conceda permiso a la tarea de almacenamiento para realizar operaciones en la cuenta de almacenamiento de destino mediante la asignación de un rol a la identidad administrada. Puede elegir el tipo de identidad administrada (asignado por el sistema o asignado por el usuario) al crear la tarea de almacenamiento.

   Los siguientes comandos asignan el rol de Storage Blob Data Owner a la identidad administrada asignada por el sistema de la tarea de almacenamiento.

   New-AzRoleAssignment `
   -ResourceGroupName "<resource-group>" `
   -ResourceName "<storage-account-name>" `
   -ResourceType "Microsoft.Storage/storageAccounts" `
   -ObjectId $task.IdentityPrincipalId  `
   -RoleDefinitionName "Storage Blob Data Owner"
   

   Los siguientes comandos asignan el rol Storage Blob Data Owner a una identidad administrada asignada por el usuario.

   $managedIdentity = Get-AzUserAssignedIdentity -ResourceGroupName <resource-group> -Name <user-assigned-managed-identity-name>
   
   New-AzRoleAssignment `
   -ResourceGroupName "<resource-group>" `
   -ResourceName "<storage-account-name>" `
   -ResourceType "Microsoft.Storage/storageAccounts" `
   -ObjectId $managedIdentity.Id  `
   -RoleDefinitionName "Storage Blob Data Owner"
   

Creación de una asignación mediante la CLI de Azure

1. Especifique la frecuencia con la que desea que se ejecute la tarea. Puede optar por ejecutar una tarea solo una vez o ejecutar la tarea periódicamente. Si decide ejecutar esta tarea de forma periódica, especifique una hora de inicio y finalización y especifique el número de días entre cada ejecución. También puede especificar dónde desea almacenar los informes de ejecución. A continuación se crea una variable de cadena con formato JSON que especifica el nombre del contenedor, la frecuencia de ejecución de la tarea (RunOnce) y el tiempo para ejecutar el informe.

      current_datetime=$(date +"%Y-%m-%dT%H:%M:%S")
      executioncontextvariable="{target:{prefix:[mycontainer/],excludePrefix:[]},trigger:{type:'RunOnce',parameters:{startOn:'"${current_datetime}"'}}}"
   

   La cadena usada en executioncontextvariable se expresa mediante 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. Obtenga el identificador de la tarea de almacenamiento que desea incluir en la asignación mediante el comando az storage-actions task show y, a continuación, consulte la id propiedad .

 id=$(az storage-actions task show -g "<resource-group>" -n "<storage-task-name>" --query "id")

3. Cree una asignación de tareas de almacenamiento mediante el az storage account task-assignment create comando .

   az storage account task-assignment create \
      -g '<resource-group>' \
      -n '<storage-task-assignment-name>' \
      --account-name '<storage-account-name>' \
      --description '<description>' \
      --enabled true \
      --task-id $id \
      --execution-context $executioncontextvariable \
      --report "{prefix:storage-tasks-report}"
   

4. Conceda permiso a la tarea de almacenamiento para realizar operaciones en la cuenta de almacenamiento de destino mediante la asignación de un rol a la identidad administrada. Puede elegir el tipo de identidad administrada (asignado por el sistema o asignado por el usuario) al crear la tarea de almacenamiento.

   Los siguientes comandos asignan el rol de Storage Blob Data Owner a la identidad administrada asignada por el sistema de la tarea de almacenamiento.

   $storageAccountID=az storage account show --name <storage-account-name> --resource-group <resource-group> --query "id"
   $roleDefinitionId="b7e6dc6d-f1e8-4753-8033-0f276bb0955b" \
   
   
   az role assignment create \
      --assignee-object-id $principalID \
      --scope $storageAccountID \
      --role $roleDefinitionId \
      --description "My role assignment" 
   

   Los siguientes comandos asignan el rol Storage Blob Data Owner a una identidad administrada asignada por el usuario.

   $storageAccountID=az storage account show --name <storage-account-name> --resource-group <resource-group> --query "id"
   $roleDefinitionId="b7e6dc6d-f1e8-4753-8033-0f276bb0955b"
   $identityId=az identity show --name <user-assigned-managed-identity-name> \
   --resource-group <resource-group> --query "id"
   
    az role assignment create \
    --assignee-object-id $identityId 
      --role $roleDefinitionId \
      --description "My role assignment" 
   

Incluya un fragmento de código similar al siguiente en la plantilla de Bicep.

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-02-01' = {
  name: 'mystorageaccount'
  location: 'westus'
  kind: 'StorageV2'
  sku: {
    name: 'Standard_LRS'
  }
}

resource storageAccountName_storageTaskAssignment 'Microsoft.Storage/storageAccounts/storageTaskAssignments@2023-05-01' = {
  parent: storageAccount
  name: 'mystoragetaskassignment'
  properties: {
    taskId: '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.StorageActions/storageTasks/mystoragetask'
    enabled: true
    executionContext: {
      target: {
        prefix: [
          'mycontainer/'
        ]
        excludePrefix: []
      }
      trigger: {
        type: 'RunOnce'
        parameters: {
          startOn: '2025-04-20T21:34:00'
        }
      }
    }
    report: {
      prefix: 'storage-tasks-report'
    }
    description: 'mystoragetaskassignment'
  }
}

Incluya un fragmento de código JSON similar al siguiente en la plantilla de Azure Resource Manager.

  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-02-01",
      "name": "mystorageaccount",
      "location": "westus",
      "kind": "StorageV2",
      "sku": {
        "name": "Standard_LRS"
      }
    },
    {
      "type": "Microsoft.Storage/storageAccounts/storageTaskAssignments",
      "apiVersion": "2023-05-01",
      "name": "storagetaskassignmentname",
      "properties": {
        "taskId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.StorageActions/storageTasks/mystoragetask",
        "enabled": true,
        "executionContext": {
          "target": {
            "prefix": [
              "mycontainer/"
            ],
            "excludePrefix": []
          },
          "trigger": {
            "type": "RunOnce",
            "parameters": {
              "startOn": "2025-04-20T21:34:00"
            }
          }
        },
        "report": {
          "prefix": "storage-tasks-report"
        },
        "description": "[parameters('storageTaskAssignmentDescription')]"
      },
      "dependsOn": [
        "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myresourcegroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount"
      ]
    }
  ]