# Viewing table bucket tags
<a name="table-bucket-tag-view"></a>

You can view or list tags applied to Amazon S3 table buckets. For more information about tagging table buckets, see [Using tags with S3 table buckets](table-bucket-tagging.md).

## Permissions
<a name="table-bucket-tag-view-permissions"></a>

To view tags applied to a table bucket, you must have the following permission: 
+ `s3tables:ListTagsForResource`

## Troubleshooting errors
<a name="table-bucket-tag-view-troubleshooting"></a>

If you encounter an error when attempting to list or view the tags of a table bucket, you can do the following: 
+ Verify that you have the required [Permissions](#table-bucket-tag-view-permissions) to view the tags of the table bucket.

## Steps
<a name="table-bucket-tag-view-steps"></a>

You can view tags applied to table buckets by using the Amazon S3 Console, the Amazon Command Line Interface (Amazon CLI), the Amazon S3 REST API, and the Amazon SDKs.

## Using the S3 console
<a name="table-bucket-tag-view-console"></a>

To view tags applied to a table bucket using the Amazon S3 console:

1. Sign in to the Amazon S3 console at [https://console.amazonaws.cn/s3/](https://console.amazonaws.cn/s3/).

1. In the left navigation pane, choose **Table buckets**.

1. Choose the table bucket name. 

1. Choose the **Properties** tab. 

1. Scroll to the **Tags** section to view all of the tags applied to the table bucket. 

1. The **Tags** section shows the **User-defined tags** by default. You can select the **Amazon-generated tags** tab to view tags applied to your table bucket by Amazon services.

## Using the REST API
<a name="table-bucket-tag-view-api"></a>

For information about the Amazon S3 REST API support for viewing the tags applied to a table bucket, see the following section in the *Amazon Simple Storage Service API Reference*:
+ [ListTagsforResource](https://docs.amazonaws.cn/AmazonS3/latest/API/API_s3Buckets_ListTagsForResource.html)

## Using the Amazon CLI
<a name="table-bucket-tag-view-cli"></a>

To install the Amazon CLI, see [Installing the Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/getting-started-install.html) in the *Amazon Command Line Interface User Guide*.

The following CLI example shows you how to view tags applied to a table bucket. To use the command replace the {{user input placeholders}} with your own information.

**Request:**

```
aws --region {{us-west-2}} \
s3tables list-tags-for-resource \
--resource-arn arn:aws-cn::s3tables:{{us-west-2}}:{{111122223333}}:bucket/{{amzn-s3-demo-table-bucket}}/table/{{example_table}}
```

**Response - tags present:**

```
{
    "tags": {
        "project": "Trinity",
        "code": "123456"
    }
}
```

**Response - no tags present:**

```
{
  "Tags": []
}
```