aws_sdk_mediastore/client/

create_container.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`CreateContainer`](crate::operation::create_container::builders::CreateContainerFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`container_name(impl Into<String>)`](crate::operation::create_container::builders::CreateContainerFluentBuilder::container_name) / [`set_container_name(Option<String>)`](crate::operation::create_container::builders::CreateContainerFluentBuilder::set_container_name):<br>required: **true**<br><p>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 <code>movies</code> in every region, as long as you don’t have an existing container with that name.</p><br>
    ///   - [`tags(Tag)`](crate::operation::create_container::builders::CreateContainerFluentBuilder::tags) / [`set_tags(Option<Vec::<Tag>>)`](crate::operation::create_container::builders::CreateContainerFluentBuilder::set_tags):<br>required: **false**<br><p>An array of key:value pairs that you define. These values can be anything that you want. Typically, the tag key represents a category (such as "environment") and the tag value represents a specific value within that category (such as "test," "development," or "production"). You can add up to 50 tags to each container. For more information about tagging, including naming and usage conventions, see <a href="https://docs.aws.amazon.com/mediastore/latest/ug/tagging.html">Tagging Resources in MediaStore</a>.</p><br>
    /// - On success, responds with [`CreateContainerOutput`](crate::operation::create_container::CreateContainerOutput) with field(s):
    ///   - [`container(Option<Container>)`](crate::operation::create_container::CreateContainerOutput::container): <p>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    </name>   </account>  </region></p> <p>ContainerName: The container name as specified in the request.</p> <p>CreationTime: Unix time stamp.</p> <p>Status: The status of container creation or deletion. The status is one of the following: <code>CREATING</code>, <code>ACTIVE</code>, or <code>DELETING</code>. While the service is creating the container, the status is <code>CREATING</code>. When an endpoint is available, the status changes to <code>ACTIVE</code>.</p> <p>The return value does not include the container's endpoint. To make downstream requests, you must obtain this value by using <code>DescribeContainer</code> or <code>ListContainers</code>.</p>
    /// - On failure, responds with [`SdkError<CreateContainerError>`](crate::operation::create_container::CreateContainerError)
    pub fn create_container(&self) -> crate::operation::create_container::builders::CreateContainerFluentBuilder {
        crate::operation::create_container::builders::CreateContainerFluentBuilder::new(self.handle.clone())
    }
}