全部產品
Search

搜尋本產品

    File Storage NAS：CreateFile

    文件中心

    File Storage NAS：CreateFile

    更新時間：Aug 26, 2026

    建立目錄或檔案。

    介面說明

    • 該介面僅對部分使用者開放。

    • 僅支援通用型 NAS 且已啟用存取控制的 SMB 通訊協定類型檔案系統，並且已開通阿里雲 KMS 服務。

    呼叫前置鏈路

    在呼叫本 API 建立檔案之前，需要完成以下 4 步前置相依性：

    1. 建立 SMB 通訊協定通用型 NAS 檔案系統：呼叫 CreateFileSystem 介面，設定 ProtocolType=SMB，建立支援 SMB 通訊協定的通用型 NAS 檔案系統。

    2. 開通 KMS 服務：透過以下方式之一開通 KMS 服務：

    3. 啟用 SMB ACL：呼叫 EnableSmbAcl 介面啟用 SMB ACL 功能。建議設定：

      • AuthMethod=NTLM

      • AuthCenter=EDS

      • 此設定無需 AD 網域 Keytab，使用更簡便

    4. 呼叫 CreateFile：完成上述前置步驟後，呼叫本 API 建立目錄或檔案。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    nas:CreateFile

    create

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    FileSystemId

    string

    是

    檔案系統 ID。

    1ca404****
    Path

    string

    是

    指定目錄或檔案的絕對路徑。

    • 必須以正斜線 / 開頭和結尾。

    • 長度為 1~1023 個字元之間。

    • 使用 UTF-8 編碼。

    /test/
    Type

    string

    是

    物件類型。取值：

    • File：檔案。

    • Directory：目錄。

    File
    Owner

    string

    否

    可攜式帳號 ID。 限制：長度 16 位字串，支援數字和英文小寫字母。

    378cc7630f26****
    OwnerAccessInheritable

    boolean

    否

    共用目錄檔案。 取值：

    • false（預設值）：不共用目錄權限。

    • true：共用目錄權限。

    說明

    • 當 Type=Directory 並且 Owner 不為空時，該參數生效。

    • 目錄帶有可繼承的 Owner 權限。該目錄下建立的子目錄和子檔案，即使是其他人建立的，這個 Owner 都具有讀寫權限。

    false

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

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

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF518948****"
}

    錯誤碼

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

    變更歷史

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