All Products
Search
Document Center

:Perintah untuk operasi pada objek

Last Updated:Jun 26, 2025

Topik ini menjelaskan perintah yang digunakan untuk mengelola objek.

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

ls(list)

Perintah:

ls(list) oss://bucket/[prefix] [marker] [delimiter] [maxkeys]

Menampilkan daftar objek dalam sebuah bucket. Anda dapat menentukan awalan untuk mencantumkan semua objek dengan nama yang dimulai dengan awalan tertentu. Sebagai contoh, Anda dapat menentukan "abc" sebagai awalan untuk mencantumkan semua objek yang namanya dimulai dengan "abc".

Contoh:

  • python osscmd ls oss://mybucket/folder1/folder2
  • python osscmd ls oss://mybucket/folder1/folder2 marker1
  • python osscmd ls oss://mybucket/folder1/folder2 marker1 /
  • python osscmd ls oss://mybucket/
  • python osscmd list oss://mybucket/ "" "" 100

Perintah:

ls(list) oss://bucket/[prefix] --marker=xxx --delimiter=xxx --maxkeys=xxx
        --encoding_type=url

Menampilkan daftar objek dalam sebuah bucket. Anda dapat mengatur encoding_type untuk menentukan metode pengkodean yang digunakan selama transmisi. Jika Anda mengatur encoding_type ke url, objek yang namanya berisi karakter kontrol akan dikodekan.

Contoh:

  • python osscmd ls oss://mybucket/folder1/folder2 --delimiter=/
  • python osscmd ls oss://mybucket/folder1/folder2 --marker=a
  • python osscmd ls oss://mybucket/folder1/folder2 --maxkeys=10

mkdir

Perintah:

mkdir oss://bucket/dirname

Membuat folder.

Contoh:

python osscmd mkdir oss://mybucket/folder

listallobject

Perintah:

listallobject oss://bucket/[prefix]

Menampilkan daftar semua objek dalam sebuah bucket. Anda dapat menentukan awalan untuk mencantumkan objek yang namanya dimulai dengan awalan tersebut.

Contoh:

  • python osscmd listallobject oss://mybucket
  • python osscmd listallobject oss://mybucket/testfolder/

deleteallobject

Perintah:

deleteallobject oss://bucket/[prefix]

Menghapus semua objek dalam sebuah bucket. Anda juga dapat menentukan awalan untuk menghapus objek yang namanya dimulai dengan awalan tersebut.

Contoh:

  • python osscmd deleteallobject oss://mybucket
  • python osscmd deleteallobject oss://mybucket/testfolder/

downloadallobject

Perintah:

downloadallobject oss://bucket/[prefix] direktorilokal --replace=false
      --thread_num=5

Mengunduh objek dari bucket ke direktori lokal. Operasi ini memastikan bahwa struktur direktori asli tetap dipertahankan. Anda dapat menentukan awalan untuk mengunduh objek yang namanya dimulai dengan awalan tertentu. --replace=false menunjukkan bahwa file lokal dengan nama yang sama dengan objek tidak akan ditimpa selama pengunduhan. --replace=true menunjukkan bahwa file lokal dengan nama yang sama dengan objek akan ditimpa. Anda juga dapat menggunakan thread_num untuk mengonfigurasi jumlah thread unduhan.

Contoh:

  • python osscmd downloadallobject oss://mybucket /tmp/folder
  • python osscmd downloadallobject oss://mybucket /tmp/folder
            –-replace=false
  • python osscmd downloadallobject oss://mybucket /tmp/folder –-replace=true
              --thread_num=5

downloadtodir

Perintah:

downloadtodir oss://bucket/[prefix] direktorilokal --replace=false

Mengunduh objek dari bucket ke direktori lokal. Operasi ini memastikan bahwa struktur direktori asli tetap dipertahankan. Anda dapat menentukan awalan untuk mengunduh objek yang namanya dimulai dengan awalan tertentu. --replace=false menunjukkan bahwa file lokal dengan nama yang sama dengan objek tidak akan ditimpa selama pengunduhan. --replace=true menunjukkan bahwa file lokal dengan nama yang sama dengan objek akan ditimpa. downloadtodir mengikuti logika yang sama dengan downloadallobject.

Contoh:

  • python osscmd downloadtodir oss://mybucket /tmp/folder
  • python osscmd downloadtodir oss://mybucket /tmp/folder –-replace=false
  • python osscmd downloadtodir oss://mybucket /tmp/folder
          –-replace=true

uploadfromdir

Perintah:

uploadfromdir direktorilokal oss://bucket/[prefix] --check_point=check_point_file --replace=false
        --check_md5=false --thread_num=5

Mengunggah file lokal ke bucket.

