Updated on 2024-04-01 GMT+08:00

Searching for an Object or Folder

On OBS Console, you can search for files or folders by storage class, last modification time, or object name prefix.

Procedure

  1. In the navigation pane of OBS Console, choose Object Storage.
  2. In the bucket list, click the bucket you want to operate to go to the Objects page.
  3. Search for objects by storage class:

    1. Click the search box above the object list and choose Storage Class from the drop-down list.
    2. Select your desired option, or enter a keyword and then select the option displayed.
    3. Click OK. The searched objects are displayed in the object list.

    Suppose you want to search for objects in the Standard storage class. Click the search box and choose Storage Class from the drop-down list. Then, select Standard, or enter standard in the search box and select the option displayed. After that, click OK. Objects in the Standard storage class will be displayed in the object list.

    Figure 1 Searching for objects by storage class

  4. Search for objects by last modification time:

    1. Click the search box above the object list and choose Last Modified from the drop-down list.
    2. Select a start date or an end date.

      The time can be accurate to seconds.

      Either start date or end date must be specified.

    3. Click OK. The objects last modified within the specified time range are displayed in the object list.

    Suppose you want to search for objects uploaded from 13:00:00 on October 10, 2023. Click the search box and choose Last Modified from the drop-down list. Then, click the text box for Start Date, specify the time (13:00:00 on October 10, 2023) and click OK. Objects uploaded from 13:00:00 on October 10, 2023 will be displayed in the object list.

    Figure 2 Searching for objects by last modification time

  5. Search for objects by object name prefix:

    1. Click the search box above the object list and choose Object Name Prefix from the drop-down list.
    2. In the search box, enter the name prefix of the files or folders you want to search for.

      The object name prefix is case sensitive.

    3. Click or press Enter. The searched objects are displayed in the object list.

    Suppose you want to search for objects whose prefix is te. Click the search box and choose Object Name Prefix from the drop-down list box. Then, enter te, and press Enter. Objects with the te prefix will be displayed in the object list.

    Figure 3 Searching for objects by object name prefix

    To search for objects within a folder, use either of the following methods:

    • In the root directory, click the search box above the object list and choose Object Name Prefix from the drop-down list. Then, enter Folder path/Prefix in the search box. For example, if you enter abc/123/example, all files and folders with the example prefix in the abc/123 folder will be displayed.
    • Open the folder, and enter the object name prefix in the search box. For example, after you open the abc/123 folder and enter example in the search box, all files and folders with the example prefix in the abc/123 folder will be displayed.

  6. Search for objects by entering a storage class keyword or an object name prefix in the search box above the object list.

    1. Enter a storage class keyword. All objects whose storage class contains the specified keyword will be displayed in the object list.

      Suppose you enter Stan in the search box. The system will then display the Standard storage class. After you click this storage class, all objects whose storage class is Standard will be displayed in the object list.

      Figure 4 Searching for objects by storage class keyword
    2. Enter an object name prefix and click or press Enter. All files and folders with the specified prefix will be displayed in the object list.

      Suppose you want to search for objects with the te prefix. Enter te in the search box and press Enter. Then, all objects with the te prefix will be displayed in the object list.

      Figure 5 Searching for objects by object name prefix
    You can search for objects based on a combination of different filter criteria.
    • If the filter criteria are of different types, they are in intersection logic. For example, if you select storage class Standard and object name prefix te as two criteria, objects whose storage class is Standard and prefix is te will be displayed in the object list.
    • If the filter criteria are of the same type, they are in union logic. For example, if you select storage class Standard and then Infrequent Access as two criteria, objects in both Standard and Infrequent Access storage classes will be displayed in the object list.

Related Operations

In the object list, click next to the size or last modification time to sort objects.

Object search by last modification time can only display the first 1,000 records.

If there are more than 5,000 objects in a bucket, the objects are sorted in alphabetical order and can be searched only by object name prefix.