全部产品
Search

搜索本产品

    文件存储 NAS：CreateDir - 创建目录

    文档中心

    文件存储 NAS：CreateDir - 创建目录

    更新时间：Aug 28, 2026

    在文件系统中创建目录。

    接口说明

    仅通用型 NAS NFS 协议文件系统支持该功能。

    调试

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

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    nas:CreateDir

    create

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    FileSystemId

    string

    是

    文件系统 ID。

    31a8e4****
    RootDirectory

    string

    是

    目录名称。

    • 必须以正斜线（/）开头。

    • 支持数字、大小写字母。

    • 可以包含下划线（_）、短划线（-）或半角句号（.）。

    • 路径中不能包含软链接，如本层目录（.）、上层目录（..）或其他软链接。

    说明

    • 如果根目录不存在，则需要配置目录创建信息，系统将根据设置自动创建指定的根目录。

    • 如果根目录已存在，则不需要配置目录创建信息，如果进行配置，目录创建信息中的配置也会被忽略。

    /test
    OwnerUserId

    integer

    是

    目录的拥有者用户 ID。 支持从 0 至 4294967295 的值。

    1
    OwnerGroupId

    integer

    是

    目录的拥有者用户组 ID。支持从 0 至 4294967295 的值。

    123
    Permission

    string

    是

    指定应用到根目录路径的 POSIX 权限。 格式为合法的八进制数，如 0755。

    0755
    Recursion

    boolean

    否

    是否创建多级目录。 取值：

    • true（默认值）：如果多级目录不存在，逐级创建。

    • false：只创建最后一级目录，父目录不存在返回错误信息。

    true

    返回参数

    名称

    类型

    描述

    示例值

    object

    Schema of Response

    RequestId

    string

    请求 ID。

    BC7C825C-5F65-4B56-BEF6-98C56C7C****

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    403 InvalidProtocolType.NotSupported The specified protocol type does not supported. 指定的协议类型不支持。

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

    变更历史

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