PowerShell AWS S3: Get S3 Object Tags

Back to Index

Returns the tags associated with an object. This example gets the tags for the object named "starfish.jpg" located in the bucket "chilkat100".

Documentation: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETtagging.html

CURL Command

curl -X GET https://chilkat100.s3.amazonaws.com/starfish.jpg?tagging

PowerShell Example

[Reflection.Assembly]::LoadFile("C:\myAssemblies\ChilkatDotNet2.dll")

$rest = New-Object Chilkat.Rest

$authAws = New-Object Chilkat.AuthAws
$authAws.AccessKey = "AWS_ACCESS_KEY"
$authAws.SecretKey = "AWS_SECRET_KEY"
$authAws.Region = "us-east-1"
$authAws.ServiceName = "s3"
$rest.SetAuthAws($authAws)

#  URL: https://chilkat100.s3.amazonaws.com/starfish.jpg?tagging
$bTls = $true
$port = 443
$bAutoReconnect = $true
$success = $rest.Connect("chilkat100.s3.amazonaws.com",$port,$bTls,$bAutoReconnect)
if ($success -ne $true) {
    $("ConnectFailReason: " + $rest.ConnectFailReason)
    $($rest.LastErrorText)
    exit
}

$sbResponseBody = New-Object Chilkat.StringBuilder
$success = $rest.FullRequestNoBodySb("GET","/starfish.jpg?tagging",$sbResponseBody)
if ($success -ne $true) {
    $($rest.LastErrorText)
    exit
}

$respStatusCode = $rest.ResponseStatusCode
if ($respStatusCode -ge 400) {
    $("Response Status Code = " + $respStatusCode)
    $("Response Header:")
    $($rest.ResponseHeader)
    $("Response Body:")
    $($sbResponseBody.GetAsString())
    exit
}

$xmlResponse = New-Object Chilkat.Xml
$xmlResponse.LoadSb($sbResponseBody,$true)

#  See the Online Tool for Generating XML Parse Code

$Tagging_xmlns = $xmlResponse.GetAttrValue("xmlns")
$i = 0
$count_i = $xmlResponse.NumChildrenHavingTag("TagSet|Tag")
while ($i -lt $count_i) {
    $xmlResponse.I = $i
    $Key = $xmlResponse.GetChildContent("TagSet|Tag[i]|Key")
    $Value = $xmlResponse.GetChildContent("TagSet|Tag[i]|Value")
    $i = $i + 1
}

Sample XML Response Body

<?xml version="1.0" encoding="UTF-8" ?>
<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <TagSet>
        <Tag>
            <Key>habitat</Key>
            <Value>ocean</Value>
        </Tag>
        <Tag>
            <Key>phylum</Key>
            <Value>Echinodermata</Value>
        </Tag>
        <Tag>
            <Key>animal</Key>
            <Value>starfish</Value>
        </Tag>
    </TagSet>
</Tagging>