使用 AWS 具有 S3 存取授權的標籤 - Amazon Simple Storage Service

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

使用 AWS 具有 S3 存取授權的標籤

Amazon S3 Access Grants 中的標籤與 Amazon S3 中的物件標籤具有類似的特性。每個標籤都是金鑰值對。您可以在 S3 Access Grants 中標記的資源包括 S3 Access Grants 執行個體、位置和授權。

注意

S3 存取授與中的標記使用與物件標記不同的API操作。S3 存取授權使用 TagResource, UntagResource，以及 ListTagsForResourceAPI操作，其中資源可以是 S3 Access Grants 執行個體、註冊位置或存取授與。

與物件標籤類似的地方在於具有下列限制：

  • 您可以在建立新的 S3 Access Grants 資源時，新增標籤至新資源，或是新增標籤至現有資源。

  • 一個資源最多可與 10 個標籤相關聯。如果有多個標籤與同一資源相關聯，則這些標籤必須具有唯一的標籤索引鍵。

  • 標籤金鑰最長可包含 128 個 Unicode 字元，標籤值最長可包含 256 個 Unicode 字元。標籤在內部表示在 UTF -16 中。在 UTF -16 中，字符消耗 1 個或 2 個字符的位置。

  • 索引鍵和值區分大小寫。

如需有關標籤限制的詳細資訊，請參閱 AWS Billing 使用者指南。

您可以使用標記 S3 存取授權中的資源 AWS Command Line Interface (AWS CLI），Amazon S3 RESTAPI，或 AWS SDKs.

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

您可以在建立 S3 Access Grants 資源時或之後進行標記。下列範例顯示如何標記或取消標記 S3 Access Grants 執行個體。您可以對註冊位置和存取授權執行類似的操作。

若要使用下列範例命令，請將 user input placeholders 取代為您自己的資訊。

範例 - 建立具有標籤的 S3 Access Grants 執行個體
aws s3control create-access-grants-instance \
 --account-id 111122223333 \
 --profile access-grants-profile \
 --region us-east-2 \
 --tags Key=tagKey1,Value=tagValue1

回應：

 {
    "CreatedAt": "2023-10-25T01:09:46.719000+00:00",
    "AccessGrantsInstanceId": "default",
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default"
}
範例 - 標記已建立的 S3 Access Grants 執行個體
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2 \
--tags Key=tagKey2,Value=tagValue2
範例 - 列出 S3 Access Grants 執行個體的標籤
aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2

回應：

{
    "Tags": [
        {
            "Key": "tagKey1",
            "Value": "tagValue1"
        },
        {
            "Key": "tagKey2",
            "Value": "tagValue2"
        }
    ]
}
範例 - 取消標記 S3 Access Grants 執行個體
aws s3control untag-resource \
 --account-id 111122223333 \
 --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
 --profile access-grants-profile \
 --region us-east-2 \
 --tag-keys "tagKey2"

您可以使用 Amazon S3 API 來標記、取消標記或列出 S3 存取授與執行個體、註冊位置或存取授與的標籤。如需管理 S3 存取授權標籤的RESTAPI支援資訊，請參閱 Amazon 簡單儲存服務API參考中的以下各節：