AWS Elemental MediaStore
User Guide

Uploading an Object

You can upload objects to a container or to a folder within a container. To upload an object to a folder, you specify the path to the folder. If the folder already exists, AWS Elemental MediaStore stores the object in the folder. If the folder doesn’t exist, the service creates it, and then stores the object in the folder. For more information about folders, see Folders in AWS Elemental MediaStore.

You can use the AWS Elemental MediaStore console or the AWS CLI to upload objects.

AWS Elemental MediaStore supports chunked transfer of objects, which reduces latency by making an object available for downloading while it is still being uploaded. To use this capability, set the object's upload availability to streaming. You can set the value of this header when you upload the object using the API. If you don't specify this header in your request, AWS Elemental MediaStore assigns the default value of standard for the object’s upload availability.

Object sizes are limited to 25 MB for standard upload availability and 10 MB for streaming upload availability.

Note

Object file names can contain only letters, numbers, periods (.), underscores (_), tildes (~), and hyphens (-).

To upload an object (console)

  1. Open the MediaStore console at https://console.aws.amazon.com/mediastore/.

  2. On the Containers page, choose the name of the container. The details panel for the container appears.

  3. Choose Upload object.

  4. For Target path, type a path for the folders. For example, premium/canada. If any of the folders in the path that you specify don’t exist yet, the service creates them automatically.

  5. In the Object section, choose Browse.

  6. Navigate to the appropriate folder, and choose one object to upload.

  7. Choose Open, and then choose Upload.

    Note

    If a file with the same name already exists in the selected folder, the service replaces the original file with the uploaded file.

To upload an object (AWS CLI)

  • In the AWS CLI, use the put-object command. You can also include any of the following parameters: content-type, cache-control (to allow the caller to control the object's cache behavior), and path (to put the object in a folder within the container).

    Note

    After you upload the object, you can’t edit the content-type, cache-control, or path.

    aws mediastore-data put-object --region us-west-2 --endpoint=https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com --body=README.md --path=/test/document/README3.md --cache-control "max-age=6, public" --content-type binary/octet-stream

    The following example shows the return value:

    { "ContentSHA256": "74b5fdb517f423ed750ef214c44adfe2be36e37d861eafe9c842cbe1bf387a9d", "StorageClass": "TEMPORAL", "ETag": "af3e4731af032167a106015d1f2fe934e68b32ed1aa297a9e325f5c64979277b" }