调用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为Directory时，返回该参数。

包括：

  • 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 40

文件或目录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. 指定的路径不存在。

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