全部产品
Search
文档中心

:Perintah untuk operasi pada bagian

更新时间:Jul 02, 2025

Topik ini menjelaskan perintah yang dapat digunakan untuk mengelola bagian.

Penting osscmd tidak tersedia sejak 31 Juli 2019. Alibaba Cloud tidak lagi memperbarui atau memelihara osscmd. Perintah operasi osscmd diintegrasikan ke dalam ossutil.

init

Perintah:

init oss://bucket/object

Menginisialisasi acara unggah untuk menghasilkan ID unggah. Anda dapat menambahkan ID unggah ini ke perintah multiupload untuk melakukan operasi pada bagian.

Contoh:

python osscmd init oss://mybucket/myobject

listpart

Perintah:

listpart oss://bucket/object --upload_id=xxx

Menampilkan daftar bagian yang diunggah menggunakan ID unggah dari objek tertentu. Untuk informasi lebih lanjut tentang konsep terkait, lihat Referensi API OSS. Anda harus menentukan ID unggah.

Contoh:

python osscmd listpart oss://mybucket/myobject --upload_id=
          75835E389EA648C0B93571B6A46023F3

listparts

Perintah:

listparts oss://bucket

Menampilkan daftar objek dan ID unggah dari acara unggah multipart yang belum selesai untuk suatu bucket. Saat Anda ingin menghapus suatu bucket tetapi sistem memberi tahu bahwa bucket tersebut tidak kosong, Anda dapat menjalankan perintah ini untuk memeriksa apakah ada fragmen di dalam bucket.

Contoh:

python osscmd listparts oss://mybucket

getallpartsize

Perintah:

getallpartsize oss://bucket

Menampilkan ukuran total bagian-bagian yang diunggah menggunakan ID unggah yang ada.

Contoh:

python osscmd getallpartsize oss://mybucket

cancel

Perintah:

cancel oss://bucket/object --upload_id=xxx

Menghentikan acara unggah multipart yang menggunakan ID unggah.

Contoh:

python osscmd cancel oss://mybucket/myobject --upload_id=
          D9D278DB6F8845E9AFE797DD235DC576

multiupload(multi_upload,mp)

Perintah:

multiupload(multi_upload,mp) localfile oss://bucket/object --check_md5=false
        --thread_num=10

Menggunakan unggah multipart untuk mengunggah file lokal ke OSS.

Contoh:

  • python osscmd multiupload /tmp/localfile.txt oss://mybucket/object
  • python osscmd multiup_load /tmp/localfile.txt oss://mybucket/object
  • python osscmd mp /tmp/localfile.txt oss://mybucket/object

Perintah:

multiupload(multi_upload,mp) localfile oss://bucket/object --upload_id=xxx --thread_num=10
        --max_part_num=1000 --check_md5=false

Menggunakan unggah multipart untuk mengunggah file lokal ke OSS. Jumlah bagian dari file lokal ditentukan oleh parameter max_part_num. Saat perintah ini dijalankan, sistem pertama-tama memeriksa apakah nilai MD5 dari ETags bagian yang menggunakan ID unggah sama dengan nilai MD5 dari file lokal. Jika nilainya sama, bagian-bagian tersebut akan diunggah. Hasilkan ID unggah sebelum acara unggah ini dimulai. Tambahkan ID unggah ke perintah. Jika pengunggahan gagal, Anda dapat menjalankan perintah multiupload yang sama untuk mengunggah bagian-bagian dengan cara yang sama seperti saat menggunakan unggah berkelanjutan. --check_md5=false menunjukkan bahwa Content-MD5 tidak disertakan dalam header permintaan dan verifikasi MD5 tidak akan dilakukan. --check_md5=true menunjukkan bahwa verifikasi MD5 akan dilakukan.

Contoh:

  • python osscmd multiupload /tmp/localfile.txt oss://mybucket/object --upload_id=
              D9D278DB6F8845E9AFE797DD235DC576
  • python osscmd multiup_load /tmp/localfile.txt oss://mybucket/object
            --thread_num=5
  • python osscmd mp /tmp/localfile.txt oss://mybucket/object --max_part_num=100

copylargefile

Perintah:

copylargefile oss://source_bucket/source_object oss://target_bucket/target_object
        --part_size=10*1024*1024 --upload_id=xxx

Untuk mereplikasi objek yang lebih besar dari 1 GB, gunakan multipart untuk mereplikasi objek ke bucket tujuan. Pastikan bahwa bucket sumber dan bucket tujuan berada di wilayah yang sama. Parameter upload_id bersifat opsional. Jika Anda perlu melanjutkan transmisi acara salinan multipart, Anda dapat mengimpor parameter upload_id untuk acara salinan multipart tersebut. Parameter part_size digunakan untuk menentukan ukuran setiap bagian. Ukuran satu bagian harus minimal 100 KB. Maksimum 10.000 bagian didukung untuk acara salinan multipart. Jika nilai part_size lebih kecil dari 100 KB, program secara otomatis menyesuaikan ukuran bagian.

Contoh:

python osscmd copylargefile oss://source_bucket/source_object
          oss://target_bucket/target_object --part_size=10*1024*1024

uploadpartfromfile (upff)

Perintah:

uploadpartfromfile (upff) localfile oss://bucket/object --upload_id=xxx
        --part_number=xxx

Perintah ini hanya digunakan untuk pengujian.

uploadpartfromstring(upfs)

Perintah:

uploadpartfromstring(upfs) oss://bucket/object --upload_id=xxx --part_number=xxx
        --data=xxx

Perintah ini hanya digunakan untuk pengujian.