View a markdown version of this page

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

将 GetObjectTagging 与 CLI 配合使用

以下代码示例演示如何使用 GetObjectTagging。

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

CLI
Amazon CLI

检索附加到对象的标签

以下 get-object-tagging 示例从指定的对象中检索指定键的值。

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc1.rtf

输出：

{
    "TagSet": [
        {
            "Value": "confidential",
            "Key": "designation"
        }
    ]
}

以下 get-object-tagging 示例尝试检索没有标签的对象 doc2.rtf 的标签集。

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc2.rtf

输出：

{
    "TagSet": []
}

以下 get-object-tagging 示例检索具有多个标签的对象 doc3.rtf 的标签集。

aws s3api get-object-tagging \
    --bucket amzn-s3-demo-bucket \
    --key doc3.rtf

输出：

{
    "TagSet": [
        {
            "Value": "confidential",
            "Key": "designation"
        },
        {
            "Value": "finance",
            "Key": "department"
        },
        {
            "Value": "payroll",
            "Key": "team"
        }
    ]
}

  • 有关 API 详细信息，请参阅《Amazon CLI 命令参考》中的 GetObjectTagging。

PowerShell
适用于 PowerShell V4 的工具

示例 1：该示例返回与给定 S3 存储桶上存在的对象关联的标签。

Get-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket'

输出：

Key  Value
---  -----
test value

  • 有关 API 详细信息，请参阅《Amazon Tools for PowerShell Cmdlet Reference (V4)》中的 GetObjectTagging。

适用于 PowerShell V5 的工具

示例 1：该示例返回与给定 S3 存储桶上存在的对象关联的标签。

Get-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket'

输出：

Key  Value
---  -----
test value

  • 有关 API 详细信息，请参阅《Amazon Tools for PowerShell Cmdlet Reference (V5)》中的 GetObjectTagging。

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