software.amazon.awssdk.services.mediastore

Interface MediaStoreClient

All Superinterfaces:

AutoCloseable, SdkAutoCloseable, SdkClient

@Generated(value="software.amazon.awssdk:codegen")
public interface MediaStoreClient
extends SdkClient

Service client for accessing MediaStore. This can be created using the static builder() method.

An AWS Elemental MediaStore container is a namespace that holds folders and objects. You use a container endpoint to create, read, and delete objects.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERVICE_NAME

Method Summary

Modifier and Type	Method and Description
static MediaStoreClientBuilder	builder() Create a builder that can be used to configure and create a MediaStoreClient.
static MediaStoreClient	create() Create a MediaStoreClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default CreateContainerResponse	createContainer(Consumer<CreateContainerRequest.Builder> createContainerRequest) Creates a storage container to hold objects.
default CreateContainerResponse	createContainer(CreateContainerRequest createContainerRequest) Creates a storage container to hold objects.
default DeleteContainerResponse	deleteContainer(Consumer<DeleteContainerRequest.Builder> deleteContainerRequest) Deletes the specified container.
default DeleteContainerResponse	deleteContainer(DeleteContainerRequest deleteContainerRequest) Deletes the specified container.
default DeleteContainerPolicyResponse	deleteContainerPolicy(Consumer<DeleteContainerPolicyRequest.Builder> deleteContainerPolicyRequest) Deletes the access policy that is associated with the specified container.
default DeleteContainerPolicyResponse	deleteContainerPolicy(DeleteContainerPolicyRequest deleteContainerPolicyRequest) Deletes the access policy that is associated with the specified container.
default DeleteCorsPolicyResponse	deleteCorsPolicy(Consumer<DeleteCorsPolicyRequest.Builder> deleteCorsPolicyRequest) Deletes the cross-origin resource sharing (CORS) configuration information that is set for the container.
default DeleteCorsPolicyResponse	deleteCorsPolicy(DeleteCorsPolicyRequest deleteCorsPolicyRequest) Deletes the cross-origin resource sharing (CORS) configuration information that is set for the container.
default DescribeContainerResponse	describeContainer(Consumer<DescribeContainerRequest.Builder> describeContainerRequest) Retrieves the properties of the requested container.
default DescribeContainerResponse	describeContainer(DescribeContainerRequest describeContainerRequest) Retrieves the properties of the requested container.
default GetContainerPolicyResponse	getContainerPolicy(Consumer<GetContainerPolicyRequest.Builder> getContainerPolicyRequest) Retrieves the access policy for the specified container.
default GetContainerPolicyResponse	getContainerPolicy(GetContainerPolicyRequest getContainerPolicyRequest) Retrieves the access policy for the specified container.
default GetCorsPolicyResponse	getCorsPolicy(Consumer<GetCorsPolicyRequest.Builder> getCorsPolicyRequest) Returns the cross-origin resource sharing (CORS) configuration information that is set for the container.
default GetCorsPolicyResponse	getCorsPolicy(GetCorsPolicyRequest getCorsPolicyRequest) Returns the cross-origin resource sharing (CORS) configuration information that is set for the container.
default ListContainersResponse	listContainers() Lists the properties of all containers in AWS Elemental MediaStore.
default ListContainersResponse	listContainers(Consumer<ListContainersRequest.Builder> listContainersRequest) Lists the properties of all containers in AWS Elemental MediaStore.
default ListContainersResponse	listContainers(ListContainersRequest listContainersRequest) Lists the properties of all containers in AWS Elemental MediaStore.
default PutContainerPolicyResponse	putContainerPolicy(Consumer<PutContainerPolicyRequest.Builder> putContainerPolicyRequest) Creates an access policy for the specified container to restrict the users and clients that can access it.
default PutContainerPolicyResponse	putContainerPolicy(PutContainerPolicyRequest putContainerPolicyRequest) Creates an access policy for the specified container to restrict the users and clients that can access it.
default PutCorsPolicyResponse	putCorsPolicy(Consumer<PutCorsPolicyRequest.Builder> putCorsPolicyRequest) Sets the cross-origin resource sharing (CORS) configuration on a container so that the container can service cross-origin requests.
default PutCorsPolicyResponse	putCorsPolicy(PutCorsPolicyRequest putCorsPolicyRequest) Sets the cross-origin resource sharing (CORS) configuration on a container so that the container can service cross-origin requests.
static ServiceMetadata	serviceMetadata()

Methods inherited from interface software.amazon.awssdk.core.SdkClient

serviceName

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable

close

Field Detail

