全部文档
当前文档
最近更新时间：2025-10-14 12:45:48
本接口（CreateDir）用于为文件系统新建一个子目录。
POST
请求参数包含公共请求参数和接口请求参数。其中，公共请求参数是每个接口都会用到的请求参数，具体参见公共参数及签名机制；接口请求参数是各个接口所特有的，具体参见下方说明：
请求头
名称 | 是否必须 | 值 |
Content-Type | 是 | application/json |
Accept | 是 | application/json |
请求体
名称 | 类型 | 是否必须 | 描述 |
FileSystemId | string | 否 |
|
StoreClass | string | 否 | 存储类型 取值：KPFS-P-S01（性能Ⅰ型）。 |
ClusterName | string | 否 | 存储池名称， 从控制台>文件系统详情>资源池获取。 |
FileSystemName | string | 否 | 文件系统名称，名称最大长度63字节。 |
DirPath | string | 是 | 目录完整路径，格式 dir/xxx 或 /dir/××× 或 dir/×××/或/dir/×××/。 限制：
补充说明：
|
FileSysOwnerUserId | int | 否 | 文件所属用户的id，不可设置负数。 有效值范围：0- （不校验范围）。 备注：
|
FileSysOwnerGroupId | int | 否 | 文件所属用户的用户组id，不可设置负数。 有效值范围：0- (不校验范围）。 备注：
|
FileSysPosixPermission | int | 否 | 文件读写权限，格式:十位二进制表示法。 备注： 默认为755 (-rwxr-xr-x)，拥有者有读、写、执行权限；而属组用户和其他用户只有读、执行权限。 |
Action | string | 是 | 该参数为公共参数，取值：CreateDir。 |
Version | string | 是 | 该参数为公共参数，取值：2024-09-30。 |
名称 | 类型 | 描述 |
RequestId | string | 唯一请求ID，每次请求都会返回。 |
请求示例
curl --location 'kpfs.api.ksyun.com' \
--header 'X-action: CreateDir' \
--header 'X-version: 2024-09-30' \
--header 'Content-Type: application/json' \
--header 'X-Amz-Content-Sha256: beaead3198f7da1e70d03ab969765e0821b24fc913697e929e726aeaebf0eba3' \
--header 'X-Amz-Date: 20250923T121457Z' \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=AKLTY11BXipTOaxr5MipHNzX/20250923/us-east-1/kpfs/aws4_request, SignedHeaders=content-length;content-type;host;x-action;x-amz-content-sha256;x-amz-date;x-version, Signature=5d4e9145c334d9de438d074501299c416c4d791b944b918a3eb200cd08ca63e4' \
--data '{
"FileSystemId": "9e2ce03cb2e844bca40db0b9d65d4971",
"DirPath":"dir/subdir",
}'返回示例
{
"RequestId": "12df0962-777d-44b9-8d6f-e1a31db8d34b004"
}纯净模式