Set the name of an object

Last updated:2021-07-20 10:07:42

This feature is available only when you send a Put Object request by using an API operation or SDK to upload an object. When this feature is enabled, you can customize naming rules for objects that are uploaded to Kingsoft Cloud. After an object is uploaded, it is renamed based on the naming rule configured by you. This feature is unavailable when you upload an object on web pages or by sending a Post Object request.

  1. Log in to the KS3 console and click Bucket in the left navigation pane. On the Bucket list page, click the name of the target bucket. On the page that appears, click Bucket Settings. On the Bucket Settings tab, click Set File Name.

You can enable or disable this feature to specify whether to customize the object name.

  1. Customize the object name.

The object name contains one to five fields. If multiple fields are selected, you must sort the fields.

Field rules:
The first field must be 1 to 20 characters in length, and can contain digits (0 to 9), lowercase letters (a to z), and uppercase letters (A to Z).
The second field is automatically generated by the system based on the current time, in the format of YYYY-MM-DD HH:MM:SS or YYYYMMDDHHMMSS.
The third field consists of three random characters.
The fourth field consists of MD5 check bits automatically generated by the system.
The fifth field is the SHA1 value automatically generated by the system.
Multiple fields must be connected by using hyphens(-), underscores (_), plus signs (+), asterisks (*), or forward slashes (/).

For example, the object name generated based on the following settings is an-2021-06-24 15:22:48-8a3-d41d8cd98f00b204e9800998ecf8427e-da39a3ee5e6b4b0d3255bfef95601890afd80709.


When you set the object name, we recommend that you do not use the following three settings. Otherwise, objects with the same names will be overwritten when multiple objects are uploaded concurrently.

  • Select Field 1 (fixed string) only.
  • Select Field 2 (time) only.
  • Select Field 1 (fixed string) and Field 2 (time) only.

Did you find the above information helpful?

Mostly Unhelpful
A little helpful
Very helpful

What might be the problems?

Unclear or awkward
Redundant or clumsy
Lack of context for the complex system or functionality

More suggestions


Please give us your feedback.


Thank you for your feedback.