Gunakan CreateFileDetectUploadUrl untuk mendapatkan parameter unggahan file deteksi - Security Center - Alibaba Cloud - Security Center

Mendapatkan parameter untuk unggahan file.

Deskripsi operasi

Anda dapat memanggil operasi ini untuk mendapatkan parameter unggahan file. Jika nilai FileExist dalam parameter yang dikembalikan adalah true, file yang akan dideteksi sudah ada di cloud dan tidak perlu diunggah lagi. Anda dapat langsung mendorongnya untuk deteksi. Jika nilai FileExist adalah false, Anda harus menggunakan parameter yang dikembalikan oleh operasi ini untuk mengunggah file ke lokasi penyimpanan yang ditentukan menggunakan form upload.

Layanan form upload disediakan oleh OSS. Untuk informasi lebih lanjut, lihat Form upload.

Parameter HashKey, yang menunjukkan pengenal unik file, disertakan dalam semua operasi terkait deteksi file. Hanya hash MD5 atau SHA-256 dari konten file lengkap yang didukung. Hitung nilai ini sebelum Anda memanggil operasi. Perhatikan bahwa operasi push dan query deteksi file harus menggunakan HashKey yang sama. Jika tidak, hasil deteksi tidak dapat didorong atau dikueri dengan benar.

Untuk menghitung hash MD5 atau SHA-256 dari konten file, lakukan dua langkah berikut:

Gunakan algoritma MD5 atau SHA-256 untuk mengenkripsi data dan menghasilkan nilai hash 128-bit atau 256-bit. Toolkit yang tersedia mencakup alat MessageDigest untuk Java dan pustaka hashlib untuk Python.
Enkode nilai hash yang dihasilkan menjadi string heksadesimal. Toolkit yang tersedia mencakup alat Codec untuk Java dan fungsi hex untuk Python. Pastikan string akhir yang dihasilkan merupakan kombinasi digit dan huruf kecil. Hash MD5 memiliki panjang 32 karakter, dan hash SHA-256 memiliki panjang 64 karakter.

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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

yundun-sas:CreateFileDetectUploadUrl

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
HashKeyList	array	No	Pengenal unik file. Daftar dapat berisi maksimum 100 elemen. Catatan HashKeyList dan HashKeyContextList tidak boleh kosong keduanya.	CreateFileDetectUploadUrl
	string	No	Pengenal unik file.	0a212417e65c26ff133cfff28f6c****
Type	integer	Yes	Tipe file. Nilai valid: 0: tipe file tidak diketahui.	0
HashKeyContextList	array<object>	No	Pengenal file. Hanya MD5 yang didukung. Daftar dapat berisi maksimum 100 elemen. Catatan HashKeyList dan HashKeyContextList tidak boleh kosong keduanya.
	object	No	HASH file.
HashKey	string	No	HASH file.	30319dd5cee8f894766e479cac170da0
FileSize	integer	No	Ukuran file. Jika ukuran file melebihi batas, tidak ada parameter unggahan yang dikembalikan. Unit: bytes.	2698557

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan, yang merupakan pengenal unik yang dihasilkan oleh Alibaba Cloud untuk permintaan dan dapat digunakan untuk memecahkan masalah dan melacak masalah.	09969D2C-4FAD-429E-BFBF-9A60DEF8BF6F
UploadUrlList	array<object>	Kumpulan parameter yang diperlukan untuk unggahan file.
	array<object>	Parameter yang diperlukan untuk unggahan file.
PublicUrl	string	Titik akhir publik dari URL unggahan file.	http://example.com
InternalUrl	string	Titik akhir internal dari URL unggahan file.	http://example.com
Expire	string	Stempel waktu saat parameter unggahan kedaluwarsa. Unit: milliseconds.	1658562101370
Context	object	Informasi tanda tangan unggahan.
AccessId	string	The AccessKey ID that is used to access the OSS bucket.	yourAccessKeyID
Policy	string	The policy that poses limits on file upload. For example, the policy can limit the size of the file.	eyJleHBpcmF0aW9uIjoiMjAyMi0wNy0yM1QxMDo1ODoxMC****
Signature	string	The signature that is used to upload the file.	wDhPgVdnY/bkKFYcYFl+4crl****
OssKey	string	The key of the file that is used after the file is uploaded to the OSS bucket.	1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****
FileExist	boolean	Apakah file ada. Nilai valid: true: File sudah ada dan tidak perlu diunggah. false: File tidak ada dan perlu diunggah.	false
HashKey	string	Pengenal file.	0a212417e65c26ff133cfff28f6c****
Code	string	Kode hasil. Nilai 200 menunjukkan keberhasilan. Nilai lain menunjukkan kegagalan. Pemanggil dapat menentukan penyebab kegagalan berdasarkan bidang ini.	200
Message	string	Detail tentang kode kesalahan.	successful

Contoh

Respons sukses

JSONformat

{
  "RequestId": "09969D2C-4FAD-429E-BFBF-9A60DEF8BF6F",
  "UploadUrlList": [
    {
      "PublicUrl": "http://example.com",
      "InternalUrl": "http://example.com",
      "Expire": "1658562101370",
      "Context": {
        "AccessId": "yourAccessKeyID",
        "Policy": "eyJleHBpcmF0aW9uIjoiMjAyMi0wNy0yM1QxMDo1ODoxMC****",
        "Signature": "wDhPgVdnY/bkKFYcYFl+4crl****",
        "OssKey": "1/2022/06/23/15/41/16559701077444693a0c6-33b2-4cc2-a99f-9f38b8b8****"
      },
      "FileExist": false,
      "HashKey": "0a212417e65c26ff133cfff28f6c****",
      "Code": "200",
      "Message": "successful"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message
400	RequestTooFrequently	Request too frequently, please try again later
400	InvalidApiDetectType	Unsupported Api Detect Type.
500	ServerError	ServerError
500	SystemBusy	System busy, please try again later.
403	NoPermission	caller has no permission

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.