com.amazonaws.services.mediastore

Interface AWSMediaStoreAsync

All Superinterfaces:

AWSMediaStore

All Known Implementing Classes:

AbstractAWSMediaStoreAsync, AWSMediaStoreAsyncClient

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AWSMediaStoreAsync
extends AWSMediaStore

Interface for accessing MediaStore asynchronously. Each asynchronous method will return a Java Future object representing the asynchronous operation; overloads which accept an AsyncHandler can be used to receive notification when an asynchronous operation completes.

Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAWSMediaStoreAsync instead.

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 inherited from interface com.amazonaws.services.mediastore.AWSMediaStore

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
Future<CreateContainerResult>	createContainerAsync(CreateContainerRequest createContainerRequest) Creates a storage container to hold objects.
Future<CreateContainerResult>	createContainerAsync(CreateContainerRequest createContainerRequest, AsyncHandler<CreateContainerRequest,CreateContainerResult> asyncHandler) Creates a storage container to hold objects.
Future<DeleteContainerResult>	deleteContainerAsync(DeleteContainerRequest deleteContainerRequest) Deletes the specified container.
Future<DeleteContainerResult>	deleteContainerAsync(DeleteContainerRequest deleteContainerRequest, AsyncHandler<DeleteContainerRequest,DeleteContainerResult> asyncHandler) Deletes the specified container.
Future<DeleteContainerPolicyResult>	deleteContainerPolicyAsync(DeleteContainerPolicyRequest deleteContainerPolicyRequest) Deletes the access policy that is associated with the specified container.
Future<DeleteContainerPolicyResult>	deleteContainerPolicyAsync(DeleteContainerPolicyRequest deleteContainerPolicyRequest, AsyncHandler<DeleteContainerPolicyRequest,DeleteContainerPolicyResult> asyncHandler) Deletes the access policy that is associated with the specified container.
Future<DeleteCorsPolicyResult>	deleteCorsPolicyAsync(DeleteCorsPolicyRequest deleteCorsPolicyRequest) Deletes the cross-origin resource sharing (CORS) configuration information that is set for the container.
Future<DeleteCorsPolicyResult>	deleteCorsPolicyAsync(DeleteCorsPolicyRequest deleteCorsPolicyRequest, AsyncHandler<DeleteCorsPolicyRequest,DeleteCorsPolicyResult> asyncHandler) Deletes the cross-origin resource sharing (CORS) configuration information that is set for the container.
Future<DescribeContainerResult>	describeContainerAsync(DescribeContainerRequest describeContainerRequest) Retrieves the properties of the requested container.
Future<DescribeContainerResult>	describeContainerAsync(DescribeContainerRequest describeContainerRequest, AsyncHandler<DescribeContainerRequest,DescribeContainerResult> asyncHandler) Retrieves the properties of the requested container.
Future<GetContainerPolicyResult>	getContainerPolicyAsync(GetContainerPolicyRequest getContainerPolicyRequest) Retrieves the access policy for the specified container.
Future<GetContainerPolicyResult>	getContainerPolicyAsync(GetContainerPolicyRequest getContainerPolicyRequest, AsyncHandler<GetContainerPolicyRequest,GetContainerPolicyResult> asyncHandler) Retrieves the access policy for the specified container.
Future<GetCorsPolicyResult>	getCorsPolicyAsync(GetCorsPolicyRequest getCorsPolicyRequest) Returns the cross-origin resource sharing (CORS) configuration information that is set for the container.
Future<GetCorsPolicyResult>	getCorsPolicyAsync(GetCorsPolicyRequest getCorsPolicyRequest, AsyncHandler<GetCorsPolicyRequest,GetCorsPolicyResult> asyncHandler) Returns the cross-origin resource sharing (CORS) configuration information that is set for the container.
Future<ListContainersResult>	listContainersAsync(ListContainersRequest listContainersRequest) Lists the properties of all containers in AWS Elemental MediaStore.
Future<ListContainersResult>	listContainersAsync(ListContainersRequest listContainersRequest, AsyncHandler<ListContainersRequest,ListContainersResult> asyncHandler) Lists the properties of all containers in AWS Elemental MediaStore.
Future<PutContainerPolicyResult>	putContainerPolicyAsync(PutContainerPolicyRequest putContainerPolicyRequest) Creates an access policy for the specified container to restrict the users and clients that can access it.
Future<PutContainerPolicyResult>	putContainerPolicyAsync(PutContainerPolicyRequest putContainerPolicyRequest, AsyncHandler<PutContainerPolicyRequest,PutContainerPolicyResult> asyncHandler) Creates an access policy for the specified container to restrict the users and clients that can access it.
Future<PutCorsPolicyResult>	putCorsPolicyAsync(PutCorsPolicyRequest putCorsPolicyRequest) Sets the cross-origin resource sharing (CORS) configuration on a container so that the container can service cross-origin requests.
Future<PutCorsPolicyResult>	putCorsPolicyAsync(PutCorsPolicyRequest putCorsPolicyRequest, AsyncHandler<PutCorsPolicyRequest,PutCorsPolicyResult> asyncHandler) Sets the cross-origin resource sharing (CORS) configuration on a container so that the container can service cross-origin requests.

