调用GetDirectoryOrFileProperties接口查询指定目录下存储的低频介质的文件信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetDirectoryOrFileProperties

系统规定参数。

固定取值:GetDirectoryOrFileProperties

FileSystemId String 31a8e4****

文件系统ID。

Path String /pathway/to/folder

指定目录的绝对路径。

必须以正斜线(/)开头,并且是挂载点中真实存在的路径。

返回数据

名称 类型 示例值 描述
Entry Struct

目录或文件信息集合。

ATime String 2021-02-01T10:08:08Z

查询时间。

执行ISO8601标准表示,返回格式:yyyy-MM-ddTHH:mm:ssZ。

仅当Type为File时,返回该参数。

CTime String 2021-02-11T10:08:10Z

原数据修改时间。

执行ISO8601标准表示,返回格式:yyyy-MM-ddTHH:mm:ssZ。

仅当Type为File时,返回该值参数。

HasInfrequentAccessFile Boolean true

是否包含低频介质存储文件。

仅当Type为File时,返回该参数。

包括:

  • ture:包含
  • false:不包含
Inode String Inode

文件或目录inode。

MTime String 2021-02-11T10:08:08Z

文件修改时间。

执行ISO8601标准表示,返回格式:yyyy-MM-ddTHH:mm:ssZ。

仅当Type为File时,返回该参数。

Name String file.txt

文件名或目录名。

RetrieveTime String 2021-02-11T10:08:08Z

距现在最近一次数据取回任务执行的时间。

执行ISO8601标准表示,返回格式:yyyy-MM-ddTHH:mm:ssZ。

仅当Type为File时,返回该参数。

Size Long 1024

文件的大小。

单位:字节

仅当Type为File时,返回该参数。

StorageType String InfrequentAccess

返回文件的数据存储类型。

仅当Type为File时,返回该参数。

包括:

  • Standard:通用型NAS存储。
  • InfrequentAccess:低频介质存储。
Type String File

返回结果的类型。

包括:

  • File:文件
  • Directory:目录
RequestId String 2D69A58F-345C-4FDE-88E4-BF518948****

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GetDirectoryOrFileProperties
&FileSystemId=31a8e4****
&Path=/pathway/to/folder
&<公共请求参数>

正常返回示例

XML格式

<Entry>
    <Type>File</Type>
    <StorageType>InfrequentAccess</StorageType>
    <Inode>Inode</Inode>
    <ATime>2021-02-01T10:08:08Z</ATime>
    <HasInfrequentAccessFile>true</HasInfrequentAccessFile>
    <Size>1024</Size>
    <CTime>2021-02-11T10:08:10Z</CTime>
    <FileId>5F65-4****BEF6</FileId>
    <RetrieveTime>2021-02-11T10:08:08Z</RetrieveTime>
    <MTime>2021-02-11T10:08:08Z</MTime>
    <Name>file.txt</Name>
</Entry>
<RequestId>2D69A58F-345C-4FDE-88E4-BF518948****</RequestId>

JSON格式

{
    "Entry": {
        "Type": "File",
        "StorageType": "InfrequentAccess",
        "Inode": "Inode",
        "ATime": "2021-02-01T10:08:08Z",
        "HasInfrequentAccessFile": true,
        "Size": 1024,
        "CTime": "2021-02-11T10:08:10Z",
        "FileId": "5F65-4****BEF6",
        "RetrieveTime": "2021-02-11T10:08:08Z",
        "MTime": "2021-02-11T10:08:08Z",
        "Name": "file.txt"
    },
    "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的文件系统不存在。
404 InvalidParameter.PathNotExist The specified path does not exist. 指定的路径不存在。

访问错误中心查看更多错误码。