Créer et gérer une affectation de tâche de stockage

Créer une affectation à partir du menu des tâches de stockage

Vous pouvez créer une affectation dans le contexte d’une tâche de stockage. Cette option peut être pratique si vous êtes l’auteur de tâche et que vous souhaitez cibler plusieurs comptes de stockage. Pour chaque affectation, identifiez le compte de stockage que vous souhaitez cibler.

Accédez à la tâche de stockage dans le portail Azure, puis, sous Gestion des tâches de stockage, sélectionnez Affectations.

Dans la page Affectations, sélectionnez + Ajouter une affectation et le panneau Ajouter une affectation apparaît.

Créer une affectation à partir du menu du compte de stockage

Vous pouvez également créer une assignation de tâche depuis la page Actions de stockage dans le portail du compte de stockage. Cette option peut être pratique si vous souhaitez utiliser une tâche existante pour traiter des objets dans votre compte de stockage. Pour chaque attribution, sélectionnez la tâche de stockage que vous souhaitez attribuer à votre compte.

Accédez au compte de stockage dans le portail Azure. Dans Gestion des données, sélectionnez Actions de stockage.

Dans les actions de stockage, sélectionnez l’onglet Affectation de tâches, sélectionnez + Créer une affectation, puis sélectionnez + Ajouter une affectation.

Le volet Ajouter une affectation s’affiche.

Sélectionner une étendue

Dans la section Sélectionner l’étendue , sélectionnez un abonnement et nommez l’affectation. Sélectionnez ensuite le compte de stockage que vous souhaitez cibler.

Si vous avez ouvert le volet Ajouter une attribution de rôle dans le contexte du compte de stockage, sélectionnez une tâche de stockage au lieu du compte de stockage.

Pour obtenir une description de chaque propriété, consultez Paramètres d’affectation.

Ajouter une attribution de rôle

Dans la section Attribution des rôles, sélectionnez le rôle que vous souhaitez attribuer à l’identité gérée de la tâche de stockage dans la liste déroulante Rôle. 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 requis pour attribuer des tâches.

Pour obtenir une description de chaque propriété, consultez Paramètres d’affectation.

Ajouter un filtre

Dans la section Filtrer les objets , choisissez si vous souhaitez cibler un sous-ensemble d’objets blob en fonction d’un filtre. Les filtres vous aident à affiner l’étendue de l’exécution. Si vous souhaitez que la tâche évalue tous les conteneurs et blobs d’un compte, sélectionnez l’option Ne pas filtrer . L’exemple suivant utilise un filtre pour cibler uniquement les blobs existant dans un conteneur nommé mycontainer.

Pour obtenir une description de chaque propriété, consultez Paramètres d’affectation.

Définir le déclencheur

Dans la section Détails du déclencheur , sélectionnez comment vous souhaitez exécuter cette tâche. Choisissez parmi les types d’exécution suivants :

• Exécuter une seule fois : exécutez la tâche une seule fois.
• Exécution récurrente : exécutez la tâche selon une planification périodique. Choisissez une heure de début et de fin et spécifiez le nombre de jours entre chaque exécution.
• Exécution fictive : simuler l’exécution de la tâche sans effectuer d’opérations sur des objets blob. Une simulation analyse et évalue les blobs par rapport aux conditions de la tâche, et produit un rapport détaillé indiquant quels blobs correspondent aux critères et quelles opérations auraient été effectuées. Aucune donnée n’est modifiée. Pour plus d’informations, consultez Créer et utiliser une exécution fictive.

Pour tous les types de runs, spécifiez où vous souhaitez stocker les rapports d’exécution.

Pour obtenir une description de chaque propriété, consultez Paramètres d’affectation.

Enregistrer l’affectation

Sélectionnez le bouton Ajouter pour créer l’affectation.

Le volet Ajouter une affectation se ferme. Une fois le déploiement terminé, l’affectation apparaît dans la page Affectations . Si vous ne voyez pas le devoir sur cette page, sélectionnez le bouton Rafraîchir.

Activer une affectation

L’affectation est désactivée par défaut. Pour activer l’affectation et la programmer pour s’exécuter, sélectionnez la case à cocher à côté de l’affectation, puis sélectionnez Activer.

Après l’exécution de la tâche, elle génère un rapport d’exécution et le stocke dans le conteneur que vous avez spécifié lors de la création de l’affectation. Pour plus d’informations sur le rapport et sur la manière de visualiser les métriques qui capturent le nombre d’objets ciblés, le nombre d’opérations tentées et le nombre d’opérations réussies, voir Analyser les exécutions de tâches de stockage.

