View a markdown version of this page

将 PutBucketTagging 与 CLI 配合使用 - Amazon Simple Storage Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

PutBucketTagging 与 CLI 配合使用

以下代码示例演示如何使用 PutBucketTagging

操作示例是大型程序的代码摘录,必须在上下文中运行。在以下代码示例中,您可以查看此操作的上下文:

CLI
Amazon CLI

以下命令将标记配置应用于名为 amzn-s3-demo-bucket 的存储桶:

aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging file://tagging.json

文件 tagging.json 是当前文件夹中指定标签的 JSON 文档:

{ "TagSet": [ { "Key": "organization", "Value": "marketing" } ] }

或者,直接从命令行将标记配置应用于 amzn-s3-demo-bucket

aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging 'TagSet=[{Key=organization,Value=marketing}]'
  • 有关 API 详细信息,请参阅《Amazon CLI 命令参考》中的 PutBucketTagging

PowerShell
适用于 PowerShell V4 的工具

示例 1:此命令将两个标签应用于名为 cloudtrail-test-2018 的存储桶:一个标签的键为 Stage,值为 Test;另一个标签的键为 Environment,值为 Alpha。要验证标签已添加到存储桶,请运行 Get-S3BucketTagging -BucketName bucket_name。结果应显示您在第一个命令中应用于存储桶的标签。请注意,Write-S3BucketTagging 会覆盖在存储桶上的整个现有标签集。要添加或删除各标签,请运行资源组和标记 API cmdlet Add-RGTResourceTagRemove-RGTResourceTag。或者,使用 Amazon 管理控制台中的标签编辑器来管理 S3 存储桶标签。

Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )

示例 2:此命令将名为 cloudtrail-test-2018 的存储桶传送到 Write-S3BucketTagging cmdlet。它将标签 Stage:Production 和 Department:Finance 应用于存储桶。请注意,Write-S3BucketTagging 会覆盖在存储桶上的整个现有标签集。

Get-S3Bucket -BucketName amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )
  • 有关 API 详细信息,请参阅《Amazon Tools for PowerShell Cmdlet Reference (V4)》中的 PutBucketTagging

适用于 PowerShell V5 的工具

示例 1:此命令将两个标签应用于名为 cloudtrail-test-2018 的存储桶:一个标签的键为 Stage,值为 Test;另一个标签的键为 Environment,值为 Alpha。要验证标签已添加到存储桶,请运行 Get-S3BucketTagging -BucketName bucket_name。结果应显示您在第一个命令中应用于存储桶的标签。请注意,Write-S3BucketTagging 会覆盖在存储桶上的整个现有标签集。要添加或删除各标签,请运行资源组和标记 API cmdlet Add-RGTResourceTagRemove-RGTResourceTag。或者,使用 Amazon 管理控制台中的标签编辑器来管理 S3 存储桶标签。

Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )

示例 2:此命令将名为 cloudtrail-test-2018 的存储桶传送到 Write-S3BucketTagging cmdlet。它将标签 Stage:Production 和 Department:Finance 应用于存储桶。请注意,Write-S3BucketTagging 会覆盖在存储桶上的整个现有标签集。

Get-S3Bucket -BucketName amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )
  • 有关 API 详细信息,请参阅《Amazon Tools for PowerShell Cmdlet Reference (V5)》中的 PutBucketTagging

有关 Amazon SDK 开发人员指南和代码示例的完整列表,请参阅 使用 Amazon SDK 通过 Amazon S3 进行开发。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。