# Viewing access point tags
<a name="access-points-tag-view"></a>

You can view or list tags applied to access points. For more information about tags, see [Using tags with S3 Access Points for general purpose buckets](access-points-tagging.md).

## Permissions
<a name="access-points-tag-view-permissions"></a>

To view tags applied to an access point, you must have the following permission: 
+ `s3:ListTagsForResource`

## Troubleshooting errors
<a name="access-points-tag-view-troubleshooting"></a>

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

## Steps
<a name="access-points-tag-view-steps"></a>

You can view tags applied to access points by using the Amazon S3 console, the Amazon Command Line Interface (Amazon CLI), the Amazon S3 REST API, and Amazon SDKs.

## Using the S3 console
<a name="access-points-tag-view-console"></a>

To view tags applied to an access point using the Amazon S3 console:

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

1. In the left navigation pane, choose **Access Points (General Purpose Buckets)**.

1. Choose the access point name. 

1. Choose the **Properties** tab. 

1. Scroll to the **Tags** section to view all of the tags applied to the access point. 

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 access point by Amazon services.

## Using the Amazon SDKs
<a name="access-points-tag-view-sdks"></a>

This section provides an example of how to view tags applied to an access point by using the Amazon SDKs.

------
#### [ SDK for Java 2.x ]

This example shows you how to view tags applied to an access point by using the Amazon SDK for Java 2.x. 

```
ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest
.builder().resourceArn(arn:aws-cn::s3:{{region}}:{{111122223333}}:accesspoint/{{{{my-access-point}}}}/*)
                .accountId({{111122223333}}).build();
awss3Control.listTagsForResource(listTagsForResourceRequest);
```

------

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

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

## Using the Amazon CLI
<a name="access-points-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 an access point. To use the command replace the {{user input placeholders}} with your own information.

**Request:**

```
aws s3control list-tags-for-resource \
--account-id {{111122223333}} \
--resource-arn arn:aws-cn::s3:{{region}}:{{444455556666}}:bucket/prefix--{{use1-az4}}--x-s3 \
```

**Response - tags present:**

```
{
  "Tags": [
      {
          "Key": "{{MyKey1}}",
          "Value": "{{MyValue1}}"
      },
      {
          "Key": "{{MyKey2}}",
          "Value": "{{MyValue2}}"
      },
      {
          "Key": "{{MyKey3}}",
          "Value": "{{MyValue3}}"
      }
  ]
}
```

**Response - no tags present:**

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