调用ListDirectoriesAndFiles接口列出通用型NAS指定目录下的子目录或文件。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListDirectoriesAndFiles |
接口名称。 固定取值:ListDirectoriesAndFiles |
FileSystemId | String | 是 | 31a8e4**** |
文件系统ID。 |
Path | String | 是 | /pathway/to/folder |
指定目录的绝对路径。 必须以正斜线(/)开头,并且是挂载点中真实存在的路径。 |
NextToken | String | 否 | TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0= |
当请求的返回结果被截断时,您可以使用NextToken再次发起请求,获取从当前截断位置之后的内容。 |
StorageType | String | 是 | InfrequentAccess |
文件存储类型。 取值(默认值):InfrequentAccess(低频介质存储) |
DirectoryOnly | Boolean | 否 | false |
是否只查询目录。 取值:
|
MaxResults | Long | 否 | 100 |
每次查询结果中包含的目录或文件的个数。 取值范围:10~128 默认值:100 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0= |
当请求的返回结果被截断时,您可以使用NextToken再次发起请求,获取从当前截断位置之后的内容。 |
RequestId | String | 2D69A58F-345C-4FDE-88E4-BF518948**** |
请求ID。 |
Entries | Array of Entry |
目录或文件信息集合。 |
|
Type | String | File |
返回结果的类型。 包括:
|
HasInfrequentAccessFile | Boolean | true |
是否包含低频介质存储文件。 仅当Type为File时,返回该值且有意义。 包括:
|
Ctime | String | 2021-02-11T10:08:10Z |
原数据修改时间。 执行ISO8601标准表示,返回格式: 仅当Type为File时,返回该值且有意义。 |
Mtime | String | 2021-02-11T10:08:08Z |
文件修改时间。 执行ISO8601标准表示,返回格式: 仅当Type为File时,返回该值且有意义。 |
Size | Long | 1024 |
文件的大小。 单位:Byte(字节) 仅当Type为File时,返回该值且有意义。 |
StorageType | String | InfrequentAccess |
返回文件的数据存储类型。 仅当Type为File时,返回该值且有意义。 包括:
|
Atime | String | 2021-02-01T10:08:08Z |
查询时间。 执行ISO8601标准表示,返回格式: 仅当Type为File时,返回该值且有意义。 |
Name | String | file.txt |
文件名或目录名。 |
RetrieveTime | String | 2021-02-11T10:08:08Z |
距现在最近一次数据取回任务执行的时间。 执行ISO8601标准表示,返回格式: 仅当Type为File时,返回该值且有意义。 |
Inode | String | Inode |
文件或目录inode。 |
FileId | String | 04***08 |
目录或文件的FileId。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListDirectoriesAndFiles
&FileSystemId=31a8e4****
&Path=/pathway/to/folder
&StorageType=InfrequentAccess
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<NextToken>aBcdeg==</NextToken>
<RequestId>BC7C825C-5F65-4B56-BEF6-98C56C7C****</RequestId>
<Entries>
<Name>test.txt</Name>
<Type>File</Type>
<Inode>1000</Inode>
<Size>20</Size>
<Atime>2019-10-30T10:08:08Z</Atime>
<Mtime>2019-10-30T10:08:08Z</Mtime>
<CTime>2019-10-30T10:08:08Z</CTime>
<RetrieveTime>2019-10-30T10:08:08Z</RetrieveTime>
<StorageType>InfrequentAccess</StorageType>
</Entries>
<Entries>
<Name>testDirectory</Name>
<Type>Directory</Type>
<Inode>1001</Inode>
<HasInfrequentAccessFile>true</HasInfrequentAccessFile>
</Entries>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NextToken" : "aBcdeg==",
"RequestId" : "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
"Entries" : [ {
"Name" : "test.txt",
"Type" : "File",
"Inode" : 1000,
"Size" : 20,
"Atime" : "2019-10-30T10:08:08Z",
"Mtime" : "2019-10-30T10:08:08Z",
"CTime" : "2019-10-30T10:08:08Z",
"RetrieveTime" : "2019-10-30T10:08:08Z",
"StorageType" : "InfrequentAccess"
}, {
"Name" : "testDirectory",
"Type" : "Directory",
"Inode" : 1001,
"HasInfrequentAccessFile" : true
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | OperationDenied.InvalidNextToken | The specified NextToken is invalid. | 指定的NextToken参数非法。 |
404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定的文件系统不存在。 |
404 | InvalidParameter.PathNotExist | The specified path does not exist. | 指定的路径不存在。 |
访问错误中心查看更多错误码。