Creare un'attività di archiviazione

Nella portale di Azure cercare Attività di archiviazione. Quindi, in Servizi selezionare Attività di archiviazione - Archiviazione di Azure Azioni.

Nelle azioni Archiviazione di Azure | Pagina Attività di archiviazione, selezionare Crea.

Scheda Informazioni di base

Nella scheda Informazioni di base specificare le informazioni essenziali per l'attività di archiviazione. La tabella seguente descrive i campi della scheda Nozioni di base.

L'immagine seguente mostra un esempio della scheda Informazioni di base .

Scheda Condizioni

Nella scheda Condizioni definire le condizioni che devono essere soddisfatte da ogni oggetto (contenitore o BLOB) e dalle operazioni da eseguire sull'oggetto .

È necessario definire almeno una condizione e un'operazione. Per aggiungere una clausola a una condizione, selezionare Aggiungi nuova clausola. Per aggiungere operazioni, selezionare Aggiungi nuova operazione.

Nella tabella seguente vengono descritti i campi nella scheda Condizioni .

L'immagine seguente mostra un esempio della scheda Condizioni .

È possibile selezionare Condizioni di anteprima per visualizzare un elenco di BLOB interessati dalle condizioni definite. Per altre informazioni, vedere Visualizzare in anteprima l'effetto delle condizioni.

Scheda Assegnazioni

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.

Per aggiungere un'assegnazione, selezionare Aggiungi assegnazione. Questo passaggio è facoltativo. Non è necessario aggiungere un'assegnazione per creare l'attività.

Nella tabella seguente vengono descritti i campi visualizzati nel riquadro Aggiungi assegnazione .

selezionare il ruolo da assegnare all'identità gestita assegnata dal sistema 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 per le attività di archiviazione

L'immagine seguente mostra un esempio del riquadro Aggiungi assegnazione .

Scheda Tag

Nella scheda Tag è possibile specificare i tag di Resource Manager per semplificare l'organizzazione delle risorse di Azure. Per altre informazioni, vedere Contrassegnare le risorse, i gruppi di risorse e le sottoscrizioni per un'organizzazione logica.

L'immagine seguente mostra una configurazione standard delle proprietà tag indice per un nuovo account di archiviazione.

Scheda Rivedi e crea

Quando si passa alla scheda Rivedi e crea , Azure esegue la convalida nelle impostazioni dell'attività di archiviazione scelte. Se la convalida viene superata, è possibile procedere con la creazione dell'attività di archiviazione.

Se la convalida ha esito negativo, il portale indica quali impostazioni devono essere modificate.

L'immagine seguente mostra i dati della scheda Rivedi prima della creazione di una nuova attività di archiviazione.

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

2. Definire una condizione usando JSON. Una condizione è una raccolta di una o più clausole. Ogni clausola contiene una proprietà, un valore e un operatore. Per altre informazioni, vedere Condizioni delle attività di archiviazione.

   $condition = "<condition-json>"
   

3. Definire ogni operazione usando il comando New-AzStorageActionTaskOperationObject . Per altre informazioni, vedere Operazioni delle attività di archiviazione

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

4. Creare un'attività di archiviazione usando il comando New-AzStorageActionTask e passare tutte le condizioni e le operazioni definite dall'utente. Il comando seguente crea un'attività di archiviazione e abilita l'identità gestita dal sistema dell'attività. Le assegnazioni di attività di archiviazione usano le autorizzazioni applicate all'identità gestita dal sistema per autorizzare l'accesso.

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

   Per autorizzare le assegnazioni usando un'identità gestita assegnata dall'utente, è necessario specificare tale identità come parametro per il comando New-AzStorageActionTask . Il comando seguente crea un'attività di archiviazione e specifica un'identità gestita assegnata dall'utente. Le assegnazioni di attività di archiviazione usano le autorizzazioni applicate all'identità gestita assegnata dall'utente per autorizzare l'accesso.

   $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
   

   Per informazioni su come creare un'assegnazione tramite PowerShell, vedere Creare e gestire un'assegnazione di attività di archiviazione.

1. Definire una condizione usando JSON. Una condizione è una raccolta di una o più clausole. Ogni clausola contiene una proprietà, un valore e un operatore. Per altre informazioni, vedere Condizioni delle attività di archiviazione.

   conditionclause="<condition-json>"
   

   Suggerimento

   L'interfaccia della riga di comando di Azure usa 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. Creare un'attività di archiviazione usando il comando az storage-actions task create e passare un'espressione in formato JSON delle condizioni e delle operazioni. Questo esempio trova i BLOB nel livello di archiviazione fresco e li sposta nel livello di archiviazione caldo. Tutti gli altri BLOB vengono eliminati. Il comando seguente crea un'attività di archiviazione e specifica un'identità gestita assegnata dal sistema. Le assegnazioni di attività di archiviazione usano le autorizzazioni applicate all'identità gestita assegnata dal sistema per autorizzare l'accesso.

   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
   

   Per autorizzare le assegnazioni usando un'identità gestita assegnata dall'utente, è necessario specificare tale identità come parametro per il comando az storage-actions task create . Il comando seguente crea un'attività di archiviazione e specifica un'identità gestita assegnata dall'utente. Le assegnazioni di attività di archiviazione usano le autorizzazioni applicate all'identità gestita assegnata dall'utente per autorizzare l'accesso.

   $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
   

   Per altre informazioni sulle operazioni, vedere Operazioni delle attività di archiviazione.

   Per informazioni su come creare un'assegnazione usando l'interfaccia della riga di comando di Azure, vedere Creare e gestire un'assegnazione di attività di archiviazione.

Includere un frammento di codice simile al seguente nel modello Bicep. In questo esempio viene impostato un criterio di immutabilità nei documenti di word.

Per un esempio completo, vedere Avvio rapido: Creare un'attività di archiviazione 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
  }
}

Includere un frammento di codice JSON simile al seguente nel modello di Azure Resource Manager. In questo esempio viene impostato un criterio di immutabilità nei documenti di word.

Per un esempio completo, vedere Avvio rapido: creare un'attività di archiviazione con un modello di 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
      }
    }
  ]