Share via


IFileSystemOperations.MsConcatWithHttpMessagesAsync Method

Definition

Concatenates the list of source files into the destination file, deleting all source files upon success. This method accepts more source file paths than the Concat method. This method and the parameters it accepts are subject to change for usability in an upcoming version.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse> MsConcatWithHttpMessagesAsync (string accountName, string msConcatDestinationPath, System.IO.Stream streamContents, bool? deleteSourceDirectory = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse> MsConcatWithHttpMessagesAsync (string accountName, string path, System.IO.Stream streamContents, bool? deleteSourceDirectory = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member MsConcatWithHttpMessagesAsync : string * string * System.IO.Stream * Nullable<bool> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse>
abstract member MsConcatWithHttpMessagesAsync : string * string * System.IO.Stream * Nullable<bool> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse>
Public Function MsConcatWithHttpMessagesAsync (accountName As String, msConcatDestinationPath As String, streamContents As Stream, Optional deleteSourceDirectory As Nullable(Of Boolean) = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse)
Public Function MsConcatWithHttpMessagesAsync (accountName As String, path As String, streamContents As Stream, Optional deleteSourceDirectory As Nullable(Of Boolean) = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse)

Parameters

accountName
String

The Azure Data Lake Store account to execute filesystem operations on.

msConcatDestinationPathpath
String

The Data Lake Store path (starting with '/') of the destination file resulting from the concatenation.

streamContents
Stream

A list of Data Lake Store paths (starting with '/') of the source files. Must be a comma-separated path list in the format: sources=/file/path/1.txt,/file/path/2.txt,/file/path/lastfile.csv

deleteSourceDirectory
Nullable<Boolean>

Indicates that as an optimization instead of deleting each individual source stream, delete the source stream folder if all streams are in the same folder instead. This results in a substantial performance improvement when the only streams in the folder are part of the concatenation operation. WARNING: This includes the deletion of any other files that are not source files. Only set this to true when source files are the only files in the source directory.

customHeaders
Dictionary<String,List<String>>

The headers that will be added to request.

cancellationToken
CancellationToken

The cancellation token.

Returns

Exceptions

Thrown when the operation returned an invalid status code

Thrown when a required parameter is null

Applies to