ファイルまたはフォルダを作成します。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST /v2/file/create HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| body |
object |
任意 |
リクエストパラメーターです。 |
|
| name |
string |
必須 |
ファイル名です。UTF-8 エンコーディング規則に基づき、最大 1,024 バイトの長さまで指定できます。また、正スラッシュ（/）を含めることはできません。 |
a.txt |
| type |
string |
必須 |
ファイルの種類です。有効な値は以下のとおりです。 file folder |
file |
| parent_file_id |
string |
必須 |
親ディレクトリの ID です。ルートディレクトリにファイルまたはフォルダを作成する場合は、このパラメーターを root に設定します。 |
fileid1 |
| drive_id |
string |
任意 |
ドライブ ID です。ファイルを共有 URL を使用してアップロードしない場合、このパラメーターを指定する必要があります。 |
1 |
| share_id |
string |
任意 |
共有 ID です。ファイルを共有 URL を使用してアップロードする場合、このパラメーターを指定する必要があります。 |
7JQX1FswpQ8 |
| size |
integer |
任意 |
ファイルサイズです。単位：バイト。 |
1024 |
| content_type |
string |
任意 |
ファイルコンテンツの種類です。デフォルト値：application/oct-stream。 |
application/json |
| part_info_list |
array<object> |
任意 |
ファイルのパートに関する情報です。最大 10,000 個のパートを指定できます。デフォルトでは、このパラメーターを指定しない場合、1 つのパートのみが返されます。 |
|
|
array<object> |
任意 |
|||
| part_number |
integer |
任意 |
ファイルパートのシリアル番号です。1 から始まります。 |
1 |
| parallel_sha1_ctx |
object |
任意 |
ファイルパートより前のファイルコンテンツの SHA-1 ハッシュ値です。このパラメーターは、並列アップロード機能が有効な場合にのみ有効です。 |
|
| h |
array |
任意 |
ファイルパートより前のファイルコンテンツの SHA-1 ハッシュ値の最初から 5 番目までの 32 ビット変数です。このパラメーターは、並列アップロード機能が有効な場合にのみ有効です。 |
|
|
integer |
任意 |
ファイルパートより前のファイルコンテンツの SHA-1 ハッシュ値の最初から 5 番目までの 32 ビット変数です。 |
1 |
|
| part_offset |
integer |
任意 |
ファイルパートより前のファイルコンテンツのサイズです。単位：バイト。値は 64 の倍数である必要があります。このパラメーターは、並列アップロード機能が有効な場合にのみ有効です。 |
10240 |
| content_md5 |
string |
任意 |
ファイルパートの MD5 ハッシュ値です。パートアップロード時にファイルパートの MD5 ハッシュ値を検証する必要がある場合、このパラメーターを指定する必要があります。 |
ASKJDJSKDJJSJDJS |
| user_tags |
array |
任意 |
カスタムタグです。最大 1,000 個のタグを指定できます。 |
|
| UserTag |
任意 |
カスタムタグです。 |
||
| description |
string |
任意 |
ファイルの説明です。説明は最大 1,024 文字まで指定できます。デフォルトでは、このパラメーターは空のままです。 |
团队文件 |
| content_hash |
string |
任意 |
ファイルコンテンツのハッシュ値です。この値は、content_hash_name で指定されたアルゴリズムに基づいて計算されます。 |
7C4A8D09CA3762AF61E59520943DC26494F8941B |
| content_hash_name |
string |
任意 |
ファイルコンテンツのハッシュ値を計算するために使用されるアルゴリズムの名称です。SHA1 のみがサポートされています。 |
sha1 |
| pre_hash |
string |
任意 |
ファイルの先頭 1 KB データの SHA-1 ハッシュ値です。事前ハッシュ機能を使用して即時ファイルアップロードを実行する場合、このパラメーターを指定する必要があります。クラウド側で SHA-1 ハッシュ値が一致しない場合、クライアントはファイル全体の SHA-1 ハッシュ値を計算する必要はありません。 |
7C4A8D09CA3762AF61E59520943DC26494F89411 |
| check_name_mode |
string |
任意 |
作成しようとするファイルの名前が、クラウド上の既存のファイルと重複する場合の処理方法です。有効な値は以下のとおりです。 ignore：クラウド上の既存のファイルと同じ名前でファイルを作成することを許可します。 auto_rename：作成しようとするファイルを自動的にリネームします。デフォルトでは、現在時刻がファイル名の末尾に追加されます（例：xxx_20060102_150405）。 refuse：作成しようとするファイルを生成せず、クラウド上に同名のファイルがある場合の情報を返します。 デフォルト値：ignore。 列挙値:
|
ignore |
| file_id |
string |
任意 |
ファイル ID です。check_name_mode が ignore に設定されている場合、このパラメーターを指定する必要があります。 |
9520943DC264 |
| local_created_at |
string |
任意 |
ローカルファイルの作成時刻です。デフォルトでは、このパラメーターは空のままです。UTC+0 タイムゾーンに基づき、yyyy-MM-ddTHH:mm:ssZ 形式で指定してください。 |
2019-08-20T06:51:27.292Z |
| local_modified_at |
string |
任意 |
ローカルファイルの更新時刻です。デフォルトでは、このパラメーターは空のままです。UTC+0 タイムゾーンに基づき、yyyy-MM-ddTHH:mm:ssZ 形式で指定してください。 |
2019-08-20T06:51:27.292Z |
| image_media_metadata | ImageMediaMetadata |
任意 |
クライアントが指定した画像に関する情報です。 |
|
| video_media_metadata | VideoMediaMetadata |
任意 |
クライアントが指定した動画に関する情報です。 |
|
| parallel_upload |
boolean |
任意 |
並列アップロード機能を有効にするかどうかを指定します。 |
true |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
返却されるデータです。 |
||
| parent_file_id |
string |
親ディレクトリの ID です。 |
fileid5 |
| part_info_list |
array |
ファイルのパートに関する情報です。 |
|
| UploadPartInfo |
ファイルのパートに関する情報です。 |
||
| upload_id |
string |
アップロードタスクの ID です。 |
uploadid1 |
| rapid_upload |
boolean |
ファイルが即時アップロードされたかどうかを示します。 |
true |
| type |
string |
ファイルの種類です。 |
file |
| file_id |
string |
ファイル ID です。 |
fileid1 |
| domain_id |
string |
ドメイン ID です。 |
bj1 |
| drive_id |
string |
ドライブ ID です。 |
1 |
| file_name |
string |
ファイル名です。 |
a.txt |
| status |
string |
ファイルの状態です。 |
uploading |
| exist |
boolean |
ファイルが存在するかどうかを示します。 |
false |
例
成功レスポンス
JSONJSON
{
"parent_file_id": "fileid5",
"part_info_list": [
{
"part_number": 1,
"part_size": 1024,
"upload_url": "",
"internal_upload_url": "",
"etag": "0CC175B9C0F1B6A831C399E269772661",
"parallel_sha1_ctx": {
"h": [
0
],
"part_offset": 0
},
"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
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。