全部产品
Search

搜索本产品

    文件存储 NAS：CreateFile - 创建目录或者文件

    文档中心

    文件存储 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

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    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****"
}

    错误码

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

    变更历史

    更多信息，参考变更详情。