DataLakeFileSystemClient.GetPathsAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
An AsyncPageable<T> describing the paths in the file system.
Remarks
A RequestFailedException will be thrown if a failure occurs.