(PowerShell) S3 Add Tags to an Object

See more Amazon S3 (new) Examples

Demonstrates how to add one or more tags to an S3 object.

For more information, see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html

Chilkat .NET Downloads Chilkat .NET Assemblies

Add-Type -Path "C:\chilkat\ChilkatDotNet47-9.5.0-x64\ChilkatDotNet47.dll"

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

$rest = New-Object Chilkat.Rest

# Connect to the Amazon AWS REST server in the desired region.
# (for us-east-1, we use "s3.amazonaws.com", but for another region, such as us-west-2, we would use "s3-us-west-2.amazonaws.com")
$bTls = $true
$port = 443
$bAutoReconnect = $true
$success = $rest.Connect("s3.amazonaws.com",$port,$bTls,$bAutoReconnect)

# Provide AWS credentials.
$authAws = New-Object Chilkat.AuthAws
$authAws.AccessKey = "AWS_ACCESS_KEY"
$authAws.SecretKey = "AWS_SECRET_KEY"
$authAws.ServiceName = "s3"
$authAws.Region = "us-east-1"

$rest.SetAuthAws($authAws)

# Set the bucket name via the HOST header.
# In this case, the bucket name is "chilkat100".
# Note that the Host header should use "bucketName.s3.amazonaws.com", not "bucketName.s3-us-east-1.amazonaws.com"
# The same applies to aother regions.  The Host header should simply be <bucketName>.s3.amazonaws.com regardless of the region.
$rest.Host = "chilkat100.s3.amazonaws.com"

$xml = New-Object Chilkat.Xml
$xml.Tag = "Tagging"
$xml.UpdateChildContent("TagSet|Tag|Key","plant")
$xml.UpdateChildContent("TagSet|Tag|Value","chili pepper")

$sbRequestBody = New-Object Chilkat.StringBuilder
$xml.GetXmlSb($sbRequestBody)

# It is important to add the terminating "=" after the "?tagging".
$sbResponse = New-Object Chilkat.StringBuilder
$success = $rest.FullRequestSb("PUT","/chiliPepper.gif?tagging=",$sbRequestBody,$sbResponse)
if ($success -eq $false) {
    $($rest.LastErrorText)
    exit
}

$("Response status code: " + $rest.ResponseStatusCode)

# When successful, the S3 Storage service will respond with a 200 response code,
# with an XML body.  
if ($rest.ResponseStatusCode -ne 200) {
    # Examine the request/response to see what happened.
    $("response status code = " + $rest.ResponseStatusCode)
    $("response status text = " + $rest.ResponseStatusText)
    $("response header: " + $rest.ResponseHeader)
    $("response body: " + $sbResponse.GetAsString())
    $("---")
    $("LastRequestStartLine: " + $rest.LastRequestStartLine)
    $("LastRequestHeader: " + $rest.LastRequestHeader)
}

$($sbResponse.GetAsString())
$("Success.")