Viewing access point tags - Amazon Simple Storage Service
PermissionsTroubleshooting errorsSteps
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Viewing access point tags

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.

Permissions

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

  • s3:ListTagsForResource

Troubleshooting errors

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 to view or list the tags of the access point.

Steps

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.

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/.

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

  3. Choose the access point name.

  4. Choose the Properties tab.

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

  6. 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.

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);

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:

To install the Amazon CLI, see Installing the Amazon CLI 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": []
}