Amazon S3

Upload a rendered video or image to an Amazon AWS S3 bucket.

Bucket Authentication can be either via Access Key ID / Secret Access Key or via a bucket policy that allows Impossible Software to upload objects. To use policy based authentication create a bucket policy that includes the AWS Canonical User 1ea9f667f8ec65aa76ca17cbacfda01ba70493b59f7124a810823def30e10216 to upload object. See example further down.

Field	Required	Type	Default	Description
type	Required	String		"s3"
bucket	Required	String		Name of the destination bucket
filename	Required	String		Filename for the destination object
aws_access_key_id	Optional	String
aws_secret_access_key	Optional	String
aws_use_policy	Optional	Boolean	false	Use Bucket policy instead of access key/secret.
s3host	Optional	String		For Signature V4 regions (e.g. eu-central-1), the S3 endpoint is required.
secure	Optional	Boolean	false	Force generation of HTTPS URLs in response.
contenttype	Optional	String	"application/octet-stream"	Mediatype (MIME) for the destination object.
contentdisposition	Optional	String		Content disposition type for the destination object.
acl	Optional	String	"public-read"	Access Control for the destination object. Can be one of: private | public-read | public-read-write | authenticated-read
reduced_redundancy	Optional	Boolean	false	Use reduced redundancy for the destination object.
cachecontrol	Optional	String		Extra controls for the "Cache-Control"-header.
metadata	Optional	Hashmap / Dictionary		Extra Metadata ("x-amz-meta-*")

Example S3 Bucket policy

{
 "Id": "Policy1399574260984",
 "Statement": [
   {
     "Sid": "Stmt1399574252698",
     "Action": [
       "s3:AbortMultipartUpload",
       "s3:ListMultipartUploadParts",
       "s3:PutObject",
       "s3:PutObjectAcl"
     ],
     "Effect": "Allow",
     "Resource": "arn:aws:s3:::BUCKET_NAME/*",
     "Principal": {
         "CanonicalUser":"1ea9f667f8ec65aa76ca17cbacfda01ba70493b59f7124a810823def30e10216"
     }
   }
 ]
}

Example Request:

curl -X POST
     -H "Content-type: application/json"
     http://render.impossible.io/v2/render/Project-ID -d '
{
    "movie": "Movie Name",
    "params": {
        Movie Parameters
    },
    "upload": {
        "extension": "mp4",
        "async": false,
        "destination":  {
            "type": "s3",
            "aws_access_key_id": "AWS Access Key ID",
            "aws_secret_access_key": "AWS Secret Access Key",
            "filename": "myvideos/my-movie-123.mp4",
            "contenttype": "video/mp4",
            "bucket": "mybucket",
            "acl": "public-read",
        }
    }
}'

Example Response:

{
    "token": Token,
    "upload": "http://mybucket.s3.amazonaws.com/myvideos/my-movie-123.mp4"
}