CreateFile - Drive and Photo Service

Membuat file atau folder.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /v2/file/create HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
body	object	No	Parameter permintaan.
name	string	Yes	Nama file. Nama dapat memiliki panjang hingga 1.024 byte berdasarkan aturan pengkodean UTF-8 dan tidak boleh mengandung garis miring (/).	a.txt
type	string	Yes	Tipe file. Nilai yang valid: file folder	file
parent_file_id	string	Yes	ID direktori induk. Jika Anda ingin membuat file atau folder di Direktori root, atur parameter ini ke root.	fileid1
drive_id	string	No	ID drive. Parameter ini wajib jika file tidak diunggah menggunakan share URL file tersebut.	1
share_id	string	No	ID share. Parameter ini wajib jika file diunggah menggunakan share URL file tersebut.	7JQX1FswpQ8
size	integer	No	Ukuran file. Satuan: byte.	1024
content_type	string	No	Tipe konten file. Nilai default: application/oct-stream.	application/json
part_info_list	array<object>	No	Informasi mengenai bagian-bagian file. Anda dapat menentukan hingga 10.000 bagian. Secara default, jika Anda tidak menentukan parameter ini, hanya satu bagian yang dikembalikan.
	array<object>	No
part_number	integer	No	Nomor seri bagian file. Penomoran dimulai dari 1.	1
parallel_sha1_ctx	object	No	Nilai hash SHA-1 dari konten file sebelum bagian file tersebut. Parameter ini hanya berlaku jika fitur parallel upload diaktifkan.
h	array	No	Variabel 32-bit pertama hingga kelima dari nilai hash SHA-1 konten file sebelum bagian file tersebut. Parameter ini hanya berlaku jika fitur parallel upload diaktifkan.
	integer	No	Variabel 32-bit pertama hingga kelima dari nilai hash SHA-1 konten file sebelum bagian file tersebut.	1
part_offset	integer	No	Ukuran konten file sebelum bagian file tersebut. Satuan: byte. Nilainya harus merupakan kelipatan 64. Parameter ini hanya berlaku jika fitur parallel upload diaktifkan.	10240
content_md5	string	No	Nilai hash MD5 dari bagian file. Parameter ini wajib ketika nilai hash MD5 bagian file perlu diverifikasi selama pengunggahan bagian.	ASKJDJSKDJJSJDJS
user_tags	array	No	Tag kustom. Anda dapat menentukan hingga 1.000 tag.
	UserTag	No	Tag kustom.
hidden	boolean	No	Menentukan apakah file atau folder disembunyikan. Secara default, file atau folder tidak disembunyikan.	false
description	string	No	Deskripsi file. Deskripsi dapat memiliki panjang hingga 1.024 karakter. Secara default, parameter ini dibiarkan kosong.	团队文件
content_hash	string	No	Nilai hash dari konten file. Nilai ini dihitung berdasarkan algoritma yang ditentukan oleh content_hash_name.	7C4A8D09CA3762AF61E59520943DC26494F8941B
content_hash_name	string	No	Nama algoritma yang digunakan untuk menghitung nilai hash konten file. Hanya SHA1 yang didukung.	sha1
pre_hash	string	No	Nilai hash SHA-1 dari data 1 KB pertama file. Parameter ini wajib jika Anda melakukan unggah instan file menggunakan fitur pre-hashing. Jika nilai hash SHA-1 tidak cocok di cloud, client tidak perlu menghitung nilai hash SHA-1 seluruh file.	7C4A8D09CA3762AF61E59520943DC26494F89411
check_name_mode	string	No	Metode penanganan yang digunakan jika file yang ingin Anda buat memiliki nama yang sama dengan file yang sudah ada di cloud. Nilai yang valid: ignore: memungkinkan Anda membuat file dengan nama yang sama seperti file yang sudah ada di cloud. auto_rename: secara otomatis mengganti nama file yang ingin Anda buat. Secara default, waktu saat ini ditambahkan di akhir nama file. Contoh: xxx_20060102_150405. refuse: tidak membuat file yang ingin Anda buat tetapi mengembalikan informasi tentang file yang memiliki nama yang sama di cloud. Nilai default: ignore. Valid values: refuse : refuse auto_rename : auto_rename ignore : ignore	ignore
file_id	string	No	ID file. Parameter ini wajib jika check_name_mode diatur ke ignore.	9520943DC264
local_created_at	string	No	Waktu pembuatan file lokal. Secara default, parameter ini dibiarkan kosong. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ berdasarkan zona waktu UTC+0.	2019-08-20T06:51:27.292Z
local_modified_at	string	No	Waktu modifikasi file lokal. Secara default, parameter ini dibiarkan kosong. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ berdasarkan zona waktu UTC+0.	2019-08-20T06:51:27.292Z
image_media_metadata	ImageMediaMetadata	No	Informasi mengenai gambar yang ditentukan oleh client.
video_media_metadata	VideoMediaMetadata	No	Informasi mengenai video yang ditentukan oleh client.
parallel_upload	boolean	No	Menentukan apakah fitur parallel upload diaktifkan.	true

Elemen respons

Element	Type	Description	Example
	object	Data yang dikembalikan.
parent_file_id	string	ID direktori induk.	fileid5
part_info_list	array	Informasi mengenai bagian-bagian file.
	UploadPartInfo	Informasi mengenai bagian file.
upload_id	string	ID tugas unggah.	uploadid1
rapid_upload	boolean	Menunjukkan apakah file diunggah secara instan.	true
type	string	Tipe file.	file
file_id	string	ID file.	fileid1
domain_id	string	ID domain.	bj1
drive_id	string	ID drive.	1
file_name	string	Nama file.	a.txt
status	string	Status file.	uploading
exist	boolean	Menunjukkan apakah file tersebut ada.	false

Contoh

Respons sukses

JSONformat

{
  "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
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.