Création d’une tâche de stockage

Dans le portail Azure, recherchez Tâches de stockage. Ensuite, dans la section Services, sélectionnez Tâches de stockage – Actions de stockage Azure.

Sur stockage Azure Actions | Tâches de stockage, sélectionnez Créer.

Onglet Informations de base

Dans l’onglet Notions de base, saisissez les informations essentielles pour votre tâche de stockage. Le tableau suivant décrit les champs de l’onglet Informations de base.

L’image suivante illustre un exemple de l’onglet Informations de base.

Onglet Conditions

Dans l’onglet Conditions , définissez les conditions que chaque objet doit remplir, ainsi que les opérations à effectuer sur l’objet.

Vous devez configurer au minimum une condition et une opération. Pour ajouter une clause à une condition, sélectionnez Add new clause. Pour ajouter des opérations, sélectionnez Add new operation.

Le tableau suivant décrit les champs disponibles dans l’onglet Conditions.

L’image suivante présente un exemple de l’onglet Conditions.

Sélectionnez Conditions de la préversion pour voir une liste de blobs qui satisfont aux conditions que vous avez définies pour les opérations. Pour plus d’informations, consultez Afficher un aperçu de l’effet des conditions.

Onglet Attributions

Une affectation permet d’identifier un compte de stockage ainsi qu’un sous-ensemble d’objets au sein de ce compte à cibler pendant l'exécution. Une affectation définit également le moment d’exécution de la tâche et l’emplacement où les rapports d’exécution sont stockés.

Pour ajouter une affectation, sélectionnez Ajouter une affectation. Cette étape est facultative. Il n’est pas obligatoire d’ajouter une affectation pour créer la tâche.

Le tableau suivant décrit les champs affichés dans le volet Ajouter une affectation.

Sélectionnez le rôle que vous souhaitez attribuer à l’identité managée assignée par le système pour la tâche de stockage. Pour garantir une attribution de tâche réussie, utilisez des rôles disposant des autorisations de Propriétaire des données Blob. Pour en savoir plus, consultez les rôles Azure pour les tâches de stockage.

L’image suivante montre un exemple du volet Ajouter une affectation.

Onglet balises

Sous l’onglet Tags, spécifiez Resource Manager balises pour organiser vos ressources Azure. Pour plus d’informations, consultez Baliser les ressources, les groupes de ressources et les abonnements pour l’organisation logique.

L’illustration suivante montre une configuration standard des propriétés de balise d’index pour un nouveau compte de stockage.

Onglet Vérifier + créer

Lorsque vous allez dans l’onglet Vérifier + créer, Azure effectue une validation sur les paramètres de tâches de stockage que vous avez choisis. Si la validation passe, vous pouvez créer la tâche de stockage.

Si la validation échoue, le portail indique quels réglages doivent être modifiés.

L’image suivante présente les informations affichées dans l’onglet Vérifier avant la création d’une nouvelle tâche de stockage.

1. Tout d’abord, installez les modules PowerShell nécessaires. Voir Installer le module PowerShell.

2. Définissez une condition à l’aide de JSON. Une condition est un prédicat logique composé d’une ou plusieurs propositions. Chaque clause contient une propriété, une valeur et un opérateur. Pour en savoir plus, consultez les conditions des tâches de stockage.

   $condition = "<condition-json>"
   

3. Définissez chaque opération à l’aide de la commande New-AzStorageActionTaskOperationObject . Pour en savoir plus, voir Opérations de tâches de stockage.

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

4. Créez une tâche de stockage à l’aide de la commande New-AzStorageActionTask et transmettez les conditions et opérations que vous définissez. La commande suivante crée une tâche de stockage et une identité gérée par le système associée pour celle-ci. Storage Actions utilise les permissions attribuées à cette identité gérée par le système pour autoriser l’accès.

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

   Vous avez également la possibilité de spécifier une identité managée attribuée par l’utilisateur pour l’autorisation. Vous devez fournir cette identité comme paramètre à la commande New-AzStorageActionTask . Actions de stockage utilise les permissions attribuées à cette identité gérée pour l’autorisation. La commande suivante crée une tâche de stockage et spécifie une identité managée attribuée par l’utilisateur.

   $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
   

   Pour savoir comment créer une affectation à l’aide de PowerShell, consultez Créer et gérer une affectation de tâche de stockage.

1. Définissez une condition à l’aide de JSON. Une condition est un prédicat logique composé d’une ou plusieurs propositions. Chaque clause contient une propriété, une valeur et un opérateur. Pour en savoir plus, consultez les conditions des tâches de stockage.

   conditionclause="<condition-json>"
   

   Conseil / Astuce

   Azure CLI utilise la syntaxe abrégée. La syntaxe abrégée est une représentation simplifiée d’une chaîne JSON. Pour en savoir plus, consultez Comment utiliser la syntaxe abrégée avec Azure CLI.

2. Créez une tâche de stockage à l’aide de la commande az storage-actions create , puis transmettez une expression au format JSON des conditions et opérations. Cet exemple recherche des objets blob dans le niveau froid et les déplace vers le niveau chaud. Tous les autres objets blob sont supprimés. La commande suivante crée une tâche de stockage et spécifie une identité managée affectée par le système. Les attributions de tâches de stockage utilisent des autorisations appliquées à l’identité managée affectée par le système pour autoriser l’accès.

   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 vous souhaitez que les affectations soient autorisées à l’aide d’une identité managée affectée par l’utilisateur, vous devez fournir cette identité en tant que paramètre à la commande az storage-actions task create . La commande suivante crée une tâche de stockage et spécifie une identité managée affectée par l’utilisateur. Les attributions de tâches de stockage utilisent des autorisations appliquées à l’identité managée affectée par l’utilisateur pour autoriser l’accès.

   $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
   

   Pour en savoir plus sur les opérations, consultez opérations de tâche de stockage.

   Pour savoir comment créer une affectation à l’aide d’Azure CLI, consultez Créer et gérer une attribution de tâche de stockage.

Incluez un extrait de code similaire à ce qui suit dans votre modèle Bicep. Cet exemple montre comment définir une stratégie d’immuabilité sur les documents word.

Pour obtenir un exemple complet, consultez Démarrage rapide : Créer une tâche de stockage avec 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
  }
}

Incluez un extrait de code JSON semblable à ce qui suit dans votre modèle Azure Resource Manager. Cet exemple établit une politique d’immutabilité sur les documents Word.

Pour obtenir un exemple complet, consultez Démarrage rapide : Créer une tâche de stockage avec un modèle ARM.

 "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
      }
    }
  ]