Creare e gestire un'assegnazione di attività di archiviazione

Un'assegnazione identifica un account di archiviazione e un subset di oggetti in tale account di destinazione dell'attività. Un'assegnazione definisce anche quando l'attività viene eseguita e dove vengono archiviati i report di esecuzione.

Questo articolo illustra come creare un'assegnazione e quindi abilitare l'esecuzione dell'assegnazione. Per altre informazioni sulle assegnazioni di attività di archiviazione, vedere Assegnazioni di attività di archiviazione.

Importante

Prima di abilitare l'assegnazione di attività di archiviazione, assicurarsi di concedere l'accesso ai servizi di Azure attendibili nelle impostazioni di rete di ogni account di archiviazione di destinazione. Per altre informazioni, vedere Concedere l'accesso ai servizi di Azure attendibili.

Creare e gestire un'assegnazione

Creare un'assegnazione per ciascun account di archiviazione che si desidera mirare. Un'attività di archiviazione può contenere fino a 50 assegnazioni.

Annotazioni

Nella versione corrente è possibile specificare come destinazione solo gli account di archiviazione che si trovano nella stessa area delle attività di archiviazione.

Portale

Creare un'assegnazione dal menu attività di archiviazione

È possibile creare un'assegnazione nel contesto di un'attività di archiviazione. Questa opzione può essere utile se si è l'autore dell'attività e si vuole specificare come destinazione più account di archiviazione. Per ogni assegnazione, devi identificare l'account di archiviazione che vuoi utilizzare.

Passare all'attività di archiviazione nel portale di Azure e quindi in Gestione attività di archiviazione selezionare Assegnazioni.

Nella pagina Assegnazioni selezionare + Aggiungi assegnazione e verrà visualizzato il riquadro Aggiungi assegnazione .

Creare un'assegnazione dal menu dell'account di archiviazione

È anche possibile creare un'assegnazione nel contesto di un account di archiviazione. Questa opzione può essere utile se si vuole usare un'attività esistente per elaborare gli oggetti nell'account di archiviazione. Per ogni compito, identifica l'attività di archiviazione che desideri assegnare al tuo account.

Passare all'account di archiviazione nel portale di Azure e quindi in Gestione dati selezionare Attività di archiviazione.

Nella pagina Attività di archiviazione selezionare la scheda Assegnazione attività , selezionare + Crea assegnazione e quindi selezionare + Aggiungi assegnazione.

Viene visualizzato il riquadro Aggiungi assegnazione .

Selezionare un ambito

Nella sezione Seleziona ambito selezionare una sottoscrizione e denominare l'assegnazione. Selezionare quindi l'account di archiviazione di destinazione.

Se è stato aperto il riquadro Aggiungi assegnazione nel contesto dell'account di archiviazione, si selezionerà un'attività di archiviazione anziché l'account di archiviazione.

Per una descrizione di ogni proprietà, vedere Impostazioni di assegnazione.

Aggiungere un'assegnazione di ruolo

Nella sezione Assegnazione del ruolo, nell'elenco a discesa Ruolo, selezionare il ruolo che si desidera assegnare all'identità gestita dell'attività di archiviazione. Per garantire una corretta assegnazione di attività, usare i ruoli che dispongono delle autorizzazioni Proprietario dati BLOB. Per altre informazioni, vedere Ruoli di Azure necessari per assegnare attività.

Annotazioni

