Sample code for 30+ languages & platforms
PowerShell

Upload File with User-Defined Metadata

See more Amazon S3 Examples

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

Chilkat PowerShell Downloads

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

$success = $false

# 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.")
}