IFileStagingArtifact Interface

Définition

Espace de noms:

Microsoft.Azure.Batch

Assembly:

Microsoft.Azure.Batch.dll

Paquet:

Microsoft.Azure.Batch v16.2.0

Source:

IFileStagingArtifact.cs

Contient des informations sur un processus de préproduction de fichiers. La préproduction de fichiers est généralement effectuée pour un CloudTask (voir FilesToStage).

public interface IFileStagingArtifact

type IFileStagingArtifact = interface

Public Interface IFileStagingArtifact

Dérivé

Microsoft.Azure.Batch.FileStaging.SequentialFileStagingArtifact

Remarques

IFileStagingArtifact permet à une application de personnaliser et d’obtenir des informations sur le processus de chargement de fichiers dans le cloud, par exemple dans le cadre d’une opération liée à des tâches comme JobOperations.AddTaskAsync ou CloudJob.AddTaskAsync. Les applications peuvent utiliser ces informations pour, par exemple, découvrir les conteneurs qui ont été créés dans stockage Azure dans le cadre du processus de chargement.

Lorsque JobOperations.AddTaskAsync est appelé, le client Batch envoie les tâches au service Batch dans les collections. Au fur et à mesure que chaque collection est traitée, le client Batch effectue une préproduction de fichiers pour cette collection : il examine les tâches pour voir si l’une d’elles spécifie FilesToStageune entrée de dictionnaire pour chaque type de IFileStagingProvider dans la collection FilesToStage. La clé de l’entrée du dictionnaire est celle Type de IFileStagingProvider et la valeur est une instance de l’implémentation correspondante d’IFileStagingArtifact. Par exemple, si FilesToStage inclut un ou plusieurs objets FileToStage (de la bibliothèque Microsoft.Azure.Batch.FileStaging), le dictionnaire contient une entrée dont la clé est typeof(FileToStage) et dont la valeur est une instance de SequentialFileStagingArtifact.

Une fois l’opération Ajouter une tâche terminée, ou pendant l’opération Ajouter une tâche si l’application est multithread, vous pouvez examiner le dictionnaire et convertir chaque IFileStagingArtifact en type approprié pour récupérer les informations spécifiques au type. Par exemple, si votre opération Ajouter une tâche a spécifié un ou plusieurs objets FileToStage, vous pouvez localiser l’entrée du dictionnaire clé par typeof(FileToStage), caster la valeur en SequentialFileStagingArtifact et examiner la propriété SequentialFileStagingArtifact.BlobContainerCreated pour déterminer si le processus de chargement a créé un conteneur d’objets blob dans stockage Azure et, le cas échéant, le nom de ce conteneur. Cet exemple peut être utile pour nettoyer les conteneurs créés automatiquement.

(Les opérations Ajouter une tâche à tâche unique fonctionnent de la même manière, sauf que dans une opération d’ajout de tâche multitâches, il existe un dictionnaire pour chaque collection de tâches, et les dictionnaires sont collectés dans un ConcurrentBag<T>, alors que dans une opération d’ajout de tâche à tâche unique, il n’existe qu’un seul dictionnaire.)

Dans une opération Ajouter une tâche à tâche unique, vous pouvez également utiliser le dictionnaire pour personnaliser le processus de préproduction de fichiers, en le préremplissant avec les entrées appropriées. Par exemple, supposons que vous souhaitiez contrôler pour NamingFragment un groupe d’objets FileToStage. Vous pouvez ensuite initialiser le dictionnaire avec { typeof(FileToStage), new SequentialFileStagingArtifact { NamingFragment = "myname" } } avant de le passer à AddTaskAsync. L’implémentation FileToStage d’IFileStagingProvider utiliserait alors votre SequentialFileStagingArtifact au lieu de créer son propre. (Cette fonctionnalité n’est pas disponible dans les opérations d’ajout de tâche multitât.)

Vous pouvez également rencontrer IFileStagingArtifact si vous développez un objet personnalisé IFileStagingProvider. Dans ce cas, vous allez généralement créer une implémentation personnalisée d’IFileStagingArtifact pour signaler des informations spécifiques à l’implémentation sur votre processus de préproduction de fichiers.

Propriétés

NamingFragment

Obtient ou définit un fragment de nom qui peut être utilisé lors de la construction de noms par défaut.