全部產品
Search

搜尋本產品

    File Storage NAS：GetDirectoryOrFileProperties - 查詢低頻/歸檔的檔案資訊

    文件中心

    File Storage NAS：GetDirectoryOrFileProperties - 查詢低頻/歸檔的檔案資訊

    更新時間：Apr 04, 2026

    查詢指定目錄下是否包含低頻儲存和Archive Storage檔案，或者查詢指定檔案是否為低頻儲存或Archive Storage檔案。

    介面說明

    僅通用型 NAS 檔案系統支援該功能。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    nas:GetDirectoryOrFileProperties

    get

    *FileSystem

    acs:nas:{#regionId}:{#accountId}:filesystem/{#FileSystemId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    FileSystemId

    string

    是

    檔案系統 ID。

    31a8e4****
    Path

    string

    是

    指定目錄的絕對路徑。

    必須以正斜線（/）開頭，並且是掛載點中真實存在的路徑。

    /pathway/to/folder

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Entry

    object

    目錄或檔案資訊集合。

    Type

    string

    返回結果的類型。

    包括：

    • File：檔案

    • Directory：目錄

    File
    HasInfrequentAccessFile

    boolean

    是否包含低頻隱藏檔。

    僅當 Type 為 Directory 時，返回該參數。

    包括：

    • true：包含

    • false：不包含

    true
    MTime

    string

    檔案修改時間。

    執行 ISO8601 標準表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。

    僅當 Type 為 File 時，返回該參數。

    2021-02-11T10:08:08Z
    ATime

    string

    查詢時間。

    執行 ISO8601 標準表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。

    僅當 Type 為 File 時，返回該參數。

    2021-02-01T10:08:08Z
    Size

    integer

    檔案的大小。

    單位：位元組

    僅當 Type 為 File 時，返回該參數。

    1024
    CTime

    string

    中繼資料修改時間。

    執行 ISO8601 標準表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。

    僅當 Type 為 File 時，返回該值參數。

    2021-02-11T10:08:10Z
    StorageType

    string

    返迴文件的資料存放區類型。

    僅當 Type 為 File 時，返回該參數。

    包括：

    • Standard：通用型 NAS 儲存。

    • InfrequentAccess：低頻儲存。

    InfrequentAccess
    Name

    string

    檔案名稱或目錄名。

    file.txt
    RetrieveTime

    string

    距現在最近一次資料取回任務執行的時間。

    執行 ISO8601 標準表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。

    僅當 Type 為 File 時，返回該參數。

    2021-02-11T10:08:08Z
    Inode

    string

    檔案或目錄 inode。

    40
    HasArchiveFile

    boolean

    是否包含Archive Storage檔案。

    僅當 Type 為 Directory 時，返回該參數。

    包括：

    • true：包含

    • false：不包含

    false
    OfflineDuration

    integer

    OfflineUnchangedDuration

    integer

    RequestId

    string

    請求 ID。

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

    樣本

    正常返回樣本

    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": "40",
    "HasArchiveFile": false,
    "OfflineDuration": 0,
    "OfflineUnchangedDuration": 0
  },
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的檔案系統不存在。
    404 InvalidParameter.PathNotExist The specified path does not exist. 指定的路徑不存在。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。