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

调试

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

请求参数

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

系统规定参数。

固定取值:GetDirectoryOrFileProperties

FileSystemId String 31a8e4****

文件系统ID。

Path String /pathway/to/folder

指定目录的绝对路径。

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

返回数据

名称 类型 示例值 描述
Entry Object

目录或文件信息集合。

Type String File

返回结果的类型。

包括:

  • File:文件
  • Directory:目录
HasInfrequentAccessFile Boolean true

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

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

包括:

  • true:包含
  • false:不包含
MTime String 2021-02-11T10:08:08Z

文件修改时间。

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

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

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

查询时间。

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

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

Size Long 1024

文件的大小。

单位:字节

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

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

原数据修改时间。

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

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

StorageType String InfrequentAccess

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

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

包括:

  • Standard:通用型NAS存储。
  • InfrequentAccess:低频介质存储。
Name String file.txt

文件名或目录名。

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

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

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

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

Inode String Inode

文件或目录inode。

RequestId String 2D69A58F-345C-4FDE-88E4-BF518948****

请求ID。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Entry" : {
    "Type" : "File",
    "HasInfrequentAccessFile" : true,
    "MTime" : "2021-02-11T10:08:08Z",
    "ATime" : "2021-02-01T10:08:08Z",
    "Size" : 1024,
    "CTime" : "2021-02-11T10:08:10Z",
    "StorageType" : "InfrequentAccess",
    "Name" : "file.txt",
    "RetrieveTime" : "2021-02-11T10:08:08Z",
    "Inode" : "Inode"
  },
  "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. 指定的路径不存在。

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