SERVICE_NAME

static final String SERVICE_NAME

See Also:

Constant Field Values

Method Detail

create

static MediaStoreClient create()

Create a MediaStoreClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

builder

static MediaStoreClientBuilder builder()

Create a builder that can be used to configure and create a MediaStoreClient.

createContainer

default CreateContainerResponse createContainer(CreateContainerRequest createContainerRequest)
                                         throws ContainerInUseException,
                                                LimitExceededException,
                                                InternalServerErrorException,
                                                AwsServiceException,
                                                SdkClientException,
                                                MediaStoreException

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

Parameters:

createContainerRequest -

Returns:

Result of the CreateContainer operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

LimitExceededException - A service limit has been exceeded.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

createContainer

default CreateContainerResponse createContainer(Consumer<CreateContainerRequest.Builder> createContainerRequest)
                                         throws ContainerInUseException,
                                                LimitExceededException,
                                                InternalServerErrorException,
                                                AwsServiceException,
                                                SdkClientException,
                                                MediaStoreException

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

This is a convenience which creates an instance of the CreateContainerRequest.Builder avoiding the need to create one manually via CreateContainerRequest.builder()

Parameters:

createContainerRequest - A Consumer that will call methods on CreateContainerInput.Builder to create a request.

Returns:

Result of the CreateContainer operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

LimitExceededException - A service limit has been exceeded.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

deleteContainer

default DeleteContainerResponse deleteContainer(DeleteContainerRequest deleteContainerRequest)
                                         throws ContainerInUseException,
                                                ContainerNotFoundException,
                                                InternalServerErrorException,
                                                AwsServiceException,
                                                SdkClientException,
                                                MediaStoreException

Deletes the specified container. Before you make a DeleteContainer request, delete any objects in the container or in any folders in the container. You can delete only empty containers.

Parameters:

deleteContainerRequest -

Returns:

Result of the DeleteContainer operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

deleteContainer

default DeleteContainerResponse deleteContainer(Consumer<DeleteContainerRequest.Builder> deleteContainerRequest)
                                         throws ContainerInUseException,
                                                ContainerNotFoundException,
                                                InternalServerErrorException,
                                                AwsServiceException,
                                                SdkClientException,
                                                MediaStoreException

Deletes the specified container. Before you make a DeleteContainer request, delete any objects in the container or in any folders in the container. You can delete only empty containers.

This is a convenience which creates an instance of the DeleteContainerRequest.Builder avoiding the need to create one manually via DeleteContainerRequest.builder()

Parameters:

deleteContainerRequest - A Consumer that will call methods on DeleteContainerInput.Builder to create a request.

Returns:

Result of the DeleteContainer operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

deleteContainerPolicy

default DeleteContainerPolicyResponse deleteContainerPolicy(DeleteContainerPolicyRequest deleteContainerPolicyRequest)
                                                     throws ContainerInUseException,
                                                            ContainerNotFoundException,
                                                            PolicyNotFoundException,
                                                            InternalServerErrorException,
                                                            AwsServiceException,
                                                            SdkClientException,
                                                            MediaStoreException

Deletes the access policy that is associated with the specified container.

Parameters:

deleteContainerPolicyRequest -

Returns:

Result of the DeleteContainerPolicy operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

PolicyNotFoundException - Could not perform an operation on a policy that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

deleteContainerPolicy

default DeleteContainerPolicyResponse deleteContainerPolicy(Consumer<DeleteContainerPolicyRequest.Builder> deleteContainerPolicyRequest)
                                                     throws ContainerInUseException,
                                                            ContainerNotFoundException,
                                                            PolicyNotFoundException,
                                                            InternalServerErrorException,
                                                            AwsServiceException,
                                                            SdkClientException,
                                                            MediaStoreException

Deletes the access policy that is associated with the specified container.

This is a convenience which creates an instance of the DeleteContainerPolicyRequest.Builder avoiding the need to create one manually via DeleteContainerPolicyRequest.builder()

Parameters:

deleteContainerPolicyRequest - A Consumer that will call methods on DeleteContainerPolicyInput.Builder to create a request.

Returns:

Result of the DeleteContainerPolicy operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

PolicyNotFoundException - Could not perform an operation on a policy that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

deleteCorsPolicy

default DeleteCorsPolicyResponse deleteCorsPolicy(DeleteCorsPolicyRequest deleteCorsPolicyRequest)
                                           throws ContainerInUseException,
                                                  ContainerNotFoundException,
                                                  CorsPolicyNotFoundException,
                                                  InternalServerErrorException,
                                                  AwsServiceException,
                                                  SdkClientException,
                                                  MediaStoreException

