Path - List
List paths and their properties in given filesystem.
GET https://{accountName}.{dnsSuffix}/{filesystem}?recursive={recursive}&resource=filesystem
GET https://{accountName}.{dnsSuffix}/{filesystem}?directory={directory}&recursive={recursive}&continuation={continuation}&maxResults={maxResults}&upn={upn}&resource=filesystem&timeout={timeout}
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
The Azure Storage account name. |
dns
|
path | True |
string |
The DNS suffix for the Azure Data Lake Storage endpoint. |
filesystem
|
path | True |
string |
The filesystem identifier. The value must start and end with a letter or number and must contain only letters, numbers, and the dash (-) character. Consecutive dashes are not permitted. All letters must be lowercase. The value must have between 3 and 63 characters. Regex pattern: |
recursive
|
query | True |
boolean |
If "true", all paths are listed; otherwise, only paths at the root of the filesystem are listed. If "directory" is specified, the list will only include paths that share the same root. |
resource
|
query | True |
The value must be "filesystem" for all filesystem operations. |
|
continuation
|
query |
string |
The number of paths returned with each invocation is limited. If the number of paths to be returned exceeds this limit, a continuation token is returned in the response header x-ms-continuation. When a continuation token is returned in the response, it must be specified in a subsequent invocation of the list operation to continue listing the paths. Note that the continuation token returned in the response header x-ms-continuation must be URL encoded before being used in a subsequent invocation. |
|
directory
|
query |
string |
Filters results to paths within the specified directory. An error occurs if the directory does not exist. |
|
max
|
query |
integer int32 |
An optional value that specifies the maximum number of items to return. If omitted or greater than 5,000, the response will include up to 5,000 items. |
|
timeout
|
query |
integer int32 |
An optional operation timeout value in seconds. The period begins when the request is received by the service. If the timeout value elapses before the operation completes, the operation fails. |
|
upn
|
query |
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. |
Request Header
Name | Required | Type | Description |
---|---|---|---|
x-ms-client-request-id |
string |
A UUID recorded in the analytics logs for troubleshooting and correlation. Regex pattern: |
|
x-ms-date |
string |
Specifies the Coordinated Universal Time (UTC) for the request. This is required when using shared key authorization. |
|
x-ms-version |
string |
Specifies the version of the REST protocol used for processing the request. This is required when using shared key authorization. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Ok Headers
|
|
Other Status Codes |
An error occurred. The possible HTTP status, code, and message strings are listed below:
Headers
|
Definitions
Name | Description |
---|---|
Data |
|
Error |
The service error response object. |
Filesystem |
The value must be "filesystem" for all filesystem operations. |
Path | |
Path |
DataLakeStorageError
Name | Type | Description |
---|---|---|
error |
The service error response object. |
Error
The service error response object.
Name | Type | Description |
---|---|---|
code |
string |
The service error code. |
message |
string |
The service error message. |
FilesystemResourceType
The value must be "filesystem" for all filesystem operations.
Name | Type | Description |
---|---|---|
filesystem |
string |
Path
Name | Type | Default value | Description |
---|---|---|---|
contentLength |
integer |
||
etag |
string |
||
group |
string |
||
isDirectory |
boolean |
False | |
lastModified |
string |
||
name |
string |
||
owner |
string |
||
permissions |
string |
||
x-ms-encryption-context |
string |
If the encryption context property value is set it will return the set value. Valid only when Hierarchical Namespace is enabled for the account. |
|
x-ms-encryption-key-sha256 |
string |
The server will echo the SHA256 of the customer-provided encryption key to validate the key used in the operation. |
|
x-ms-encryption-scope |
string |
If the request used an encryption scope, so the client can ensure the contents of the request are successfully encrypted using the encryption scope. |
|
x-ms-server-encrypted: true/false |
boolean |
The value of this header is set to true if the contents of the request are successfully encrypted using the specified algorithm. |
PathList
Name | Type | Description |
---|---|---|
paths |
Path[] |