搭配 S3 Access Grants 使用 AWS 標籤

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

注意

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

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

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

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

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

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

如需標籤限制的詳細資訊，請參閱《AWS Billing 使用者指南》中的使用者定義的標籤限制。

您可以使用 AWS Command Line Interface （AWS CLI）API、Amazon S33 或 來標記 S3 Access Grants 中的資源 AWS SDKs。 REST

使用 AWS CLI

若要安裝 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"

使用 REST API

您可以使用 Amazon S3 API來標記、取消標記或列出 S3 Access Grants 執行個體、註冊位置或存取授予的標籤。如需有關管理 S3 Access Grants 標籤的RESTAPI支援資訊，請參閱 Amazon Simple Storage Service API參考 中的下列章節：

• TagResource

• UntagResource

• ListTagsForResource