Deletes the cross-origin resource sharing (CORS) configuration information that is set for the container.

To use this operation, you must have permission to perform the MediaStore:DeleteCorsPolicy action. The container owner has this permission by default and can grant this permission to others.

Parameters:

deleteCorsPolicyRequest -

Returns:

Result of the DeleteCorsPolicy operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

CorsPolicyNotFoundException - Could not perform an operation on a policy that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

deleteCorsPolicy

default DeleteCorsPolicyResponse deleteCorsPolicy(Consumer<DeleteCorsPolicyRequest.Builder> deleteCorsPolicyRequest)
                                           throws ContainerInUseException,
                                                  ContainerNotFoundException,
                                                  CorsPolicyNotFoundException,
                                                  InternalServerErrorException,
                                                  AwsServiceException,
                                                  SdkClientException,
                                                  MediaStoreException

Deletes the cross-origin resource sharing (CORS) configuration information that is set for the container.

To use this operation, you must have permission to perform the MediaStore:DeleteCorsPolicy action. The container owner has this permission by default and can grant this permission to others.

This is a convenience which creates an instance of the DeleteCorsPolicyRequest.Builder avoiding the need to create one manually via DeleteCorsPolicyRequest.builder()

Parameters:

deleteCorsPolicyRequest - A Consumer that will call methods on DeleteCorsPolicyInput.Builder to create a request.

Returns:

Result of the DeleteCorsPolicy operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

CorsPolicyNotFoundException - Could not perform an operation on a policy that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

describeContainer

default DescribeContainerResponse describeContainer(DescribeContainerRequest describeContainerRequest)
                                             throws ContainerNotFoundException,
                                                    InternalServerErrorException,
                                                    AwsServiceException,
                                                    SdkClientException,
                                                    MediaStoreException

Retrieves the properties of the requested container. This request is commonly used to retrieve the endpoint of a container. An endpoint is a value assigned by the service when a new container is created. A container's endpoint does not change after it has been assigned. The DescribeContainer request returns a single Container object based on ContainerName. To return all Container objects that are associated with a specified AWS account, use ListContainers.

Parameters:

describeContainerRequest -

Returns:

Result of the DescribeContainer operation returned by the service.

Throws:

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

describeContainer

default DescribeContainerResponse describeContainer(Consumer<DescribeContainerRequest.Builder> describeContainerRequest)
                                             throws ContainerNotFoundException,
                                                    InternalServerErrorException,
                                                    AwsServiceException,
                                                    SdkClientException,
                                                    MediaStoreException

Retrieves the properties of the requested container. This request is commonly used to retrieve the endpoint of a container. An endpoint is a value assigned by the service when a new container is created. A container's endpoint does not change after it has been assigned. The DescribeContainer request returns a single Container object based on ContainerName. To return all Container objects that are associated with a specified AWS account, use ListContainers.

This is a convenience which creates an instance of the DescribeContainerRequest.Builder avoiding the need to create one manually via DescribeContainerRequest.builder()

Parameters:

describeContainerRequest - A Consumer that will call methods on DescribeContainerInput.Builder to create a request.

Returns:

Result of the DescribeContainer operation returned by the service.

Throws:

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

getContainerPolicy

default GetContainerPolicyResponse getContainerPolicy(GetContainerPolicyRequest getContainerPolicyRequest)
                                               throws ContainerInUseException,
                                                      ContainerNotFoundException,
                                                      PolicyNotFoundException,
                                                      InternalServerErrorException,
                                                      AwsServiceException,
                                                      SdkClientException,
                                                      MediaStoreException

Retrieves the access policy for the specified container. For information about the data that is included in an access policy, see the AWS Identity and Access Management User Guide.

Parameters:

getContainerPolicyRequest -

Returns:

Result of the GetContainerPolicy operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

PolicyNotFoundException - Could not perform an operation on a policy that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

getContainerPolicy

default GetContainerPolicyResponse getContainerPolicy(Consumer<GetContainerPolicyRequest.Builder> getContainerPolicyRequest)
                                               throws ContainerInUseException,
                                                      ContainerNotFoundException,
                                                      PolicyNotFoundException,
                                                      InternalServerErrorException,
                                                      AwsServiceException,
                                                      SdkClientException,
                                                      MediaStoreException

Retrieves the access policy for the specified container. For information about the data that is included in an access policy, see the AWS Identity and Access Management User Guide.

This is a convenience which creates an instance of the GetContainerPolicyRequest.Builder avoiding the need to create one manually via GetContainerPolicyRequest.builder()

