(PowerShell) Upload File with User-Defined Metadata

Demonstrates how to upload a file with user-defined metadata to the Amazon S3 service.

Chilkat .NET Downloads Chilkat .NET Assemblies

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

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

$http = New-Object Chilkat.Http

# Insert your AWS keys here:
$http.AwsAccessKey = "AWS_ACCESS_KEY"
$http.AwsSecretKey = "AWS_SECRET_KEY"

$bucketName = "chilkat.ocean"
$objectName = "seahorse.jpg"
$localFilePath = "qa_data/jpg/seahorse.jpg"
$contentType = "image/jpg"

# User-defined metadata are name/value pairs, and are added to the HTTP request header.
# Header names must begin with "x-amz-meta-" to distinguish them from other HTTP headers.
# Note that Amazon S3 stores user-defined metadata keys in lowercase.

# For example, to add genus=Hippocampus, we do this:
$http.SetRequestHeader("x-amz-meta-genus","Hippocampus")

# Add a few more user-metadata key pairs.
$http.SetRequestHeader("x-amz-meta-species","big-belly seahorse")
$http.SetRequestHeader("x-amz-meta-habitat","shallow tropical and temperate waters")

$success = $http.S3_UploadFile($localFilePath,$contentType,$bucketName,$objectName)

if ($success -ne $true) {
    $($http.LastErrorText)
}
else {
    $("File uploaded.")
}