Methods inherited from interface com.amazonaws.services.mediastore.AWSMediaStore

createContainer, deleteContainer, deleteContainerPolicy, deleteCorsPolicy, describeContainer, getCachedResponseMetadata, getContainerPolicy, getCorsPolicy, listContainers, putContainerPolicy, putCorsPolicy, shutdown

Method Detail

createContainerAsync

Future<CreateContainerResult> createContainerAsync(CreateContainerRequest createContainerRequest)

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

Parameters:

createContainerRequest -

Returns:

A Java Future containing the result of the CreateContainer operation returned by the service.

See Also:

AWS API Documentation

createContainerAsync

Future<CreateContainerResult> createContainerAsync(CreateContainerRequest createContainerRequest,
                                                   AsyncHandler<CreateContainerRequest,CreateContainerResult> asyncHandler)

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

Parameters:

createContainerRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the CreateContainer operation returned by the service.

See Also:

AWS API Documentation

deleteContainerAsync

Future<DeleteContainerResult> deleteContainerAsync(DeleteContainerRequest deleteContainerRequest)

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:

A Java Future containing the result of the DeleteContainer operation returned by the service.

See Also:

AWS API Documentation

deleteContainerAsync

Future<DeleteContainerResult> deleteContainerAsync(DeleteContainerRequest deleteContainerRequest,
                                                   AsyncHandler<DeleteContainerRequest,DeleteContainerResult> asyncHandler)

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 -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the DeleteContainer operation returned by the service.

See Also:

AWS API Documentation

deleteContainerPolicyAsync

Future<DeleteContainerPolicyResult> deleteContainerPolicyAsync(DeleteContainerPolicyRequest deleteContainerPolicyRequest)

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

Parameters:

deleteContainerPolicyRequest -

Returns:

A Java Future containing the result of the DeleteContainerPolicy operation returned by the service.

See Also:

AWS API Documentation

deleteContainerPolicyAsync

Future<DeleteContainerPolicyResult> deleteContainerPolicyAsync(DeleteContainerPolicyRequest deleteContainerPolicyRequest,
                                                               AsyncHandler<DeleteContainerPolicyRequest,DeleteContainerPolicyResult> asyncHandler)

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

Parameters:

deleteContainerPolicyRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the DeleteContainerPolicy operation returned by the service.

See Also:

AWS API Documentation

deleteCorsPolicyAsync

Future<DeleteCorsPolicyResult> deleteCorsPolicyAsync(DeleteCorsPolicyRequest deleteCorsPolicyRequest)

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:

A Java Future containing the result of the DeleteCorsPolicy operation returned by the service.

See Also:

AWS API Documentation

deleteCorsPolicyAsync