Parameters:

getContainerPolicyRequest - A Consumer that will call methods on GetContainerPolicyInput.Builder to create a request.

Returns:

Result of the GetContainerPolicy operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

PolicyNotFoundException - Could not perform an operation on a policy that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

getCorsPolicy

default GetCorsPolicyResponse getCorsPolicy(GetCorsPolicyRequest getCorsPolicyRequest)
                                     throws ContainerInUseException,
                                            ContainerNotFoundException,
                                            CorsPolicyNotFoundException,
                                            InternalServerErrorException,
                                            AwsServiceException,
                                            SdkClientException,
                                            MediaStoreException

Returns the cross-origin resource sharing (CORS) configuration information that is set for the container.

To use this operation, you must have permission to perform the MediaStore:GetCorsPolicy action. By default, the container owner has this permission and can grant it to others.

Parameters:

getCorsPolicyRequest -

Returns:

Result of the GetCorsPolicy operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

CorsPolicyNotFoundException - Could not perform an operation on a policy that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

getCorsPolicy

default GetCorsPolicyResponse getCorsPolicy(Consumer<GetCorsPolicyRequest.Builder> getCorsPolicyRequest)
                                     throws ContainerInUseException,
                                            ContainerNotFoundException,
                                            CorsPolicyNotFoundException,
                                            InternalServerErrorException,
                                            AwsServiceException,
                                            SdkClientException,
                                            MediaStoreException

Returns the cross-origin resource sharing (CORS) configuration information that is set for the container.

To use this operation, you must have permission to perform the MediaStore:GetCorsPolicy action. By default, the container owner has this permission and can grant it to others.

This is a convenience which creates an instance of the GetCorsPolicyRequest.Builder avoiding the need to create one manually via GetCorsPolicyRequest.builder()

Parameters:

getCorsPolicyRequest - A Consumer that will call methods on GetCorsPolicyInput.Builder to create a request.

Returns:

Result of the GetCorsPolicy operation returned by the service.

Throws:

ContainerInUseException - Resource already exists or is being updated.

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

CorsPolicyNotFoundException - Could not perform an operation on a policy that does not exist.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

listContainers

default ListContainersResponse listContainers()
                                       throws InternalServerErrorException,
                                              AwsServiceException,
                                              SdkClientException,
                                              MediaStoreException

Lists the properties of all containers in AWS Elemental MediaStore.

You can query to receive all the containers in one response. Or you can include the MaxResults parameter to receive a limited number of containers in each response. In this case, the response includes a token. To get the next set of containers, send the command again, this time with the NextToken parameter (with the returned token as its value). The next set of responses appears, with a token if there are still more containers to receive.

See also DescribeContainer, which gets the properties of one container.

Returns:

Result of the ListContainers operation returned by the service.

Throws:

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

listContainers(ListContainersRequest), AWS API Documentation

listContainers

default ListContainersResponse listContainers(ListContainersRequest listContainersRequest)
                                       throws InternalServerErrorException,
                                              AwsServiceException,
                                              SdkClientException,
                                              MediaStoreException

Lists the properties of all containers in AWS Elemental MediaStore.

You can query to receive all the containers in one response. Or you can include the MaxResults parameter to receive a limited number of containers in each response. In this case, the response includes a token. To get the next set of containers, send the command again, this time with the NextToken parameter (with the returned token as its value). The next set of responses appears, with a token if there are still more containers to receive.

See also DescribeContainer, which gets the properties of one container.

Parameters:

listContainersRequest -

Returns:

Result of the ListContainers operation returned by the service.

Throws:

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

listContainers

default ListContainersResponse listContainers(Consumer<ListContainersRequest.Builder> listContainersRequest)
                                       throws InternalServerErrorException,
                                              AwsServiceException,
                                              SdkClientException,
                                              MediaStoreException

Lists the properties of all containers in AWS Elemental MediaStore.

You can query to receive all the containers in one response. Or you can include the MaxResults parameter to receive a limited number of containers in each response. In this case, the response includes a token. To get the next set of containers, send the command again, this time with the NextToken parameter (with the returned token as its value). The next set of responses appears, with a token if there are still more containers to receive.

See also DescribeContainer, which gets the properties of one container.

This is a convenience which creates an instance of the ListContainersRequest.Builder avoiding the need to create one manually via ListContainersRequest.builder()

Parameters:

listContainersRequest - A Consumer that will call methods on ListContainersInput.Builder to create a request.

Returns:

Result of the ListContainers operation returned by the service.

Throws:

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

