將標籤新增至存取點 - Amazon Simple Storage Service
許可故障診斷錯誤步驟

將標籤新增至存取點

您可以將標籤新增至 Amazon S3 Access Points，並修改這些標籤。除了標準 S3 API 請求費率之外，在存取點上使用標籤不會產生額外費用。如需詳細資訊，請參閱 Simple Storage Service (Amazon S3) 定價。如需標記存取點的詳細資訊，請參閱 搭配使用標籤和一般用途儲存貯體的 S3 存取點。

許可

若要將標籤新增至存取點，您必須具有下列權限：

  • s3:TagResource

故障診斷錯誤

如果您在嘗試將標籤新增至存取點時遇到錯誤，您可以執行下列動作：

  • 確認您有將標籤新增至存取點時所需的 許可。

  • 如果您嘗試新增以 AWS 預留字首 aws: 開頭的標籤鍵，請變更標籤鍵，然後再試一次。

步驟

您可以使用 Amazon S3 主控台、AWS 命令列介面 (AWS CLI)、Amazon S3 REST API 和 AWS SDK，將標籤新增至存取點。

使用 Amazon S3 主控台將標籤新增至存取點：

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

  2. 在左側導覽窗格中，選擇存取點 (一般用途儲存貯體)。

  3. 選擇存取點名稱。

  4. 選擇屬性索引標籤。

  5. 捲動至標籤區段，選擇新增標籤。

  6. 新增標籤頁面隨即開啟。您最多可以輸入 50 個鍵值對。

  7. 若您使用與現有標籤相同的標籤鍵名稱來新增標籤，新標籤值會覆寫現有標籤值。

  8. 在此頁面上，您也可以編輯現有標籤的值。

  9. 新增標籤後，選擇儲存變更。

SDK for Java 2.x

此範例示範如何使用 AWS SDK for Java 2.x 將標籤新增至存取點。若要使用此命令，請以您自己的資訊取代使用者輸入預留位置。

TagResourceRequest tagResourceRequest = TagResourceRequest.builder().resourceArn(arn:aws::s3:region:111122223333:accesspoint/my-access-point/*)
.accountId(111122223333)
.tags(List.of(Tag.builder().key("key1").value("value1").build(),
Tag.builder().key("key2").value("value2").build()))
.build();
awss3Control.tagResource(tagResourceRequest);

如需有關 Amazon S3 REST API 對於將標籤新增至存取點的支援資訊，請參閱《Amazon Simple Storage Service API 參考》中的以下區段：

若要安裝 AWS CLI，請參閱《AWS Command Line Interface 使用者指南》中的安裝 AWS CLI。

下列 CLI 範例示範如何使用 AWS CLI 將標籤新增至存取點。若要使用此命令，請以您自己的資訊取代使用者輸入預留位置。

要求:

aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3:region:111122223333:accesspoint/my-access-point/* \
--tags "Key=key1,Value=value1"

回應：

{
  "ResponseMetadata": {
      "RequestId": "EXAMPLE123456789",
      "HTTPStatusCode": 200,
      "HTTPHeaders": {
          "date": "Wed, 19 Jun 2025 10:30:00 GMT",
          "content-length": "0"
      },
      "RetryAttempts": 0
  }
}