Output Options

CDN

S3 Signed URL

FTP Destination

Azure Destination

IAM Users

S3 Destination

Other Service Signed Urls

Getting Started

Blitline Job

Welcome

Job Options

List of Available Functions

Examples List

Functions

Job Response

Polling and Postbacks

Service Limits

Development Recommendations

Gotchas

Advanced

Pipelines

Fonts

Smart Image

Static IPs

Formats

Colorspace

Color Extraction

PDF

Image Optimization

Metadata

Signed Jobs

AI Background Removal

Subimage

Special (Non-Image) Processing

Zipping

Trancoding Video Presets

Apache Tika

AWS Rekognition/Facial Recognition

Animated GIFs

Building Gifs or Videos from Images

Find Image on the Internet

Video Keyframes

Video Transcoding

Screenshots of Websites

IM Scripts

Vector Processing

S3 Destination

Updated 4 months ago by Blitline Support

NOTE: If you do not want to give Blitline permission to your buckets, please see Using S3 Signed Urls

SETTING YOUR AWS CANONICAL ID

It is VERY important that you set your AWS Canonical ID on your Blitline.com account if you are going to let Blitline push images to your bucket. You can set the Canonical ID by logging in to Blitline.com, and locating it on the logged in homepage.

Without the Canonical ID, we cannot make YOU the owner of the image. Even though it is in yourbucket, Blitline will still be the owner of the object and you will not be able to do anything to it (such as rename, or re-permission) and your only option will be to copy it somewhere, thus making you the owner of the copy. SO, make sure you set the Canonical ID!

HOW DO I GET MY AWS CANONICAL ID?

First, make sure you are logged in to the AWS web console. Then navigate to https://console.aws.amazon.com...

On this screen you will click the Account Identifiers section.

"Canonical Location"

Copy and paste this into the Blitline.com homepage Canonical ID section, and click the Updatebutton.

S3 PERMISSION

Please make sure you have already set your Canonical ID before proceeding.

You will need to give Blitline permission to write to your S3 buckets.

You can do this through the AWS web console:

  • Navigate to S3 and the list of your buckets
  • Select your bucket in the left column
  • Click the Properties button on the top of the screen
  • Click the Add Bucket Policy bucket under Permissions
"Bucket Properties"
  • In the text area that appears, copy and paste the following code (Replace the YOUR_BUCKET_NAME placeholder text with your actual bucket name)

{
"Version": "2008-10-17",
"Statement": [
{
"Sid": "AddCannedAcl",
"Effect": "Allow",
"Principal": {
"CanonicalUser": "dd81f2e5f9fd34f0fca01d29c62e6ae6cafd33079d99d14ad22fbbea41f36d9a"
},
"Action": [
"s3:PutObjectAcl",
"s3:PutObject"
],
"Resource": "arn:aws:s3:::YOUR_BUCKET_NAME\/*"
},
{
"Effect": "Allow",
"Principal": {
"CanonicalUser": "dd81f2e5f9fd34f0fca01d29c62e6ae6cafd33079d99d14ad22fbbea41f36d9a"
},
"Action": [
"s3:GetBucketLocation"
],
"Resource": "arn:aws:s3:::YOUR_BUCKET_NAME"
}
]
}

  • Click the Save button.
  • (Optional) If you want Blitline to be able to READ from your bucket, add s3:GetObject under Action as well…

This permission policy above allows Blitline to write to your bucket.

PUSHING TO YOUR S3 BUCKET

In your Blitline job, you will need to add an “s3_destination”. This “s3_destination” needs to have the following children:

  • bucket (Your S3 bucket to push to)
  • key (The S3 key for the image that you wish Blitline to write to)
  • headers (Optional headers you wish to have added to your S3 item)
Here is an example of a Blitline job that will push to your bucket:
{
"application_id": "YOUR_APP_ID",
"src" : "http://www.google.com/logos/2011/houdini11-hp.jpg",
"postback_url" : "YOUR_WEBSITE_URL",
"functions" : [{
"name": "blur",
"save" : {
"image_identifier" : "YOUR_IMAGE_IDENTIFIER",
"s3_destination" : {
"bucket" : "YOUR_BUCKET_NAME",
"key" : "key value to save image as"
}
}
}]
}


How did we do?