putContainerPolicy

default PutContainerPolicyResponse putContainerPolicy(PutContainerPolicyRequest putContainerPolicyRequest)
                                               throws ContainerNotFoundException,
                                                      ContainerInUseException,
                                                      InternalServerErrorException,
                                                      AwsServiceException,
                                                      SdkClientException,
                                                      MediaStoreException

Creates an access policy for the specified container to restrict the users and clients that can access it. For information about the data that is included in an access policy, see the AWS Identity and Access Management User Guide.

For this release of the REST API, you can create only one policy for a container. If you enter PutContainerPolicy twice, the second command modifies the existing policy.

Parameters:

putContainerPolicyRequest -

Returns:

Result of the PutContainerPolicy operation returned by the service.

Throws:

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

ContainerInUseException - Resource already exists or is being updated.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

putContainerPolicy

default PutContainerPolicyResponse putContainerPolicy(Consumer<PutContainerPolicyRequest.Builder> putContainerPolicyRequest)
                                               throws ContainerNotFoundException,
                                                      ContainerInUseException,
                                                      InternalServerErrorException,
                                                      AwsServiceException,
                                                      SdkClientException,
                                                      MediaStoreException

Creates an access policy for the specified container to restrict the users and clients that can access it. For information about the data that is included in an access policy, see the AWS Identity and Access Management User Guide.

For this release of the REST API, you can create only one policy for a container. If you enter PutContainerPolicy twice, the second command modifies the existing policy.

This is a convenience which creates an instance of the PutContainerPolicyRequest.Builder avoiding the need to create one manually via PutContainerPolicyRequest.builder()

Parameters:

putContainerPolicyRequest - A Consumer that will call methods on PutContainerPolicyInput.Builder to create a request.

Returns:

Result of the PutContainerPolicy operation returned by the service.

Throws:

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

ContainerInUseException - Resource already exists or is being updated.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

putCorsPolicy

default PutCorsPolicyResponse putCorsPolicy(PutCorsPolicyRequest putCorsPolicyRequest)
                                     throws ContainerNotFoundException,
                                            ContainerInUseException,
                                            InternalServerErrorException,
                                            AwsServiceException,
                                            SdkClientException,
                                            MediaStoreException

Sets the cross-origin resource sharing (CORS) configuration on a container so that the container can service cross-origin requests. For example, you might want to enable a request whose origin is http://www.example.com to access your AWS Elemental MediaStore container at my.example.container.com by using the browser's XMLHttpRequest capability.

To enable CORS on a container, you attach a CORS policy to the container. In the CORS policy, you configure rules that identify origins and the HTTP methods that can be executed on your container. The policy can contain up to 398,000 characters. You can add up to 100 rules to a CORS policy. If more than one rule applies, the service uses the first applicable rule listed.

Parameters:

putCorsPolicyRequest -

Returns:

Result of the PutCorsPolicy operation returned by the service.

Throws:

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

ContainerInUseException - Resource already exists or is being updated.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

putCorsPolicy

default PutCorsPolicyResponse putCorsPolicy(Consumer<PutCorsPolicyRequest.Builder> putCorsPolicyRequest)
                                     throws ContainerNotFoundException,
                                            ContainerInUseException,
                                            InternalServerErrorException,
                                            AwsServiceException,
                                            SdkClientException,
                                            MediaStoreException

Sets the cross-origin resource sharing (CORS) configuration on a container so that the container can service cross-origin requests. For example, you might want to enable a request whose origin is http://www.example.com to access your AWS Elemental MediaStore container at my.example.container.com by using the browser's XMLHttpRequest capability.

To enable CORS on a container, you attach a CORS policy to the container. In the CORS policy, you configure rules that identify origins and the HTTP methods that can be executed on your container. The policy can contain up to 398,000 characters. You can add up to 100 rules to a CORS policy. If more than one rule applies, the service uses the first applicable rule listed.

This is a convenience which creates an instance of the PutCorsPolicyRequest.Builder avoiding the need to create one manually via PutCorsPolicyRequest.builder()

Parameters:

putCorsPolicyRequest - A Consumer that will call methods on PutCorsPolicyInput.Builder to create a request.

Returns:

Result of the PutCorsPolicy operation returned by the service.

Throws:

ContainerNotFoundException - Could not perform an operation on a container that does not exist.

ContainerInUseException - Resource already exists or is being updated.

InternalServerErrorException - The service is temporarily unavailable.

SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.

MediaStoreException - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.

AwsServiceException

See Also:

AWS API Documentation

serviceMetadata

static ServiceMetadata serviceMetadata()