Créer une tâche de stockage

Dans le Portail Microsoft Azure, recherchez Tâches de stockage. Ensuite, sous Services, sélectionnez Tâches de stockage - Actions de stockage Azure.

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

Onglet Informations de base

Dans l’onglet Bases, fournissez 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 montre un exemple de l’onglet Bases.

Onglet Conditions

Dans l'onglet Conditions, définissez les conditions qui doivent être remplies par chaque objet (conteneur ou blob) et les opérations à effectuer sur l'objet.

Vous devez définir au moins une condition et une opération. Pour ajouter une clause à une condition, sélectionnez Ajouter une nouvelle clause. Pour ajouter des opérations, sélectionnez Ajouter une nouvelle opération.

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

L'image suivante montre un exemple de l'onglet Conditions.

Vous pouvez sélectionner Conditions d’aperçu pour afficher une liste d’objets blob qui seraient affectés par les conditions que vous avez définies. Pour plus d’informations, consultez Afficher un aperçu de l’effet des conditions.

Onglet Attributions

Une affectation identifie un compte de stockage et un sous-ensemble d’objets dans ce compte que la tâche cible. Une affectation définit également quand la tâche s’exécute et où les rapports d’exécution sont stockés.

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

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

sélectionnez le rôle que vous souhaitez attribuer à l’identité managée affectée par le système de 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

Dans l’onglet Balises, vous pouvez spécifier des balises Resource Manager pour faciliter l’organisation de 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 accédez à l’onglet Réviser + créer, Azure exécute la validation sur les paramètres de tâche de stockage que vous avez choisis. Si la validation réussit, vous pouvez procéder à la création de la tâche de stockage.

Si la validation échoue, le portail indique les paramètres qui doivent être modifiés.

L'image suivante montre les données de l'onglet Révision 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 composée d'une collection d'une ou de plusieurs clauses. 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, consultez les opérations de tâche 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 active l’identité gérée par le système de la tâche. Les attributions de tâches de stockage utilisent des autorisations appliquées à cette identité managé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
   

   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 New-AzStorageActionTask . 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.

   $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 composée d'une collection d'une ou de plusieurs clauses. 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 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 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
      }
    }
  ]