Future<DeleteCorsPolicyResult> deleteCorsPolicyAsync(DeleteCorsPolicyRequest deleteCorsPolicyRequest,
                                                     AsyncHandler<DeleteCorsPolicyRequest,DeleteCorsPolicyResult> asyncHandler)

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 -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the DeleteCorsPolicy operation returned by the service.

See Also:

AWS API Documentation

describeContainerAsync

Future<DescribeContainerResult> describeContainerAsync(DescribeContainerRequest describeContainerRequest)

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:

A Java Future containing the result of the DescribeContainer operation returned by the service.

See Also:

AWS API Documentation

describeContainerAsync

Future<DescribeContainerResult> describeContainerAsync(DescribeContainerRequest describeContainerRequest,
                                                       AsyncHandler<DescribeContainerRequest,DescribeContainerResult> asyncHandler)

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 -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the DescribeContainer operation returned by the service.

See Also:

AWS API Documentation

getContainerPolicyAsync

Future<GetContainerPolicyResult> getContainerPolicyAsync(GetContainerPolicyRequest getContainerPolicyRequest)

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:

A Java Future containing the result of the GetContainerPolicy operation returned by the service.

See Also:

AWS API Documentation

getContainerPolicyAsync

Future<GetContainerPolicyResult> getContainerPolicyAsync(GetContainerPolicyRequest getContainerPolicyRequest,
                                                         AsyncHandler<GetContainerPolicyRequest,GetContainerPolicyResult> asyncHandler)

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 -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the GetContainerPolicy operation returned by the service.

See Also:

AWS API Documentation

getCorsPolicyAsync

Future<GetCorsPolicyResult> getCorsPolicyAsync(GetCorsPolicyRequest getCorsPolicyRequest)

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:

A Java Future containing the result of the GetCorsPolicy operation returned by the service.

See Also:

AWS API Documentation

getCorsPolicyAsync

Future<GetCorsPolicyResult> getCorsPolicyAsync(GetCorsPolicyRequest getCorsPolicyRequest,
                                               AsyncHandler<GetCorsPolicyRequest,GetCorsPolicyResult> asyncHandler)

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 -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the GetCorsPolicy operation returned by the service.

See Also:

AWS API Documentation

listContainersAsync

Future<ListContainersResult> listContainersAsync(ListContainersRequest listContainersRequest)

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:

A Java Future containing the result of the ListContainers operation returned by the service.

See Also:

AWS API Documentation

listContainersAsync

Future<ListContainersResult> listContainersAsync(ListContainersRequest listContainersRequest,
                                                 AsyncHandler<ListContainersRequest,ListContainersResult> asyncHandler)

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 -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the ListContainers operation returned by the service.

See Also:

AWS API Documentation

putContainerPolicyAsync

Future<PutContainerPolicyResult> putContainerPolicyAsync(PutContainerPolicyRequest putContainerPolicyRequest)

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:

A Java Future containing the result of the PutContainerPolicy operation returned by the service.

See Also:

AWS API Documentation

putContainerPolicyAsync

Future<PutContainerPolicyResult> putContainerPolicyAsync(PutContainerPolicyRequest putContainerPolicyRequest,
                                                         AsyncHandler<PutContainerPolicyRequest,PutContainerPolicyResult> asyncHandler)

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 -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the PutContainerPolicy operation returned by the service.

See Also:

AWS API Documentation

putCorsPolicyAsync

Future<PutCorsPolicyResult> putCorsPolicyAsync(PutCorsPolicyRequest putCorsPolicyRequest)

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:

A Java Future containing the result of the PutCorsPolicy operation returned by the service.

See Also:

AWS API Documentation

putCorsPolicyAsync

Future<PutCorsPolicyResult> putCorsPolicyAsync(PutCorsPolicyRequest putCorsPolicyRequest,
                                               AsyncHandler<PutCorsPolicyRequest,PutCorsPolicyResult> asyncHandler)

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 -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the PutCorsPolicy operation returned by the service.

See Also:

AWS API Documentation