Modifier un devoir

Une affectation devient une sous-ressource du compte de stockage ciblé. Ainsi, après avoir créé l’affectation, vous ne pouvez modifier que sa fréquence d’exécution. Les autres champs d’une affectation deviennent en lecture seule. L’option Une seule exécution (une seule fois) devient également en lecture seule.

• Pour modifier la fréquence d’exécution d’une affectation dans le contexte d’une tâche de stockage, allez à la tâche de stockage dans le portail Azure. Sous Gestion des tâches de stockage, sélectionnez Affectations.

• Pour modifier la fréquence d’exécution d’une affectation dans le contexte d’un compte de stockage, rendez-vous sur le compte de stockage dans le portail Azure. Dans Gestion des données, sélectionnez Actions de stockage.

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

2. Précisez à quelle fréquence vous souhaitez que la tâche s’exécute. Vous pouvez choisir d’exécuter une tâche une seule fois, ou de l’exécuter selon une planification récurrente. Si vous décidez d’exécuter cette tâche de façon récurrente, spécifiez une heure de début et de fin et le nombre de jours entre chaque exécution. Vous pouvez également spécifier l’emplacement où vous souhaitez stocker les rapports d’exécution. L’exemple suivant crée une variable pour les valeurs de déclenchement.

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

3. Obtenez la tâche de stockage que vous souhaitez inclure dans votre affectation à l’aide de la commande Get-AzStorageActionTask .

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

4. Créez une attribution de tâche de stockage à l’aide de la New-AzStorageTaskAssignment commande. L’affectation suivante cible le mycontainer conteneur d’un compte nommé mystorageaccount. Cette configuration précise que la tâche ne s’exécute qu’une seule fois, et sauvegarde les rapports d’exécution dans un dossier nommé storage-tasks-report. La tâche est planifiée pour s’exécuter en 10 minutes à partir de l’heure actuelle.

   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
   

5. Accordez à la tâche de stockage l’autorisation d’effectuer des opérations sur le compte de stockage cible en affectant un rôle à l’identité managée. Vous pouvez choisir le type d’identité managée (affecté par le système ou affecté par l’utilisateur) lorsque vous créez la tâche de stockage.

   Les commandes suivantes attribuent le rôle Storage Blob Data Owner à l'identité managée attribuée par le système de la tâche de stockage.

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

   Les commandes suivantes attribuent le rôle Storage Blob Data Owner à une identité managée affectée par l’utilisateur.

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

Créer une affectation à l’aide d’Azure CLI

1. Spécifiez la fréquence à laquelle vous souhaitez que la tâche s’exécute. Vous pouvez choisir d’exécuter une tâche une seule fois ou d’exécuter la tâche périodique. Si vous décidez d’exécuter cette tâche périodiquement, spécifiez une heure de début et de fin et spécifiez le nombre de jours entre chaque exécution. Vous pouvez également spécifier l’emplacement où vous souhaitez stocker les rapports d’exécution. L’exemple suivant crée une variable chaîne au format JSON qui spécifie le nom du conteneur, la fréquence d’exécution de la tâche (RunOnce), et l’heure d’exécution du rapport.

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

   La chaîne utilisée dans le fichier executioncontextvariable est exprimée à l’aide de 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. Obtenez l’ID de la tâche de stockage que vous souhaitez inclure dans votre affectation à l’aide de la commande az storage-actions task show , puis interrogez la id propriété.

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

3. Créez une attribution de tâche de stockage à l’aide de la az storage account task-assignment create commande.

   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. Accordez à la tâche de stockage l’autorisation d’effectuer des opérations sur le compte de stockage cible en affectant un rôle à l’identité managée. Vous pouvez choisir le type d’identité managée (affecté par le système ou affecté par l’utilisateur) lorsque vous créez la tâche de stockage.

   Les commandes suivantes attribuent le rôle Storage Blob Data Owner à l'identité managée attribuée par le système de la tâche de stockage.

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

   Les commandes suivantes attribuent le rôle Storage Blob Data Owner à une identité managée affectée par l’utilisateur.

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

Incluez un extrait de code similaire à ce qui suit dans votre modèle 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'
  }
}

Incluez un extrait de code JSON semblable à ce qui suit dans votre modèle 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"
      ]
    }
  ]