IFileStagingArtifact Interfaz

Definición

Espacio de nombres:

Microsoft.Azure.Batch

Ensamblado:

Microsoft.Azure.Batch.dll

Paquete:

Microsoft.Azure.Batch v16.2.0

Source:

IFileStagingArtifact.cs

Contiene información sobre un proceso de almacenamiento provisional de archivos. Normalmente, el almacenamiento provisional de archivos se realiza para ( CloudTask consulte FilesToStage).

public interface IFileStagingArtifact

type IFileStagingArtifact = interface

Public Interface IFileStagingArtifact

Derivado

Microsoft.Azure.Batch.FileStaging.SequentialFileStagingArtifact

Comentarios

IFileStagingArtifact permite a una aplicación personalizar y obtener información sobre el proceso de carga de archivos en la nube, por ejemplo, como parte de una operación relacionada con tareas como JobOperations.AddTaskAsync o CloudJob.AddTaskAsync. Las aplicaciones pueden usar esta información para, por ejemplo, averiguar los contenedores que se crearon en Azure Storage como parte del proceso de carga.

Cuando se llama a JobOperations.AddTaskAsync , el cliente de Batch envía las tareas al servicio Batch en colecciones. A medida que se procesa cada colección, el cliente de Batch realiza el almacenamiento provisional de archivos para esa colección: examina las tareas para ver si alguna de ellas especifica alguna FilesToStagey, si es así, crea una entrada de diccionario para cada tipo de IFileStagingProvider en la colección FilesToStage. La clave de la entrada del diccionario es de Type IFileStagingProvider y el valor es una instancia de la implementación correspondiente de IFileStagingArtifact. Por ejemplo, si FilesToStage incluye uno o varios objetos FileToStage (de la biblioteca Microsoft.Azure.Batch.FileStaging), el diccionario contiene una entrada cuya clave es typeof(FileToStage) y cuyo valor es una instancia de SequentialFileStagingArtifact.

Cuando se complete la operación Agregar tarea, o durante la operación Agregar tarea si la aplicación está multiproceso, puede examinar el diccionario y convertir cada IFileStagingArtifact al tipo adecuado para recuperar la información específica del tipo. Por ejemplo, si la operación Agregar tarea especificó uno o varios objetos FileToStage, puede buscar la entrada del diccionario con clave typeof(FileToStage), convertir el valor en SequentialFileStagingArtifact y examinar la propiedad SequentialFileStagingArtifact.BlobContainerCreated para determinar si el proceso de carga creó un contenedor de blobs en Azure Storage y, si es así, el nombre de ese contenedor. Este ejemplo podría ser útil para limpiar los contenedores creados automáticamente.

(Las operaciones Agregar tarea única funcionan de forma similar, salvo que en una operación Agregar tarea de varias tareas, hay un diccionario para cada colección de tareas y los diccionarios se recopilan en un ConcurrentBag<T>, mientras que en una operación Agregar tarea de tarea única solo hay un solo diccionario).

En una operación Agregar tarea de una sola tarea, también puede usar el diccionario para personalizar el proceso de almacenamiento provisional de archivos, rellenando previamente con las entradas adecuadas. Por ejemplo, supongamos que desea controlar para NamingFragment un grupo de objetos FileToStage. Después, podría inicializar el diccionario con { typeof(FileToStage), new SequentialFileStagingArtifact { NamingFragment = "myname" } } antes de pasarlo a AddTaskAsync. A continuación, la implementación fileToStage de IFileStagingProvider usaría el elemento SequentialFileStagingArtifact en lugar de crear su propio. (Esta característica no está disponible en las operaciones Agregar tarea de varias tareas).

También puede encontrar IFileStagingArtifact si está desarrollando un personalizado IFileStagingProvider. En este caso, normalmente creará una implementación personalizada de IFileStagingArtifact para notificar información específica de la implementación sobre el proceso de almacenamiento provisional de archivos.

Propiedades

NamingFragment

Obtiene o establece un fragmento de nombre que se puede usar al construir nombres predeterminados.