ファイルまたはフォルダを作成します。
操作説明
ファイルの作成メソッドについては、ベストプラクティス「ファイルのアップロード」を参照してください。
ファイルのアップロードプロシージャ中、アップロードされたファイルパートにはストレージ料金が発生します。パートは、ファイルのアップロードが完了するか、10 日後に有効期限切れとなってクリーンアップされるまで、10 日間保持されます。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST /v2/file/create HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| domain_id |
string |
必須 |
||
| body |
object |
任意 |
リクエストボディのパラメーター。 |
|
| name |
string |
必須 |
ファイル名。名前は UTF-8 エンコーディングで最大 1024 バイトまで指定でき、スラッシュ (/) を含めることはできません。 |
a.txt。 |
| type |
string |
必須 |
ファイルタイプ。有効な値:
|
file。 |
| parent_file_id |
string |
必須 |
親フォルダの ID。ルートディレクトリにアップロードするには、このパラメーターを root に設定します。 |
fileid1 |
| drive_id |
string |
任意 |
ドライブの ID。共有リンク経由でアップロードを実行する場合を除き、このパラメーターは必須です。フォームによるアップロードの場合も必須です。 |
1 |
| share_id |
string |
任意 |
共有の ID。共有リンク経由でアップロードする場合、このパラメーターは必須です。 |
7JQX1FswpQ8 |
| size |
integer |
任意 |
ファイルサイズ (バイト単位)。 |
1024 |
| content_type |
string |
任意 |
ファイルのコンテンツタイプ。デフォルト値: application/octet-stream。 |
application/json |
| part_info_list |
array<object> |
任意 |
パート情報のリスト。最大値は 10000 パートです。このパラメーターが指定されていない場合、デフォルトで 1 つのパートが返されます。フォームに従って指定してください。 |
|
|
array<object> |
任意 |
パート情報。フォームに従って指定してください。 |
||
| part_number |
integer |
任意 |
パートのシーケンス番号 (1 から始まります)。 |
1 |
| parallel_sha1_ctx |
object |
任意 |
このパート以前の全データの SHA1 コンテキスト。このフィールドは同時マルチパートアップロードモードでのみ有効です。 |
|
| h |
array |
任意 |
このパートより前のすべてのデータのコンテキスト SHA1 の 1 番目から 5 番目の 32 ビット変数。このフィールドは同時マルチパートアップロードパターンでのみ有効です。 |
|
|
integer |
任意 |
このパートより前のすべてのデータのコンテキスト SHA1 の 1 番目から 5 番目の 32 ビット変数。 |
1 |
|
| part_offset |
integer |
任意 |
直前のデータブロックまでの合計長 (バイト単位)。値は 64 の倍数である必要があります。このフィールドは同時マルチパートアップロードモードでのみ有効です。 |
10240 |
| content_md5 |
string |
任意 |
パートの MD5 値。アップロード中にパートの MD5 を検証する必要がある場合に、このパラメーターを指定します。 |
ASKJDJSKDJJSJDJS。 |
| content_type |
string |
任意 |
クライアントが PUT を使用してパートをアップロードする際に設定する必要がある Content-Type 値。アップロード時にクライアントが指定した Content-Type がこの値と一致しない場合、署名エラーが発生します。デフォルト値: 空。クライアントは PUT 時に Content-Type を指定する必要はありません。 |
application/json |
| user_tags |
array |
任意 |
カスタムユーザータグ。最大値は 1000 タグです。 |
|
| UserTag |
任意 |
カスタムユーザータグ。 |
||
| description |
string |
任意 |
ファイルの説明。説明は最大 1024 文字まで指定できます。デフォルト値: 空。 |
Team file. |
| content_hash |
string |
任意 |
ファイルコンテンツのハッシュ値。値は content_hash_name で指定されたアルゴリズムに基づいて計算されます。 |
7C4A8D09CA3762AF61E59520943DC26494F8941B |
| content_hash_name |
string |
任意 |
ファイルコンテンツのハッシュアルゴリズム名。現在、sha1 のみがサポートされています。 |
sha1 |
| pre_hash |
string |
任意 |
ファイルの最初の 1 KB の SHA1 値。事前秒速アップロード特徴を使用する場合に、このパラメーターを指定します。サーバー上で一致が見つからない場合、クライアントは秒速アップロードのためにファイル全体の SHA1 を計算する必要はありません。 |
7C4A8D09CA3762AF61E59520943DC26494F89411 |
| check_name_mode |
string |
任意 |
重複する名前のファイルを処理するモード。有効な値:
デフォルト値: ignore。 列挙値:
|
ignore。 |
| file_id |
string |
任意 |
ファイルの ID。上書き操作の場合、このパラメーターは必須です。 |
9520943DC264 |
| local_created_at |
string |
任意 |
ファイルのローカル作成時間。デフォルト値: 空。フォーマット: yyyy-MM-ddTHH:mm:ssZ (UTC+0 タイムゾーン)。 |
2023-10-04T14:30:00Z |
| local_modified_at |
string |
任意 |
ファイルのローカル変更時間。デフォルト値: 空。フォーマット: yyyy-MM-ddTHH:mm:ssZ (UTC+0 タイムゾーン)。 |
2023-10-04T14:30:00Z |
| parallel_upload |
boolean |
任意 |
並列パートアップロード特徴を有効にするかどうかを指定します。 |
true。 |
| upload_type |
string |
任意 |
アップロードタイプ。有効な値: multipart および form。デフォルト値: multipart。 |
multipart。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
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": "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": {
"endpoint": "",
"form_data": {
"key": ""
}
},
"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
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。