本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 檢視儲存貯體標籤
<a name="bucket-tag-view"></a>

您可以檢視或列出套用至 S3 儲存貯體的標籤。如需標籤的詳細資訊，請參閱[搭配 S3 一般用途儲存貯體使用標籤](buckets-tagging.md)。

## 許可
<a name="bucket-tag-view-permissions"></a>

若要檢視套用至儲存貯體的標籤，您必須具有下列許可：
+ `s3:ListTagsForResource`

## 故障診斷錯誤
<a name="bucket-tag-view-troubleshooting"></a>

如果您在嘗試列出或檢視儲存貯體的標籤時遇到錯誤，您可以執行下列動作：
+ 確認您具有[許可](#bucket-tag-view-permissions)檢視或列出儲存貯體標籤所需的 。

## 步驟
<a name="bucket-tag-view-steps"></a>

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS SDKs標籤。

## 使用 S3 主控台
<a name="bucket-tag-view-console"></a>

若要使用 Amazon S3 主控台檢視套用至儲存貯體的標籤：

1. 從 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 登入 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**儲存貯**體。

1. 選擇儲存貯體名稱。

1. 選擇**屬性**索引標籤。

1. 捲動至**標籤**區段，以檢視套用至一般用途儲存貯體的所有標籤。

1. **標籤**區段預設顯示**使用者定義的標籤**。您可以選取 **AWS產生的標籤**標籤，以檢視服務套用至儲存貯體的標籤 AWS 。

## 使用 AWS SDKs
<a name="bucket-tag-view-sdks"></a>

本節提供範例，說明如何使用 AWS SDKs 檢視套用至一般用途儲存貯體的標籤。

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

此範例說明如何使用 檢視套用至一般用途儲存貯體的標籤 AWS 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::s3:::bucket/my-bucket")
                .accountId("111122223333")
                .build();

        ListTagsForResourceResponse response = s3Control.listTagsForResource(listTagsForResourceRequest);
        System.out.println("Tags on my resource:");
        System.out.println(response.toString());
    }
}
```

------

## 使用 REST API
<a name="bucket-tag-view-api"></a>

如需檢視套用至一般用途儲存貯體之標籤的 Amazon S3 REST API 支援相關資訊，請參閱 *Amazon Simple Storage Service API 參考*中的下列章節：
+ [ListTagsForResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html)

## 使用 AWS CLI
<a name="bucket-tag-view-cli"></a>

若要安裝 AWS CLI，請參閱《 [AWS 使用者指南》中的安裝 CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。 *AWS Command Line Interface *

下列 CLI 範例說明如何檢視套用至儲存貯體的標籤。若要使用此命令，請以您自己的資訊取代*使用者輸入預留位置*。

**要求:**

```
aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \
```

**回應 - 具有標籤：**

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

**回應 - 沒有標籤：**

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