Scegliere il tipo di identità gestita (assegnato dal sistema o assegnato dall'utente) come parte della creazione dell'attività di archiviazione.

Per una descrizione di ogni proprietà, vedere Impostazioni di assegnazione.

Aggiungi un filtro

Nella sezione Oggetti filtro scegliere se si vuole specificare come destinazione un subset di BLOB in base a un filtro. I filtri consentono di restringere l'ambito dell'esecuzione. Se si desidera che l'attività valuti tutti i contenitori e i BLOB in un account, è possibile selezionare l'opzione Non filtrare. Nell'esempio seguente viene usato un filtro per specificare come destinazione solo i BLOB esistenti in un contenitore denominato mycontainer.

Per una descrizione di ogni proprietà, vedere Impostazioni di assegnazione.

Definire il trigger

Nella sezione Dettagli trigger, seleziona quante volte desideri che questa attività venga eseguita. È possibile scegliere di eseguire questa attività una sola volta o di eseguire l'attività ricorrente. Se si decide di eseguire questa attività su base ricorrente, scegliere un'ora di inizio e di fine e specificare il numero di giorni tra ogni esecuzione. È anche possibile specificare dove archiviare i report di esecuzione.

Per una descrizione di ogni proprietà, vedere Impostazioni di assegnazione.

Salvare l'assegnazione

Selezionare il pulsante Aggiungi per creare l'assegnazione.

Il riquadro Aggiungi assegnazione si chiude. Al termine della distribuzione, l'assegnazione viene visualizzata nella pagina Assegnazioni . Se l'assegnazione non viene visualizzata in tale pagina, selezionare il pulsante Aggiorna .

Abilitare un'assegnazione

L'assegnazione è disabilitata per impostazione predefinita. Per abilitare l'assegnazione in modo che venga pianificata l'esecuzione, selezionare la casella di controllo visualizzata accanto all'assegnazione e quindi selezionare Abilita.

Dopo l'esecuzione dell'attività, viene generato un report di esecuzione e quindi archiviato nel contenitore specificato al momento della creazione dell'assegnazione. Per altre informazioni su tale report e su come visualizzare le metriche che acquisisce il numero di oggetti di destinazione, il numero di operazioni tentate e il numero di operazioni riuscite, vedere Analizzare le esecuzioni delle attività di archiviazione.

Modificare un'assegnazione

Un'assegnazione diventa una subrisorsa dell'account di archiviazione di destinazione. Pertanto, dopo aver creato l'assegnazione, è possibile modificare solo la frequenza di esecuzione. Gli altri campi di un'assegnazione diventano di sola lettura. Anche l'opzione Esecuzione singola (una sola volta) diventa di sola lettura.

• Per modificare la frequenza di esecuzione di un'assegnazione nel contesto di un'attività di archiviazione, passare all'attività di archiviazione nel portale di Azure e quindi in Gestione attività di archiviazione selezionare Assegnazioni.

• Per modificare la frequenza di esecuzione di un'assegnazione nel contesto di un account di archiviazione, passare all'account di archiviazione nel portale di Azure e quindi in Gestione dati selezionare Attività di archiviazione.

PowerShell

1. Prima di tutto, installare i moduli di PowerShell necessari. Vedere Installare il modulo di PowerShell

2. Specificare la frequenza di esecuzione dell'attività. È possibile scegliere di eseguire un'attività una sola volta o di eseguire l'attività ricorrente. Se si decide di eseguire questa attività su base ricorrente, specificare un'ora di inizio e di fine e specificare il numero di giorni tra ogni esecuzione. È anche possibile specificare dove archiviare i report di esecuzione. Nell'esempio seguente viene creata una variabile per i valori del trigger.

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

3. Ottenere l'attività di archiviazione da includere nell'assegnazione usando il comando Get-AzStorageActionTask .

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

4. Creare un'assegnazione di attività di archiviazione usando il New-AzStorageTaskAssignment comando . L'assegnazione seguente è destinata al mycontainer contenitore di un account denominato mystorageaccount. Questa assegnazione specifica che l'attività verrà eseguita una sola volta e salverà i report di esecuzione in una cartella denominata storage-tasks-report. L'attività è pianificata per l'esecuzione 10 minuti dal momento attuale.

   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. Concedere all'attività di archiviazione l'autorizzazione per eseguire operazioni sull'account di archiviazione di destinazione assegnando un ruolo all'identità gestita. È possibile scegliere il tipo di identità gestita (assegnato dal sistema o assegnato dall'utente) quando si crea l'attività di archiviazione.

   I comandi seguenti assegnano il ruolo di Storage Blob Data Owner all'identità gestita assegnata dal sistema dell'attività di archiviazione.

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

   I comandi seguenti assegnano il ruolo Storage Blob Data Owner a un'identità gestita assegnata dall'utente.

   $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"
   

Interfaccia della riga di comando di Azure

Creare un'assegnazione usando l'interfaccia della riga di comando di Azure

1. Specificare la frequenza di esecuzione dell'attività. È possibile scegliere di eseguire un'attività una sola volta o di eseguire l'attività ricorrente. Se si decide di eseguire questa attività su base ricorrente, specificare un'ora di inizio e di fine e specificare il numero di giorni tra ogni esecuzione. È anche possibile specificare dove archiviare i report di esecuzione. Di seguito viene creata una variabile stringa in formato JSON che specifica il nome del contenitore, la frequenza di esecuzione dell'attività (RunOnce) e il tempo necessario per eseguire il report.

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

   La stringa utilizzata in executioncontextvariable viene espressa utilizzando la sintassi abbreviata. La sintassi abbreviata è una rappresentazione semplificata di una stringa JSON. Per altre informazioni, vedere Come usare la sintassi abbreviata con l'interfaccia della riga di comando di Azure.

2. Ottieni l'ID dell'attività di archiviazione da includere nell'assegnazione usando il comando az storage-actions task show e quindi eseguendo query sulla id proprietà.

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

3. Creare un'assegnazione di attività di archiviazione usando il 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. Concedere all'attività di archiviazione l'autorizzazione per eseguire operazioni sull'account di archiviazione di destinazione assegnando un ruolo all'identità gestita. È possibile scegliere il tipo di identità gestita (assegnato dal sistema o assegnato dall'utente) quando si crea l'attività di archiviazione.

   I comandi seguenti assegnano il ruolo di Storage Blob Data Owner all'identità gestita assegnata dal sistema dell'attività di archiviazione.

   $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" 
   

   I comandi seguenti assegnano il ruolo Storage Blob Data Owner a un'identità gestita assegnata dall'utente.

   $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" 
   

Bicipite

Includere un frammento di codice simile al seguente nel modello 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'
  }
}

Modello

Includere un frammento di codice JSON simile al seguente nel modello di 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"
      ]
    }
  ]

Vedere anche

• Assegnazioni di attività di archiviazione
• Panoramica di Azioni di archiviazione di Azure
• Analizzare le esecuzioni delle attività di archiviazione