PowerShell

S3 Rename File

See more Amazon S3 (new) Examples

Demonstrates how to rename a file on Amazon S3.

Renaming an object (file) in AWS S3 using the AWS S3 API involves copying the object to a new location with the desired name and then deleting the original object.

PowerShell

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

$success = $false

# 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.
$bTls = $true
$port = 443
$bAutoReconnect = $true
$success = $rest.Connect("s3-us-west-2.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"

# This particular bucket is in the Oregon region, as opposed to the US Standard,
# therefore the Region must be set appropriately.
# Also note that we connected to "s3-us-west-2.amazonaws.com".
$authAws.Region = "us-west-2"

$rest.SetAuthAws($authAws)

# Set the bucket name via the HOST header.
# In this case, the bucket name is "chilkat.qa".
# Note that the Host header should use "bucketName.s3.amazonaws.com", not "bucketName.s3-us-west-2.amazonaws.com"
$rest.Host = "chilkat.qa.s3.amazonaws.com"

# Copy /images/sea_creatures/starfish.jpg to /images/sea_creatures/starfish3.jpg
# Notice here that the x-amz-copy-source includes the bucket in the source path,
# but the target path passed to FullRequestNoBody does NOT contain the bucket (because the bucket
# was already specified in the Host header).
$rest.AddHeader("x-amz-copy-source","/chilkat.qa/images/sea_creatures/starfish.jpg")

$sbResponse = New-Object Chilkat.StringBuilder
$success = $rest.FullRequestNoBodySb("PUT","/images/sea_creatures/starfish3.jpg",$sbResponse)
if ($success -eq $false) {
    $($rest.LastErrorText)
    exit
}

# When successful, the S3 Storage service will respond with a 200 or 204 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())
$("Copy Successful.")

# --------------------------------------
# Now we can delete the original file..
# --------------------------------------

# We no longer want to send the x-amz-copy-source header.  Remove it.
$rest.RemoveHeader("x-amz-copy-source")

$success = $rest.FullRequestNoBodySb("DELETE","/images/sea_creatures/starfish.jpg",$sbResponse)
if ($success -eq $false) {
    $($rest.LastErrorText)
    exit
}

# If successfully deleted, the response status code is 204 and the response body text will be empty.
$statusCode = $rest.ResponseStatusCode
$("Response status code = " + $statusCode)
$("Response text = ")
$($sbResponse.GetAsString())