DataLakeFileSystemClient.GetPathsAsync Method

Definition

Namespace:

Azure.Storage.Files.DataLake

Assembly:

Azure.Storage.Files.DataLake.dll

Package:

Azure.Storage.Files.DataLake v12.20.1

Source:

DataLakeFileSystemClient.cs

The GetPathsAsync(String, Boolean, Boolean, CancellationToken) operation returns an async sequence of paths in this file system. Enumerating the paths may make multiple requests to the service while fetching all the values.

For more information, see List Path(s).

public virtual Azure.AsyncPageable<Azure.Storage.Files.DataLake.Models.PathItem> GetPathsAsync (string path = default, bool recursive = false, bool userPrincipalName = false, System.Threading.CancellationToken cancellationToken = default);

abstract member GetPathsAsync : string * bool * bool * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.Storage.Files.DataLake.Models.PathItem>
override this.GetPathsAsync : string * bool * bool * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.Storage.Files.DataLake.Models.PathItem>

Public Overridable Function GetPathsAsync (Optional path As String = Nothing, Optional recursive As Boolean = false, Optional userPrincipalName As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of PathItem)

Parameters

path

String

Filters results to paths within the specified directory.

recursive

Boolean

If "true", all paths are listed; otherwise, only paths at the root of the filesystem are listed.

userPrincipalName

Boolean

Optional. Valid only when Hierarchical Namespace is enabled for the account. If "true", the user identity values returned in the owner and group fields of each list entry will be transformed from Azure Active Directory Object IDs to User Principal Names. If "false", the values will be returned as Azure Active Directory Object IDs. The default value is false. Note that group and application Object IDs are not translated because they do not have unique friendly names.

cancellationToken

CancellationToken

Optional CancellationToken to propagate notifications that the operation should be cancelled.

Returns

AsyncPageable<PathItem>

An AsyncPageable<T> describing the paths in the file system.

Remarks

A RequestFailedException will be thrown if a failure occurs.