Queries the infrequently-accessed files in a specified directory of a General-purpose NAS file system and the subdirectories that contain the files.
Operation description
Only General-purpose NAS file systems support this operation.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
FileSystemId | string | Yes | The ID of the file system. | 31a8e4**** |
Path | string | Yes | The absolute path of the directory. The path must start with a forward slash (/) and must be a path that exists in the mount target. | /pathway/to/folder |
NextToken | string | No | The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the first request. You must specify the token that is obtained from the previous query as the value of NextToken. | TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0= |
StorageType | string | Yes | The storage type of the files. Default value: InfrequentAccess (IA). | InfrequentAccess |
DirectoryOnly | boolean | No | Specifies whether to query only directories. Valid values:
| false |
MaxResults | long | No | The maximum number of directories or files to include in the results of each query. Valid values: 10 to 128. Default value: 100. | 100 |
Response parameters
Examples
Sample success responses
JSON
format
{
"NextToken": "TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=",
"RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****",
"Entries": [
{
"Type": "Directory",
"HasInfrequentAccessFile": true,
"Ctime": "2021-02-11T10:08:10Z",
"Mtime": "2021-02-11T10:08:08Z",
"Size": 1024,
"StorageType": "InfrequentAccess",
"Atime": "2021-02-01T10:08:08Z",
"Name": "file.txt",
"RetrieveTime": "2021-02-11T10:08:08Z",
"Inode": "66",
"FileId": "66",
"Owner": "37862c****"
}
]
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | OperationDenied.InvalidNextToken | The specified NextToken is invalid. | The specified NextToken is invalid. |
404 | InvalidFileSystem.NotFound | The specified file system does not exist. | The specified file system does not exist. |
404 | InvalidParameter.PathNotExist | The specified path does not exist. | The specified path does not exist. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
2022-07-15 | The Error code has changed. The response structure of the API has changed | see changesets | ||||||||
|