Viewing the tags of an access point for directory buckets - 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 the tags of an access point for directory buckets

You can view or list tags applied to Amazon S3 Access Points for directory buckets. For additional information, see Using tags with S3 directory buckets.

Permissions

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

  • s3express:ListTagsForResource

Troubleshooting errors

If you encounter an error when attempting to list or view the tags of an access point for directory buckets, you can do the following:

  • Verify that you have the required Permissions to view or list the tags of the access point for directory buckets.

Steps

You can view tags applied to access points for directory buckets 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 for directory buckets 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 (Directory 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 for directory buckets.

  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 for directory buckets by using the Amazon SDKs.

SDK for Java 2.x

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

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse;

public class ListTagsForResourceExample {
    public static void listTagsForResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build();

        ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
                .resourceArn("arn:aws-cn::s3:us-west-2:111122223333:accesspoint/my-access-point/*")
                .accountId("111122223333")
                .build();
        ListTagsForResourceResponse response = s3Control.listTagsForResource(listTagsForResourceRequest);
        System.out.println("Tags on my resource:");
        System.out.println(response.toString());
    }
}

For information about the Amazon S3 REST API support for viewing the tags applied to a directory bucket, 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 for directory buckets. 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::s3express: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": []
}