文档

CreateFile - 创建文件或文件夹

更新时间:

创建文件或文件夹。

接口说明

文件创建使用方法参考最佳实践:文件上传

调试

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

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/file/create HTTP/1.1

请求参数

名称类型必填描述示例值
bodyobject

请求体参数。

namestring

文件名称,按照 utf8 编码最长 1024 字节,不能以 / 结尾

a.txt
typestring

文件类型,可选值如下:

file:文件 folder:文件夹

file
parent_file_idstring

父目录 id,上传到根目录时填写 root

fileid1
drive_idstring

空间 id,除通过分享链接上传之外,必填

1
share_idstring

分享 id,当通过分享链接上传时必填

7JQX1FswpQ8
sizelong

文件大小,单位为 byte。

1024
content_typestring

文件内容类型,默认值 application/oct-stream,常见的 content_type 可以参考 OSS 《如何设置 Content-Type(MIME)?》

application/json
part_info_listarray<object>

分片信息列表,最多 10000 个分片,当不填时,默认返回 1 个分片

object

分片信息

part_numberinteger

分片序列号,从 1 开始

1
parallel_sha1_ctxobject

该分片前所有数据的 SHA1 上下文,该字段只在多分片并发上传的模式下有效

harray

该分片前所有数据的 SHA1 上下文的第 1-5 个 32 位变量,该字段只在多分片并发上传的模式下有效

long

该分片前所有数据的 SHA1 上下文的第 1-5 个 32 位变量

1
part_offsetlong

到上一个数据块为止的总长度,字节,需要为 64 的倍数,该字段只在多分片并发上传的模式下有效

10240
content_md5string

分片的 MD5, 需要在上传分片时校验分片的 MD5 时填写。

ASKJDJSKDJJSJDJS
user_tagsarray

用户自定义 tag,最多 1000 个 tag

UserTag

用户自定义 tag

hiddenboolean

是否隐藏,默认不隐藏

false
descriptionstring

文件描述信息,最长 1024 字符,默认为空

团队文件
content_hashstring

文件内容 hash 值,需要根据 content_hash_name 指定的算法计算

7C4A8D09CA3762AF61E59520943DC26494F8941B
content_hash_namestring

文件内容 hash 算法名,当前只支持 sha1

sha1
pre_hashstring

使用预秒传功能时填写,为文件前 1KB sha1 值,当远端没有匹配上时,客户端无需再计算文件完整 sha1 去尝试秒传。

7C4A8D09CA3762AF61E59520943DC26494F89411
check_name_modestring

同名文件处理模式,可选值如下:

ignore:允许同名文件;

auto_rename:当发现同名文件是,云端自动重命名,默认为追加当前时间点,如 xxx _20060102_150405;

refuse:当云端存在同名文件时,拒绝创建新文件,返回客户端已存在同名文件的详细信息。

默认为 ignore

ignore
file_idstring

文件 id,覆盖写时必填

9520943DC264
local_created_atstring

文件本地创建时间,默认为空,格式为:yyyy-MM-ddTHH:mm:ssZ,采用 UTC +0 时区

2023-10-04T14:30:00Z
local_modified_atstring

文件本地修改时间,默认为空,格式为:yyyy-MM-ddTHH:mm:ssZ,采用 UTC +0 时区

2023-10-04T14:30:00Z
image_media_metadataImageMediaMetadata

客户端指定的图片信息

video_media_metadataVideoMediaMetadata

客户端指定的视频信息

parallel_uploadboolean

是否开启并行上传分片功能

true

返回参数

名称类型描述示例值
object

返回信息

parent_file_idstring

父目录 id

fileid5
part_info_listarray

分段信息列表

UploadPartInfo

分段信息

upload_idstring

上传 id

uploadid1
rapid_uploadboolean

是否已经秒传

true
typestring

文件类型

file
file_idstring

文件 id

fileid1
domain_idstring

域 id

bj1
drive_idstring

空间 id

1
file_namestring

文件名

a.txt
statusstring

文件状态

uploading
existboolean

文件是否存在

false

示例

正常返回示例

JSON格式

{
  "parent_file_id": "fileid5",
  "part_info_list": [
    {
      "part_number": 1,
      "part_size": 1024,
      "upload_url": "https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661",
      "internal_upload_url": "https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\n",
      "etag": "\"0CC175B9C0F1B6A831C399E269772661\"",
      "parallel_sha1_ctx": {
        "h": [
          0
        ],
        "part_offset": 10240
      },
      "upload_form_info": {
        "bucket_name": "",
        "oss_end_point": "",
        "object_key": "",
        "oss_access_key_id": "",
        "oss_security_token": "",
        "policy": "",
        "signature": "",
        "endpoint": "",
        "form_data": {
          "key": ""
        }
      },
      "internal_upload_form_info": {
        "bucket_name": "",
        "oss_end_point": "",
        "object_key": "",
        "oss_access_key_id": "",
        "oss_security_token": "",
        "policy": "",
        "signature": "",
        "endpoint": "",
        "form_data": {
          "key": ""
        }
      },
      "signature_info": {
        "auth_type": "",
        "signature": "",
        "sts_token": ""
      },
      "parallel_sha256_ctx": {
        "h": [
          0
        ],
        "part_offset": 0
      }
    }
  ],
  "upload_id": "uploadid1",
  "rapid_upload": true,
  "type": "file",
  "file_id": "fileid1",
  "domain_id": "bj1",
  "drive_id": "1",
  "file_name": "a.txt",
  "status": "uploading",
  "exist": false
}

错误码

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