Jika direktori lokal /tmp/ berisi a/b, a/c, dan a, jalur file-file ini di OSS adalah oss://bucket/a/b, oss://bucket/a/c, dan oss://bucket/a. Jika awalan diatur ke mytest, jalur file-file ini di OSS adalah oss://bucket/mytest/a/b, oss://bucket/mytest/a/c, dan oss://bucket/mytest/a.

--check_point=check_point_file digunakan untuk menentukan file titik pemeriksaan. Setelah file titik pemeriksaan ditentukan, alat osscmd akan menyimpan cap waktu yang direkam saat file lokal diunggah. Perintah uploadfromdir digunakan untuk membandingkan cap waktu file yang sedang diunggah dengan cap waktu yang direkam dalam file titik pemeriksaan. Jika cap waktu berbeda, file akan diunggah ulang. check_point_file tidak ditentukan secara default. --replace=false menunjukkan bahwa file lokal dengan nama yang sama dengan objek tidak akan ditimpa selama pengunggahan. --replace=true menunjukkan bahwa file lokal dengan nama yang sama dengan objek akan ditimpa. --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.

Catatan: File titik pemeriksaan menyimpan catatan unggah semua objek.

Contoh:

  • python osscmd uploadfromdir /mytemp/folder oss://mybucket
  • python osscmd uploadfromdir /mytemp/folder oss://mybucket
              --check_point_file=/tmp/mytemp_record.txt
  • python osscmd uploadfromdir C:\Documents and Settings\User\My Documents\Downloads
              oss://mybucket --check_point_file=C:\cp.txt

put

Perintah:

put filelokal oss://bucket/object --content-type=[content_type]
        --headers="key1:value1#key2:value2" --check_md5=false

Saat mengunggah file lokal ke bucket, Anda dapat mengatur bidang header HTTP seperti content-type. --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 put myfile.txt oss://mybucket
  • python osscmd put myfile.txt oss://mybucket/myobject.txt
  • python osscmd put myfile.txt oss://mybucket/test.txt --content-type=plain/text
              --headers=“x-oss-meta-des:test#x-oss-meta-location:CN”
  • python osscmd put myfile.txt oss://mybucket/test.txt
            --content-type=plain/text

upload

Perintah:

upload filelokal oss://bucket/object --content-type=[content_type]
      --check_md5=false

Mengunggah file lokal ke bucket. --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 upload myfile.txt oss://mybucket/test.txt
        --content-type=plain/text

get

Perintah:

get oss://bucket/object filelokal

Mengunduh objek ke file lokal.

Contoh:

python osscmd get oss://mybucket/myobject /tmp/filelokal

multiget(multi_get)

Perintah:

multiget(multi_get) oss://bucket/object filelokal --thread_num=5

Menggunakan multithreading untuk mengunduh objek ke file lokal. Anda dapat mengonfigurasi jumlah thread yang digunakan untuk mengunduh objek.

Contoh:

  • python osscmd multiget oss://mybucket/myobject /tmp/filelokal
  • python osscmd multi_get oss://mybucket/myobject /tmp/filelokal

cat

Perintah:

cat oss://bucket/object

Membaca dan menampilkan isi objek. Hindari menjalankan perintah ini jika objeknya besar.

Contoh:

python osscmd cat oss://mybucket/myobject

meta

Perintah:

meta oss://bucket/object

Membaca dan menampilkan informasi meta dari objek. Informasi meta mencakup content-type, panjang file, dan metadata pengguna.

Contoh:

python osscmd meta oss://mybucket/myobject

copy

Perintah:

copy oss://bucket_sumber/objek_sumber oss://bucket_tujuan/objek_tujuan
        --headers="key1:value1#key2:value2"

Mereplikasi objek dari bucket sumber ke bucket tujuan.

Contoh:

python osscmd copy oss://bucket1/object1 oss://bucket2/object2

rm(delete,del)

Perintah:

rm(delete,del) oss://bucket/object --encoding_type=url

Menghapus objek. Saat encoding-type diatur ke url, karakter kontrol yang akan dihapus juga perlu dikodekan URL.

Contoh:

  • python osscmd rm oss://mybucket/myobject
  • python osscmd delete oss://mybucket/myobject
  • python osscmd del oss://mybucket/myobject
  • python osscmd del oss://mybucket/my%01object --encoding_type=url

signurl(sign)

Perintah:

signurl(sign) oss://bucket/object --timeout=[timeout_seconds]

Menghasilkan URL yang ditandatangani yang berisi nilai timeout. URL yang ditandatangani digunakan untuk memberikan akses ke objek tertentu ketika ACL bucket bersifat pribadi.

Contoh:

  • python osscmd sign oss://mybucket/myobject
  • python osscmd signurl oss://mybucket/myobject