Menu
AWS Elemental MediaStore
API Reference (API Version 2017-09-01)

CreateContainer

Creates a storage container to hold objects. A container is similar to a bucket in the Amazon S3 service.

Request Syntax

{ "ContainerName": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

ContainerName

The name for the container. The name must be from 1 to 255 characters. Container names must be unique to your AWS account within a specific region. As an example, you could create a container named movies in every region, as long as you don’t have an existing container with that name.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: \w+

Required: Yes

Response Syntax

{ "Container": { "ARN": "string", "CreationTime": number, "Endpoint": "string", "Name": "string", "Status": "string" } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

Container

ContainerARN: The Amazon Resource Name (ARN) of the newly created container. The ARN has the following format: arn:aws:<region>:<account that owns this container>:container/<name of container>. For example: arn:aws:mediastore:us-west-2:111122223333:container/movies

ContainerName: The container name as specified in the request.

CreationTime: Unix time stamp.

Status: The status of container creation or deletion. The status is one of the following: CREATING, ACTIVE, or DELETING. While the service is creating the container, the status is CREATING. When an endpoint is available, the status changes to ACTIVE.

The return value does not include the container's endpoint. To make downstream requests, you must obtain this value by using DescribeContainer or ListContainers.

Type: Container object

Errors

For information about the errors that are common to all actions, see Common Errors.

ContainerInUseException

The container that you specified in the request already exists or is being updated.

HTTP Status Code: 400

InternalServerError

The service is temporarily unavailable.

HTTP Status Code: 500

LimitExceededException

A service limit has been exceeded.

HTTP Status Code: 400

Examples

Example Request

The following example shows how to create a container with the name movies:

POST / HTTP/1.1 Host: mediastore.us-west-2.amazonaws.com x-amz-Date: 20170323T120000Z x-amz-target:ElementalMediaStoreService_20160711.CreateContainer content-type:application/x-amz-json-1.1 Content-Length:30 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/mediastore/aws4_request, SignedHeaders=host;x-amz-date;x-amz-mediastore-version, Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "ContainerName": "movies", }

Example Response

HTTP/1.1 { "Container": { "ContainerARN": "arn:aws:mediastore:us-west-2:111122223333:container/movies" "ContainerName": "movies" "CreationTime": "1491522511.486", "Status": "CREATING" }

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: