Définir des conditions et des opérations de tâche de stockage
Vous pouvez utiliser un éditeur visuel pour définir les conditions et les opérations d'une tâche de stockage.
Important
Azure Storage Actions est actuellement en PRÉVERSION et est disponible dans ces régions. Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.
Une opération est une action effectuée sur chaque objet qui répond aux conditions définies dans la tâche. Une condition contient une ou plusieurs clauses conditionnelles. Chaque clause définit la relation entre une propriété et une valeur. Pour exécuter une opération définie dans la tâche de stockage, les termes de cette relation doivent être respectés par chaque objet.
Ouvrez l'éditeur de conditions
Accédez à la tâche de stockage dans le Portail Microsoft Azure, puis sous Gestion des tâches de stockage, sélectionnez Conditions.
L’onglet Générateur visuel du volet Conditions apparaît.
Définir les conditions
Définissez une condition en ajoutant des clauses. Une clause définit la relation entre une propriété et une valeur. Pour exécuter une opération définie dans la tâche de stockage, les termes de cette relation doivent être respectés par chaque objet.
Ajoutez et supprimez des clauses
Pour ajouter une clause, sélectionnez Ajouter une nouvelle clause et pour supprimer une clause, sélectionnez l’icône de suppression (
) qui apparaît à côté.
Précisez les termes d'une clause
Pour définir une clause, choisissez une propriété, spécifiez une valeur pour cette propriété, puis choisissez un opérateur qui les relie entre elles.
Choisissez une propriété
Dans la liste déroulante Propriété Blob, choisissez une propriété. Voyez Propriétés blob prises en charge.
L'exemple suivant sélectionne la propriété Nom du blob.
Choisissez une valeur et un opérateur
Dans la zone Valeur de la propriété, entrez une valeur et dans la liste déroulante Opérateur, choisissez un opérateur. Voyez les opérateurs pris en charge.
L'exemple suivant spécifie une valeur de .log avec l'opérateur Se termine par. Cette condition permet à l’opération définie dans cette tâche de stockage de s’exécuter uniquement sur les blobs qui ont une extension de fichier .log.
Utilisez un caractère générique dans les valeurs de chaîne
Vous pouvez utiliser les caractères génériques * et ? dans la valeur d'une propriété de chaîne. Le caractère * représente zéro ou plusieurs caractères tandis qu'un caractère ? représente exactement un caractère.
Par exemple, si vous souhaitez que votre clause soit évaluée à true uniquement pour les blobs qui sont des documents Word, vous utiliserez la chaîne *.docx. Cependant, si vous souhaitez que seuls les documents soient nommés avec un seul caractère tel que 1.docx ou 2.docx, vous utiliserez alors la chaîne ?.docx.
Vous pouvez utiliser le * ou ? n'importe où dans une chaîne. Vous pouvez échapper à ces caractères en ajoutant un \ juste avant le caractère.
Référencez une valeur à partir des métadonnées d'un objet
Les clauses qui incluent une propriété de date et d'heure peuvent référencer une valeur à partir des métadonnées d'un conteneur ou d'une balise d'index d'un blob. Ces valeurs sont obtenues dynamiquement au moment de l'exécution de la tâche.
Dans votre compte de stockage, vous pouvez ajouter une clé aux métadonnées d'un conteneur ou aux balises d'index d'un blob. La valeur de cette clé doit être un intervalle de temps au format ISO 8601. Par exemple, vous pouvez ajouter une clé nommée retainfor avec une valeur de chaîne PT5M qui représente un intervalle de cinq minutes.
Pour référencer une clé, sélectionnez le lien Modifier qui apparaît dans la colonne Valeur de la propriété. Ensuite, dans la boîte de dialogue Sélectionner une valeur, sélectionnez Métadonnées du conteneur ou Balises d’index Blob.
L'exemple suivant ajoute la propriété Heure de création, l'opérateur Plus tôt que et référence une clé nommée retainFor dans les balises d'index de chaque blob évalué.
Cette condition teste si un blob a été créé avant une certaine durée par rapport à maintenant (la date et l'heure actuelles). Par exemple, si la valeur récupérée de la balise retainFor est de cinq minutes, cette condition vérifie si le blob a été créé il y a plus de 5 minutes.
Remarque
Dans l’onglet Code, vous verrez la logique de cet exemple représentée d’une manière légèrement différente. Le code généré teste si l'heure actuelle est supérieure à l'heure de création plus l'intervalle de temps. Les deux représentations donnent le même résultat.
Si la clé n'est pas présente pour un objet évalué, la condition est alors évaluée à faux. Si la valeur clé est une chaîne non conforme à la norme ISO 8601, une erreur est signalée dans le rapport d'exécution.
Appliquez Et/Ou à une clause
Vous ajoutez Et ou Ou à une clause. Spécifiez Et si vous souhaitez cibler les objets qui répondent aux critères de la clause actuelle et de la clause précédente de la condition. Spécifiez Ou pour cibler les objets qui répondent au critère de la clause actuelle ou de la clause précédente.
L'exemple suivant montre des clauses qui utilisent Et. Dans cet exemple, la tâche de stockage cible les objets qui ont une extension .log et dont la balise nommée Archive-Status est définie sur Ready.
Changez l'ordre des clauses
Vous pouvez organiser les clauses dans un ordre qui, selon vous, améliorera les performances d'une tâche exécutée. Par exemple, au lieu de tester d’abord tous les blobs d’un compte par rapport à un filtre de nom, vous pouvez élever une clause qui cible un conteneur spécifique. Ce petit ajustement peut empêcher la tâche d’effectuer des évaluations inutiles.
Tout d’abord, sélectionnez la clause. Ensuite, sélectionnez Déplacer la clause vers le haut ou Déplacer la clause vers le bas pour modifier sa position dans la liste.
L'exemple suivant montre le résultat de la sélection d'une clause, puis de la sélection de Déplacer la clause vers le haut.
Clauses de groupe et de dégroupement
Les clauses groupées fonctionnent comme une seule unité distincte du reste des clauses. Le regroupement de clauses est similaire à l’insertion de parenthèses autour d’une équation mathématique ou d’une expression logique. L’opérateur And ou Or de la première clause du groupe s’applique à l’ensemble du groupe.
Cochez la case qui apparaît à côté de chaque clause que vous souhaitez regrouper. Ensuite, sélectionnez Groupe.
L'exemple suivant montre deux conditions regroupées. Dans cet exemple, l'opération s'exécute si un blob a l'extension .log et qu'une balise nommée Archive-Status est définie sur la valeur de Ready ou que le fichier n'a pas été consulté depuis 120 jours.
Pour dissocier des clauses, sélectionnez l'icône de dissociation (
) ou sélectionnez chaque clause du groupe, puis sélectionnez Dissocier.
Prévisualisez l'effet des conditions
Vous pouvez afficher une liste des blobs qui seraient impactés par les conditions que vous avez définies. Dans l'éditeur de conditions, sélectionnez Aperçu des conditions.
Dans les conditions d’aperçu, vous pouvez spécifier un abonnement cible, un compte de stockage et un conteneur. Étant donné qu'un aperçu ne peut afficher que 5 000 blobs, vous pouvez également spécifier un préfixe pour affiner la liste.
Définir les opérations
Une opération est une action effectuée sur chaque objet qui répond aux conditions définies dans la tâche.
Ajoutez et supprimez des opérations
Pour ajouter une opération, sélectionnez Ajouter une nouvelle opération et pour supprimer une opération, sélectionnez l’icône de suppression ( ) qui apparaît à côté.
Choisir une opération
Dans la liste déroulante Opération, choisissez une opération. Voyez Opérations prises en charge.
L'exemple suivant sélectionne la propriété Définir les balises blob.
Choisissez un paramètre
Saisissez ou sélectionnez les paramètres appropriés à l’opération.
L'exemple suivant définit la balise Archive-Status sur la valeur Archived.
Modifiez l'ordre des opérations
Vous pouvez organiser les opérations dans n’importe quel ordre.
Dans cet exemple, l’ordre existant a du sens. Les blobs sont d’abord archivés et les balises sont définies. Cela n'aurait aucun sens de définir la balise avant de changer le niveau juste au cas où la tentative de changement du niveau d'un blob échouerait. Si l'opération de définition de balise blob apparaît en premier dans la liste, vous pouvez envisager de déplacer cette opération sous l'opération de définition de niveau blob.
Pour déplacer une opération, sélectionnez la case à cocher qui apparaît à côté d’elle. Ensuite, sélectionnez Déplacer l’opération vers le haut ou Déplacer l’opération vers le bas pour modifier sa position dans la liste.