tencent cloud

Cloud Object Storage

Release Notes and Announcements
Release Notes
Announcements
Product Introduction
Overview
Features
Use Cases
Strengths
Concepts
Regions and Access Endpoints
Specifications and Limits
Service Regions and Service Providers
Billing
Billing Overview
Billing Method
Billable Items
Free Tier
Billing Examples
Viewing and Downloading Bill
Payment Overdue
FAQs
Getting Started
Console
Getting Started with COSBrowser
User Guide
Creating Request
Bucket
Object
Data Management
Batch Operation
Global Acceleration
Monitoring and Alarms
Operations Center
Data Processing
Content Moderation
Smart Toolbox
Data Processing Workflow
Application Integration
User Tools
Tool Overview
Installation and Configuration of Environment
COSBrowser
COSCLI (Beta)
COSCMD
COS Migration
FTP Server
Hadoop
COSDistCp
HDFS TO COS
GooseFS-Lite
Online Tools
Diagnostic Tool
Use Cases
Overview
Access Control and Permission Management
Performance Optimization
Accessing COS with AWS S3 SDK
Data Disaster Recovery and Backup
Domain Name Management Practice
Image Processing
Audio/Video Practices
Workflow
Direct Data Upload
Content Moderation
Data Security
Data Verification
Big Data Practice
COS Cost Optimization Solutions
Using COS in the Third-party Applications
Migration Guide
Migrating Local Data to COS
Migrating Data from Third-Party Cloud Storage Service to COS
Migrating Data from URL to COS
Migrating Data Within COS
Migrating Data Between HDFS and COS
Data Lake Storage
Cloud Native Datalake Storage
Metadata Accelerator
GooseFS
Data Processing
Data Processing Overview
Image Processing
Media Processing
Content Moderation
File Processing Service
File Preview
Troubleshooting
Obtaining RequestId
Slow Upload over Public Network
403 Error for COS Access
Resource Access Error
POST Object Common Exceptions
API Documentation
Introduction
Common Request Headers
Common Response Headers
Error Codes
Request Signature
Action List
Service APIs
Bucket APIs
Object APIs
Batch Operation APIs
Data Processing APIs
Job and Workflow
Content Moderation APIs
Cloud Antivirus API
SDK Documentation
SDK Overview
Preparations
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
Mini Program SDK
Error Codes
Harmony SDK
Endpoint SDK Quality Optimization
Security and Compliance
Data Disaster Recovery
Data Security
Cloud Access Management
FAQs
Popular Questions
General
Billing
Domain Name Compliance Issues
Bucket Configuration
Domain Names and CDN
Object Operations
Logging and Monitoring
Permission Management
Data Processing
Data Security
Pre-signed URL Issues
SDKs
Tools
APIs
Agreements
Service Level Agreement
Privacy Policy
Data Processing And Security Agreement
Contact Us
Glossary

Searching for Objects

PDF
Mode fokus
Ukuran font
Terakhir diperbarui: 2025-11-28 18:09:59

Overview

You can use the COS console or object key to search for uploaded objects and folders.
ObjectKey is the unique identifier of an object in the bucket, which can be understood as the file path. For example, if the object key is doc/picture.jpg, it means the image file picture.jpg is stored under the doc path (or folder) in Cloud Object Storage (COS).
List object keys to search for specific targets by specified object keys. In addition, you can also search for objects by object key prefix, which means specifying part of the object key (such as doc) to find all objects with the same prefix doc.

Applicable Scenarios

Tencent Cloud COS supports listing object keys by prefix. You can also use the / character in object keys to implement a hierarchical structure similar to the traditional file system. COS also supports using a delimiter to select and browse keys hierarchically.
You can list all keys in a single bucket in UTF-8 binary order of prefixes or filter the key list by specifying the prefix. For example, adding the parameter t will list the tencent object, but skip objects prefixed with a or other characters.
Add the / delimiter and object keys will be reorganized based on this delimiter. You can combine prefixes and delimiters to achieve folder-like searching feature.
Tencent Cloud COS supports an unlimited number of objects in a single bucket, so the object list may be very large. For convenient management, a single List Objects request returns up to 1000 objects and includes a return indicator to inform if truncation exists. If truncation exists, it means that there are more objects on the next page. You can trigger multiple List Objects requests based on indicators and the separator to list all object keys or query the necessary content.

Usage

Using the COS Console

The COS console supports prefix search and fuzzy search.
Prefix search: Search based on the same object prefix and show objects and folders with the same object prefix in the search results.
Fuzzy search: Search with custom keywords and show objects and folders containing the keywords in the search results.
Note:
Search object prefixes are case sensitive when searching for objects.
Besides, you can also use the COSBrowser tool to do fuzzy search. For details, see COSBrowser Overview.

Searching Objects by Prefix

1. Log in to the COS Console.
2. In the left sidebar, click Bucket List to go to the bucket list page.
3. Find the bucket where the object is located and click the bucket name to enter the bucket management page.
4. In the left sidebar, select File List to go to the file list page.
5. In the search box at the top of the page, input the object name prefix and click

to show objects or folders with the same name prefix in the current bucket. For example, input img/ to display search results for objects or folders with img/.


Using Fuzzy Keywords to Search for Objects

1. Log in to the COS Console.
2. In the left sidebar, click Bucket List to go to the bucket list page.
3. Find the bucket where the object is located and click the bucket name to enter the bucket management page.
4. In the left sidebar, select File List to go to the file list page.
5. At the top of the page, enter search keywords in the search box and click

to show search results containing the keyword, including objects and folders. For example, enter keyword t to display objects and folders containing t.


Using the REST API/SDK

You can use REST APIs to trigger a List Objects request. For details, see the GET Bucket (List Objects) API document.
You can directly call the SDK to list objects for searching objects. For details, see the following language SDK documents:

Using Tools

You can use tools to search for objects, such as COSBrowser, COSCMD, COSCLI. For more tool introductions, see Tool Overview.


Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan