Viewing directory bucket 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 directory bucket tags

You can view or list tags applied to S3 directory buckets. For more information about tags, see Using tags with S3 directory buckets.

Permissions

To view tags applied to a directory bucket, you must have the following permission:

  • s3express:ListTagsForResource

Troubleshooting errors

If you encounter an error when attempting to list or view the tags of a directory bucket, you can do the following:

  • Verify that you have the required Permissions to view or list the tags of the directory bucket.

Steps

You can view tags applied to 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 a directory bucket 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 directory buckets.

  3. Choose the bucket name.

  4. Choose the Properties tab.

  5. Scroll to the Tags section to view all of the tags applied to the directory bucket.

  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 directory bucket by Amazon services.

This section provides an example of how to view tags applied to a directory bucket by using the Amazon SDKs.

SDK for Java 2.x

This example shows how to view tags applied to a directory bucket 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:s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3")
                .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 how to view tags applied to a directory bucket. 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:s3express:us-east-1: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": []
}