Cara cepat mencari dan menemukan objek dengan menentukan awalan - Object Storage Service

Saat bucket berisi banyak objek, gunakan pencarian berbasis awalan (prefix search) untuk menemukan objek dan direktori secara cepat tanpa perlu menjelajahi seluruh bucket.

Cara kerja pencarian berbasis awalan

Awalan (prefix) adalah string yang sesuai dengan bagian awal nama objek. Saat Anda memasukkan suatu awalan, OSS akan mengembalikan semua objek dan direktori pada level direktori saat ini yang namanya diawali dengan string tersebut—mirip dengan menyaring file berdasarkan nama dalam sebuah folder.

Dua batasan berlaku:

Case-sensitive: Awalan Example cocok dengan ExampleFile.jpg, tetapi tidak dengan exampleFile.jpg.
Hanya level saat ini: Hanya objek dan direktori yang berada langsung di dalam direktori yang dicari yang dikembalikan. Konten di dalam subdirektori tidak disertakan.

Pencarian datar vs. daftar rekursif

Pencarian berbasis awalan hanya mencakup level direktori saat ini. Jika Anda perlu mendaftar semua objek di seluruh level subdirektori, gunakan salah satu pendekatan berikut sebagai gantinya:

Pendekatan	Metode
API	Operasi GetBucket (ListObjects)
CLI	PH1 command of ossutil

Batasan

Batasan	Detail
Jenis kecocokan	Hanya awalan — mencocokkan bagian awal nama objek
Sensitivitas huruf besar/kecil	Case-sensitive
Karakter awalan	Tidak boleh mengandung garis miring (/)
Cakupan pencarian	Hanya level direktori saat ini (non-rekursif)

Cari objek di konsol OSS

Masuk ke konsol OSS.
Di panel navigasi sebelah kiri, klik Buckets. Di halaman Buckets, temukan dan klik bucket target.
Di pohon navigasi sebelah kiri, pilih Object Management > Objects.
Cari objek: OSS mengembalikan semua objek dan direktori pada level saat ini yang namanya diawali dengan awalan yang ditentukan.
- Di direktori root: Masukkan awalan di kotak pencarian lalu tekan Enter, atau klik ikon .
- Di subdirektori: Klik nama direktori untuk masuk ke dalamnya, lalu masukkan awalan di kotak pencarian dan tekan Enter, atau klik ikon .

Contoh

Pencarian di direktori root

TestBucket berisi:

TestBucket/
├── Examplesrcfolder1/
│   ├── test.txt
│   └── abc.jpg
├── Exampledestfolder.png
└── example.txt

Pencarian dengan awalan Example menghasilkan:

Hasil	Alasan
`Examplesrcfolder1`	Nama diawali dengan `Example`
`Exampledestfolder.png`	Nama diawali dengan `Example`

Tidak dikembalikan: example.txt (huruf e kecil) dan file di dalam Examplesrcfolder1 (berada di luar cakupan level saat ini).

Pencarian di subdirektori

Examplesrcfolder1 berisi:

Examplesrcfolder1/
├── Projectfolder/
│   ├── a.txt
│   └── b.txt
├── ProjectA.jpg
├── ProjectB.doc
└── projectC.doc

Pencarian dengan awalan Project menghasilkan:

Hasil	Alasan
`Projectfolder`	Nama diawali dengan `Project`
`ProjectA.jpg`	Nama diawali dengan `Project`
`ProjectB.doc`	Nama diawali dengan `Project`

Tidak dikembalikan: projectC.doc (huruf p kecil) dan file di dalam Projectfolder (berada di luar cakupan level saat ini).

Cari objek menggunakan ossbrowser

ossbrowser mendukung operasi tingkat bucket yang sama seperti konsol OSS. Ikuti petunjuk di layar dalam ossbrowser untuk mencari objek. Untuk informasi lebih lanjut, lihat Gunakan ossbrowser.

Langkah berikutnya

Untuk mendaftar objek secara rekursif di seluruh direktori, gunakan operasi API GetBucket (ListObjects) atau perintah PH1 dari ossutil.