Adding Tags to a Bucket

When creating a bucket, you can add tags to it. For details, see Creating a Bucket. You can also add tags to a bucket after it has been created. This section describes how to add tags to an existing bucket.

Scenarios

Tags help you to identify your cloud resources. When you have many cloud resources of the same type, you can use tags to classify them by dimension (for example, by purpose, owner, or environment) for usage or cost analysis.

In OBS, you can use tags to identify and classify OBS buckets.

If you add tags to a bucket, service detail records (SDRs) generated for it will be labeled with these tags. You can classify SDRs by tag for cost analysis. For example, if you have an application that uploads its running data to a bucket, you can tag the bucket with the application name. In this manner, the costs on the application can be analyzed using tags in SDRs.

Constraints

A tag is structured as a key-value pair that is case sensitive.
A bucket can have a maximum of 10 tags. Each tag has only one key and one value.
Each key must be unique among all tags of a bucket, whereas the tag values can be repetitive or left blank.
It takes approximately three minutes for an added tag to take effect.

Ways to Configure Bucket Tags

You can use OBS Console, APIs, or SDKs to configure tags for a bucket.

Using OBS Console

In the navigation pane of OBS Console, choose Object Storage.
In the bucket list, click the bucket you want to operate. The Objects page is displayed.
In the navigation pane, choose Overview.
In the Basic Configurations area, click Tags.

Alternatively, you can choose Basic Configurations > Tagging in the navigation pane.
Click Add Tag. The Add Tag dialog box is displayed.

Figure 1 Add Tag

Set the key and value based on Table 1.

**Table 1** Parameter description
Parameter	Description
Tag key	Key of a tag. Tag keys for the same bucket must be unique. You can customize tags or select the ones predefined on TMS. A tag key: Must contain 1 to 36 characters and be case sensitive. Cannot start or end with a space or contain the following characters: =*<>\,\|/
Tag value	Value of a tag. A tag value can be repetitive or left blank. A tag value: Can contain 0 to 43 characters and must be case sensitive. Cannot contain the following characters: =*<>\,\|/