An object key is the unique identifier of an object in a bucket. You can think of it as the object’s path. For example, if an object key is
doc/picture.jpg, the image
picture.jpg is stored in the
doc path/folder in COS.
You can use the object key to search for a specific object. You can also use a prefix of the object key (e.g.
doc) to search for all objects with this prefix (e.g. all objects prefixed with
Tencent Cloud COS supports listing keys by a prefix. You can use the delimiter (
/) in a key to implement a hierarchical structure similar to the traditional file system. In COS, you can use 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, would list the
tencent object, while skipping objects prefixed with
a or other characters.
A slash (/) can be used as a delimiter in object keys. In this way, both the prefix and delimiter can be used to facilitate the search.
COS allows you to store an unlimited number of objects in a single bucket. As a result, the key list may be very large. For the convenience of management, a maximum of 1,000 key values can be returned in each
List Objects request, and a marker will be returned to indicate whether the list is truncated. If so, not all objects are listed in this request. In this case, you can initiate the
List Objects request multiple times based on markers and delimiter to list all/some object keys as needed.
You can search for objects in the COS console. For more information, please see Searching for Objects in Console Guide.
You can directly use RESTful APIs to initiate a request to list object keys. For more information, please see GET Bucket (List Objects).
You can directly call the object list querying method in the SDK. For more information, see the SDK documentation for the corresponding programming language below: