All Products
Search
Document Center

Apsara File Storage NAS:ListRecentlyRecycledDirectories

Last Updated:Mar 14, 2024

Queries the directories that are recently deleted.

Operation description

Only General-purpose NAS file systems support this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
FileSystemIdstringYes

The ID of the file system.

1ca404****
NextTokenstringNo

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.

If not all directories are returned in a query, the return value of the NextToken parameter is not empty. In this case, you can specify a valid value for the NextToken parameter to continue the query.

1256****25
MaxResultslongNo

The number of directories to return for each query.

Valid values: 10 to 1000.

Default value: 100.

100

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The request ID.

9E15E394-38A6-457A-A62A-D9797C9A****
NextTokenstring

A pagination token.

If not all directories are returned in a query, the return value of the NextToken parameter is not empty. In this case, you can specify a valid value for the NextToken parameter to continue the query.

1256****25
Entriesobject []

The information about the directories that are recently deleted.

FileIdstring

The ID of the directory.

04***08
Pathstring

The absolute path to the directory.

/a/b
Namestring

The name of the directory.

b
LastDeleteTimestring

The time when the directory was last deleted.

2021-05-30T10:08:08Z

Examples

Sample success responses

JSONformat

{
  "RequestId": "9E15E394-38A6-457A-A62A-D9797C9A****",
  "NextToken": "1256****25",
  "Entries": [
    {
      "FileId": "04***08",
      "Path": "/a/b",
      "Name": "b",
      "LastDeleteTime": "2021-05-30T10:08:08Z"
    }
  ]
}

Error codes

HTTP status codeError codeError messageDescription
400IllegalCharactersThe parameter contains illegal characters.The parameter contains illegal characters.
400MissingFileSystemIdFileSystemId is mandatory for this action.-
400InvalidParameter.KMSKeyId.KMSUnauthorizedKMS is not authorized.KMS is not authorized.
400InvalidParameter.KMSKeyId.CMKNotEnabledThe CMK needs to be enabled.The CMK needs to be enabled.
404InvalidFileSystem.NotFoundThe specified file system does not exist.The specified file system does not exist.
404InvalidParameter.InvalidNextTokenThe specified NextToken is invaild.-

For a list of error codes, visit the Service error codes.