@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonCloudFrontAsyncClient extends AmazonCloudFrontClient implements AmazonCloudFrontAsync
AsyncHandler
can be used to receive
notification when an asynchronous operation completes.
This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about CloudFront API actions, data types, and errors. For detailed information about CloudFront features, see the Amazon CloudFront Developer Guide.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Constructor and Description |
---|
AmazonCloudFrontAsyncClient()
Deprecated.
|
AmazonCloudFrontAsyncClient(AWSCredentials awsCredentials)
Deprecated.
|
AmazonCloudFrontAsyncClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration,
ExecutorService executorService)
|
AmazonCloudFrontAsyncClient(AWSCredentials awsCredentials,
ExecutorService executorService)
|
AmazonCloudFrontAsyncClient(AWSCredentialsProvider awsCredentialsProvider)
Deprecated.
|
AmazonCloudFrontAsyncClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
|
AmazonCloudFrontAsyncClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
ExecutorService executorService)
|
AmazonCloudFrontAsyncClient(AWSCredentialsProvider awsCredentialsProvider,
ExecutorService executorService)
|
AmazonCloudFrontAsyncClient(ClientConfiguration clientConfiguration)
Deprecated.
|
builder, createCloudFrontOriginAccessIdentity, createDistribution, createDistributionWithTags, createInvalidation, createStreamingDistribution, createStreamingDistributionWithTags, deleteCloudFrontOriginAccessIdentity, deleteDistribution, deleteServiceLinkedRole, deleteStreamingDistribution, getCachedResponseMetadata, getCloudFrontOriginAccessIdentity, getCloudFrontOriginAccessIdentityConfig, getDistribution, getDistributionConfig, getInvalidation, getStreamingDistribution, getStreamingDistributionConfig, listCloudFrontOriginAccessIdentities, listDistributions, listDistributionsByWebACLId, listInvalidations, listStreamingDistributions, listTagsForResource, tagResource, untagResource, updateCloudFrontOriginAccessIdentity, updateDistribution, updateStreamingDistribution, waiters
addRequestHandler, addRequestHandler, configureRegion, getEndpointPrefix, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
createCloudFrontOriginAccessIdentity, createDistribution, createDistributionWithTags, createInvalidation, createStreamingDistribution, createStreamingDistributionWithTags, deleteCloudFrontOriginAccessIdentity, deleteDistribution, deleteServiceLinkedRole, deleteStreamingDistribution, getCachedResponseMetadata, getCloudFrontOriginAccessIdentity, getCloudFrontOriginAccessIdentityConfig, getDistribution, getDistributionConfig, getInvalidation, getStreamingDistribution, getStreamingDistributionConfig, listCloudFrontOriginAccessIdentities, listDistributions, listDistributionsByWebACLId, listInvalidations, listStreamingDistributions, listTagsForResource, setEndpoint, setRegion, tagResource, untagResource, updateCloudFrontOriginAccessIdentity, updateDistribution, updateStreamingDistribution, waiters
@Deprecated public AmazonCloudFrontAsyncClient()
AmazonCloudFrontAsyncClientBuilder.defaultClient()
Asynchronous methods are delegated to a fixed-size thread pool containing 50 threads (to match the default maximum number of concurrent connections to the service).
@Deprecated public AmazonCloudFrontAsyncClient(ClientConfiguration clientConfiguration)
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
Asynchronous methods are delegated to a fixed-size thread pool containing a number of threads equal to the
maximum number of concurrent connections configured via ClientConfiguration.getMaxConnections()
.
clientConfiguration
- The client configuration options controlling how this client connects to CloudFront (ex: proxy settings,
retry counts, etc).DefaultAWSCredentialsProviderChain
,
Executors.newFixedThreadPool(int)
@Deprecated public AmazonCloudFrontAsyncClient(AWSCredentials awsCredentials)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
Asynchronous methods are delegated to a fixed-size thread pool containing 50 threads (to match the default maximum number of concurrent connections to the service).
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.Executors.newFixedThreadPool(int)
@Deprecated public AmazonCloudFrontAsyncClient(AWSCredentials awsCredentials, ExecutorService executorService)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsAsyncClientBuilder.withExecutorFactory(com.amazonaws.client.builder.ExecutorFactory)
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.executorService
- The executor service by which all asynchronous requests will be executed.@Deprecated public AmazonCloudFrontAsyncClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration, ExecutorService executorService)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
and
AwsAsyncClientBuilder.withExecutorFactory(com.amazonaws.client.builder.ExecutorFactory)
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.clientConfiguration
- Client configuration options (ex: max retry limit, proxy settings, etc).executorService
- The executor service by which all asynchronous requests will be executed.@Deprecated public AmazonCloudFrontAsyncClient(AWSCredentialsProvider awsCredentialsProvider)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
Asynchronous methods are delegated to a fixed-size thread pool containing 50 threads (to match the default maximum number of concurrent connections to the service).
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.Executors.newFixedThreadPool(int)
@Deprecated public AmazonCloudFrontAsyncClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
Asynchronous methods are delegated to a fixed-size thread pool containing a number of threads equal to the
maximum number of concurrent connections configured via ClientConfiguration.getMaxConnections()
.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- Client configuration options (ex: max retry limit, proxy settings, etc).DefaultAWSCredentialsProviderChain
,
Executors.newFixedThreadPool(int)
@Deprecated public AmazonCloudFrontAsyncClient(AWSCredentialsProvider awsCredentialsProvider, ExecutorService executorService)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsAsyncClientBuilder.withExecutorFactory(com.amazonaws.client.builder.ExecutorFactory)
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.executorService
- The executor service by which all asynchronous requests will be executed.@Deprecated public AmazonCloudFrontAsyncClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, ExecutorService executorService)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
and
AwsAsyncClientBuilder.withExecutorFactory(com.amazonaws.client.builder.ExecutorFactory)
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- Client configuration options (ex: max retry limit, proxy settings, etc).executorService
- The executor service by which all asynchronous requests will be executed.public static AmazonCloudFrontAsyncClientBuilder asyncBuilder()
public ExecutorService getExecutorService()
public Future<CreateCloudFrontOriginAccessIdentityResult> createCloudFrontOriginAccessIdentityAsync(CreateCloudFrontOriginAccessIdentityRequest request)
AmazonCloudFrontAsync
Creates a new origin access identity. If you're using Amazon S3 for your origin, you can use an origin access identity to require users to access your content using a CloudFront URL instead of the Amazon S3 URL. For more information about how to use origin access identities, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
createCloudFrontOriginAccessIdentityAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new origin access identity.public Future<CreateCloudFrontOriginAccessIdentityResult> createCloudFrontOriginAccessIdentityAsync(CreateCloudFrontOriginAccessIdentityRequest request, AsyncHandler<CreateCloudFrontOriginAccessIdentityRequest,CreateCloudFrontOriginAccessIdentityResult> asyncHandler)
AmazonCloudFrontAsync
Creates a new origin access identity. If you're using Amazon S3 for your origin, you can use an origin access identity to require users to access your content using a CloudFront URL instead of the Amazon S3 URL. For more information about how to use origin access identities, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
createCloudFrontOriginAccessIdentityAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new origin access identity.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.public Future<CreateDistributionResult> createDistributionAsync(CreateDistributionRequest request)
AmazonCloudFrontAsync
Creates a new web distribution. Send a POST
request to the
/CloudFront API version/distribution
/distribution ID
resource.
createDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new distribution.public Future<CreateDistributionResult> createDistributionAsync(CreateDistributionRequest request, AsyncHandler<CreateDistributionRequest,CreateDistributionResult> asyncHandler)
AmazonCloudFrontAsync
Creates a new web distribution. Send a POST
request to the
/CloudFront API version/distribution
/distribution ID
resource.
createDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new distribution.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.public Future<CreateDistributionWithTagsResult> createDistributionWithTagsAsync(CreateDistributionWithTagsRequest request)
AmazonCloudFrontAsync
Create a new distribution with tags.
createDistributionWithTagsAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new distribution with tags.public Future<CreateDistributionWithTagsResult> createDistributionWithTagsAsync(CreateDistributionWithTagsRequest request, AsyncHandler<CreateDistributionWithTagsRequest,CreateDistributionWithTagsResult> asyncHandler)
AmazonCloudFrontAsync
Create a new distribution with tags.
createDistributionWithTagsAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new distribution with tags.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.public Future<CreateInvalidationResult> createInvalidationAsync(CreateInvalidationRequest request)
AmazonCloudFrontAsync
Create a new invalidation.
createInvalidationAsync
in interface AmazonCloudFrontAsync
request
- The request to create an invalidation.public Future<CreateInvalidationResult> createInvalidationAsync(CreateInvalidationRequest request, AsyncHandler<CreateInvalidationRequest,CreateInvalidationResult> asyncHandler)
AmazonCloudFrontAsync
Create a new invalidation.
createInvalidationAsync
in interface AmazonCloudFrontAsync
request
- The request to create an invalidation.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.public Future<CreateStreamingDistributionResult> createStreamingDistributionAsync(CreateStreamingDistributionRequest request)
AmazonCloudFrontAsync
Creates a new RMTP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.
To create a new web distribution, submit a POST
request to the CloudFront API
version/distribution resource. The request body must include a document with a
StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig
element and returns other information about the RTMP distribution.
To get the status of your request, use the GET StreamingDistribution API action. When the value of
Enabled
is true
and the value of Status
is Deployed
, your
distribution is ready. A distribution usually deploys in less than 15 minutes.
For more information about web distributions, see Working with RTMP Distributions in the Amazon CloudFront Developer Guide.
Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML
document that you include in the request body when you create or update a web distribution or an RTMP
distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too
easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs
and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions
and to notify you when there's a mismatch between the number of values you say you're specifying in the
Quantity
element and the number of values specified.
createStreamingDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new streaming distribution.public Future<CreateStreamingDistributionResult> createStreamingDistributionAsync(CreateStreamingDistributionRequest request, AsyncHandler<CreateStreamingDistributionRequest,CreateStreamingDistributionResult> asyncHandler)
AmazonCloudFrontAsync
Creates a new RMTP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.
To create a new web distribution, submit a POST
request to the CloudFront API
version/distribution resource. The request body must include a document with a
StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig
element and returns other information about the RTMP distribution.
To get the status of your request, use the GET StreamingDistribution API action. When the value of
Enabled
is true
and the value of Status
is Deployed
, your
distribution is ready. A distribution usually deploys in less than 15 minutes.
For more information about web distributions, see Working with RTMP Distributions in the Amazon CloudFront Developer Guide.
Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML
document that you include in the request body when you create or update a web distribution or an RTMP
distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too
easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs
and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions
and to notify you when there's a mismatch between the number of values you say you're specifying in the
Quantity
element and the number of values specified.
createStreamingDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new streaming distribution.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.public Future<CreateStreamingDistributionWithTagsResult> createStreamingDistributionWithTagsAsync(CreateStreamingDistributionWithTagsRequest request)
AmazonCloudFrontAsync
Create a new streaming distribution with tags.
createStreamingDistributionWithTagsAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new streaming distribution with tags.public Future<CreateStreamingDistributionWithTagsResult> createStreamingDistributionWithTagsAsync(CreateStreamingDistributionWithTagsRequest request, AsyncHandler<CreateStreamingDistributionWithTagsRequest,CreateStreamingDistributionWithTagsResult> asyncHandler)
AmazonCloudFrontAsync
Create a new streaming distribution with tags.
createStreamingDistributionWithTagsAsync
in interface AmazonCloudFrontAsync
request
- The request to create a new streaming distribution with tags.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.public Future<DeleteCloudFrontOriginAccessIdentityResult> deleteCloudFrontOriginAccessIdentityAsync(DeleteCloudFrontOriginAccessIdentityRequest request)
AmazonCloudFrontAsync
Delete an origin access identity.
deleteCloudFrontOriginAccessIdentityAsync
in interface AmazonCloudFrontAsync
request
- Deletes a origin access identity.public Future<DeleteCloudFrontOriginAccessIdentityResult> deleteCloudFrontOriginAccessIdentityAsync(DeleteCloudFrontOriginAccessIdentityRequest request, AsyncHandler<DeleteCloudFrontOriginAccessIdentityRequest,DeleteCloudFrontOriginAccessIdentityResult> asyncHandler)
AmazonCloudFrontAsync
Delete an origin access identity.
deleteCloudFrontOriginAccessIdentityAsync
in interface AmazonCloudFrontAsync
request
- Deletes a origin access identity.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.public Future<DeleteDistributionResult> deleteDistributionAsync(DeleteDistributionRequest request)
AmazonCloudFrontAsync
Delete a distribution.
deleteDistributionAsync
in interface AmazonCloudFrontAsync
request
- This action deletes a web distribution. To delete a web distribution using the CloudFront API, perform the
following steps.
To delete a web distribution using the CloudFront API:
Disable the web distribution
Submit a GET Distribution Config
request to get the current configuration and the
Etag
header for the distribution.
Update the XML document that was returned in the response to your GET Distribution Config
request to change the value of Enabled
to false
.
Submit a PUT Distribution Config
request to update the configuration for your distribution.
In the request body, include the XML document that you updated in Step 3. Set the value of the HTTP
If-Match
header to the value of the ETag
header that CloudFront returned when
you submitted the GET Distribution Config
request in Step 2.
Review the response to the PUT Distribution Config
request to confirm that the distribution
was successfully disabled.
Submit a GET Distribution
request to confirm that your changes have propagated. When
propagation is complete, the value of Status
is Deployed
.
Submit a DELETE Distribution
request. Set the value of the HTTP If-Match
header
to the value of the ETag
header that CloudFront returned when you submitted the
GET Distribution Config
request in Step 6.
Review the response to your DELETE Distribution
request to confirm that the distribution was
successfully deleted.
For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.
public Future<DeleteDistributionResult> deleteDistributionAsync(DeleteDistributionRequest request, AsyncHandler<DeleteDistributionRequest,DeleteDistributionResult> asyncHandler)
AmazonCloudFrontAsync
Delete a distribution.
deleteDistributionAsync
in interface AmazonCloudFrontAsync
request
- This action deletes a web distribution. To delete a web distribution using the CloudFront API, perform the
following steps.
To delete a web distribution using the CloudFront API:
Disable the web distribution
Submit a GET Distribution Config
request to get the current configuration and the
Etag
header for the distribution.
Update the XML document that was returned in the response to your GET Distribution Config
request to change the value of Enabled
to false
.
Submit a PUT Distribution Config
request to update the configuration for your distribution.
In the request body, include the XML document that you updated in Step 3. Set the value of the HTTP
If-Match
header to the value of the ETag
header that CloudFront returned when
you submitted the GET Distribution Config
request in Step 2.
Review the response to the PUT Distribution Config
request to confirm that the distribution
was successfully disabled.
Submit a GET Distribution
request to confirm that your changes have propagated. When
propagation is complete, the value of Status
is Deployed
.
Submit a DELETE Distribution
request. Set the value of the HTTP If-Match
header
to the value of the ETag
header that CloudFront returned when you submitted the
GET Distribution Config
request in Step 6.
Review the response to your DELETE Distribution
request to confirm that the distribution was
successfully deleted.
For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.
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.public Future<DeleteServiceLinkedRoleResult> deleteServiceLinkedRoleAsync(DeleteServiceLinkedRoleRequest request)
deleteServiceLinkedRoleAsync
in interface AmazonCloudFrontAsync
public Future<DeleteServiceLinkedRoleResult> deleteServiceLinkedRoleAsync(DeleteServiceLinkedRoleRequest request, AsyncHandler<DeleteServiceLinkedRoleRequest,DeleteServiceLinkedRoleResult> asyncHandler)
deleteServiceLinkedRoleAsync
in interface AmazonCloudFrontAsync
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.public Future<DeleteStreamingDistributionResult> deleteStreamingDistributionAsync(DeleteStreamingDistributionRequest request)
AmazonCloudFrontAsync
Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.
To delete an RTMP distribution using the CloudFront API:
Disable the RTMP distribution.
Submit a GET Streaming Distribution Config
request to get the current configuration and the
Etag
header for the distribution.
Update the XML document that was returned in the response to your GET Streaming Distribution Config
request to change the value of Enabled
to false
.
Submit a PUT Streaming Distribution Config
request to update the configuration for your
distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the
HTTP If-Match
header to the value of the ETag
header that CloudFront returned when you
submitted the GET Streaming Distribution Config
request in Step 2.
Review the response to the PUT Streaming Distribution Config
request to confirm that the
distribution was successfully disabled.
Submit a GET Streaming Distribution Config
request to confirm that your changes have propagated.
When propagation is complete, the value of Status
is Deployed
.
Submit a DELETE Streaming Distribution
request. Set the value of the HTTP If-Match
header to the value of the ETag
header that CloudFront returned when you submitted the
GET Streaming Distribution Config
request in Step 2.
Review the response to your DELETE Streaming Distribution
request to confirm that the distribution
was successfully deleted.
For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.
deleteStreamingDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to delete a streaming distribution.public Future<DeleteStreamingDistributionResult> deleteStreamingDistributionAsync(DeleteStreamingDistributionRequest request, AsyncHandler<DeleteStreamingDistributionRequest,DeleteStreamingDistributionResult> asyncHandler)
AmazonCloudFrontAsync
Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.
To delete an RTMP distribution using the CloudFront API:
Disable the RTMP distribution.
Submit a GET Streaming Distribution Config
request to get the current configuration and the
Etag
header for the distribution.
Update the XML document that was returned in the response to your GET Streaming Distribution Config
request to change the value of Enabled
to false
.
Submit a PUT Streaming Distribution Config
request to update the configuration for your
distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the
HTTP If-Match
header to the value of the ETag
header that CloudFront returned when you
submitted the GET Streaming Distribution Config
request in Step 2.
Review the response to the PUT Streaming Distribution Config
request to confirm that the
distribution was successfully disabled.
Submit a GET Streaming Distribution Config
request to confirm that your changes have propagated.
When propagation is complete, the value of Status
is Deployed
.
Submit a DELETE Streaming Distribution
request. Set the value of the HTTP If-Match
header to the value of the ETag
header that CloudFront returned when you submitted the
GET Streaming Distribution Config
request in Step 2.
Review the response to your DELETE Streaming Distribution
request to confirm that the distribution
was successfully deleted.
For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide.
deleteStreamingDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to delete a streaming distribution.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.public Future<GetCloudFrontOriginAccessIdentityResult> getCloudFrontOriginAccessIdentityAsync(GetCloudFrontOriginAccessIdentityRequest request)
AmazonCloudFrontAsync
Get the information about an origin access identity.
getCloudFrontOriginAccessIdentityAsync
in interface AmazonCloudFrontAsync
request
- The request to get an origin access identity's information.public Future<GetCloudFrontOriginAccessIdentityResult> getCloudFrontOriginAccessIdentityAsync(GetCloudFrontOriginAccessIdentityRequest request, AsyncHandler<GetCloudFrontOriginAccessIdentityRequest,GetCloudFrontOriginAccessIdentityResult> asyncHandler)
AmazonCloudFrontAsync
Get the information about an origin access identity.
getCloudFrontOriginAccessIdentityAsync
in interface AmazonCloudFrontAsync
request
- The request to get an origin access identity's information.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.public Future<GetCloudFrontOriginAccessIdentityConfigResult> getCloudFrontOriginAccessIdentityConfigAsync(GetCloudFrontOriginAccessIdentityConfigRequest request)
AmazonCloudFrontAsync
Get the configuration information about an origin access identity.
getCloudFrontOriginAccessIdentityConfigAsync
in interface AmazonCloudFrontAsync
request
- The origin access identity's configuration information. For more information, see
CloudFrontOriginAccessIdentityConfigComplexType.public Future<GetCloudFrontOriginAccessIdentityConfigResult> getCloudFrontOriginAccessIdentityConfigAsync(GetCloudFrontOriginAccessIdentityConfigRequest request, AsyncHandler<GetCloudFrontOriginAccessIdentityConfigRequest,GetCloudFrontOriginAccessIdentityConfigResult> asyncHandler)
AmazonCloudFrontAsync
Get the configuration information about an origin access identity.
getCloudFrontOriginAccessIdentityConfigAsync
in interface AmazonCloudFrontAsync
request
- The origin access identity's configuration information. For more information, see
CloudFrontOriginAccessIdentityConfigComplexType.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.public Future<GetDistributionResult> getDistributionAsync(GetDistributionRequest request)
AmazonCloudFrontAsync
Get the information about a distribution.
getDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to get a distribution's information.public Future<GetDistributionResult> getDistributionAsync(GetDistributionRequest request, AsyncHandler<GetDistributionRequest,GetDistributionResult> asyncHandler)
AmazonCloudFrontAsync
Get the information about a distribution.
getDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to get a distribution's information.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.public Future<GetDistributionConfigResult> getDistributionConfigAsync(GetDistributionConfigRequest request)
AmazonCloudFrontAsync
Get the configuration information about a distribution.
getDistributionConfigAsync
in interface AmazonCloudFrontAsync
request
- The request to get a distribution configuration.public Future<GetDistributionConfigResult> getDistributionConfigAsync(GetDistributionConfigRequest request, AsyncHandler<GetDistributionConfigRequest,GetDistributionConfigResult> asyncHandler)
AmazonCloudFrontAsync
Get the configuration information about a distribution.
getDistributionConfigAsync
in interface AmazonCloudFrontAsync
request
- The request to get a distribution configuration.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.public Future<GetInvalidationResult> getInvalidationAsync(GetInvalidationRequest request)
AmazonCloudFrontAsync
Get the information about an invalidation.
getInvalidationAsync
in interface AmazonCloudFrontAsync
request
- The request to get an invalidation's information.public Future<GetInvalidationResult> getInvalidationAsync(GetInvalidationRequest request, AsyncHandler<GetInvalidationRequest,GetInvalidationResult> asyncHandler)
AmazonCloudFrontAsync
Get the information about an invalidation.
getInvalidationAsync
in interface AmazonCloudFrontAsync
request
- The request to get an invalidation's information.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.public Future<GetStreamingDistributionResult> getStreamingDistributionAsync(GetStreamingDistributionRequest request)
AmazonCloudFrontAsync
Gets information about a specified RTMP distribution, including the distribution configuration.
getStreamingDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to get a streaming distribution's information.public Future<GetStreamingDistributionResult> getStreamingDistributionAsync(GetStreamingDistributionRequest request, AsyncHandler<GetStreamingDistributionRequest,GetStreamingDistributionResult> asyncHandler)
AmazonCloudFrontAsync
Gets information about a specified RTMP distribution, including the distribution configuration.
getStreamingDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to get a streaming distribution's information.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.public Future<GetStreamingDistributionConfigResult> getStreamingDistributionConfigAsync(GetStreamingDistributionConfigRequest request)
AmazonCloudFrontAsync
Get the configuration information about a streaming distribution.
getStreamingDistributionConfigAsync
in interface AmazonCloudFrontAsync
request
- To request to get a streaming distribution configuration.public Future<GetStreamingDistributionConfigResult> getStreamingDistributionConfigAsync(GetStreamingDistributionConfigRequest request, AsyncHandler<GetStreamingDistributionConfigRequest,GetStreamingDistributionConfigResult> asyncHandler)
AmazonCloudFrontAsync
Get the configuration information about a streaming distribution.
getStreamingDistributionConfigAsync
in interface AmazonCloudFrontAsync
request
- To request to get a streaming distribution configuration.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.public Future<ListCloudFrontOriginAccessIdentitiesResult> listCloudFrontOriginAccessIdentitiesAsync(ListCloudFrontOriginAccessIdentitiesRequest request)
AmazonCloudFrontAsync
Lists origin access identities.
listCloudFrontOriginAccessIdentitiesAsync
in interface AmazonCloudFrontAsync
request
- The request to list origin access identities.public Future<ListCloudFrontOriginAccessIdentitiesResult> listCloudFrontOriginAccessIdentitiesAsync(ListCloudFrontOriginAccessIdentitiesRequest request, AsyncHandler<ListCloudFrontOriginAccessIdentitiesRequest,ListCloudFrontOriginAccessIdentitiesResult> asyncHandler)
AmazonCloudFrontAsync
Lists origin access identities.
listCloudFrontOriginAccessIdentitiesAsync
in interface AmazonCloudFrontAsync
request
- The request to list origin access identities.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.public Future<ListDistributionsResult> listDistributionsAsync(ListDistributionsRequest request)
AmazonCloudFrontAsync
List distributions.
listDistributionsAsync
in interface AmazonCloudFrontAsync
request
- The request to list your distributions.public Future<ListDistributionsResult> listDistributionsAsync(ListDistributionsRequest request, AsyncHandler<ListDistributionsRequest,ListDistributionsResult> asyncHandler)
AmazonCloudFrontAsync
List distributions.
listDistributionsAsync
in interface AmazonCloudFrontAsync
request
- The request to list your distributions.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.public Future<ListDistributionsByWebACLIdResult> listDistributionsByWebACLIdAsync(ListDistributionsByWebACLIdRequest request)
AmazonCloudFrontAsync
List the distributions that are associated with a specified AWS WAF web ACL.
listDistributionsByWebACLIdAsync
in interface AmazonCloudFrontAsync
request
- The request to list distributions that are associated with a specified AWS WAF web ACL.public Future<ListDistributionsByWebACLIdResult> listDistributionsByWebACLIdAsync(ListDistributionsByWebACLIdRequest request, AsyncHandler<ListDistributionsByWebACLIdRequest,ListDistributionsByWebACLIdResult> asyncHandler)
AmazonCloudFrontAsync
List the distributions that are associated with a specified AWS WAF web ACL.
listDistributionsByWebACLIdAsync
in interface AmazonCloudFrontAsync
request
- The request to list distributions that are associated with a specified AWS WAF web ACL.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.public Future<ListInvalidationsResult> listInvalidationsAsync(ListInvalidationsRequest request)
AmazonCloudFrontAsync
Lists invalidation batches.
listInvalidationsAsync
in interface AmazonCloudFrontAsync
request
- The request to list invalidations.public Future<ListInvalidationsResult> listInvalidationsAsync(ListInvalidationsRequest request, AsyncHandler<ListInvalidationsRequest,ListInvalidationsResult> asyncHandler)
AmazonCloudFrontAsync
Lists invalidation batches.
listInvalidationsAsync
in interface AmazonCloudFrontAsync
request
- The request to list invalidations.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.public Future<ListStreamingDistributionsResult> listStreamingDistributionsAsync(ListStreamingDistributionsRequest request)
AmazonCloudFrontAsync
List streaming distributions.
listStreamingDistributionsAsync
in interface AmazonCloudFrontAsync
request
- The request to list your streaming distributions.public Future<ListStreamingDistributionsResult> listStreamingDistributionsAsync(ListStreamingDistributionsRequest request, AsyncHandler<ListStreamingDistributionsRequest,ListStreamingDistributionsResult> asyncHandler)
AmazonCloudFrontAsync
List streaming distributions.
listStreamingDistributionsAsync
in interface AmazonCloudFrontAsync
request
- The request to list your streaming distributions.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.public Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest request)
AmazonCloudFrontAsync
List tags for a CloudFront resource.
listTagsForResourceAsync
in interface AmazonCloudFrontAsync
request
- The request to list tags for a CloudFront resource.public Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest request, AsyncHandler<ListTagsForResourceRequest,ListTagsForResourceResult> asyncHandler)
AmazonCloudFrontAsync
List tags for a CloudFront resource.
listTagsForResourceAsync
in interface AmazonCloudFrontAsync
request
- The request to list tags for a CloudFront resource.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.public Future<TagResourceResult> tagResourceAsync(TagResourceRequest request)
AmazonCloudFrontAsync
Add tags to a CloudFront resource.
tagResourceAsync
in interface AmazonCloudFrontAsync
request
- The request to add tags to a CloudFront resource.public Future<TagResourceResult> tagResourceAsync(TagResourceRequest request, AsyncHandler<TagResourceRequest,TagResourceResult> asyncHandler)
AmazonCloudFrontAsync
Add tags to a CloudFront resource.
tagResourceAsync
in interface AmazonCloudFrontAsync
request
- The request to add tags to a CloudFront resource.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.public Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest request)
AmazonCloudFrontAsync
Remove tags from a CloudFront resource.
untagResourceAsync
in interface AmazonCloudFrontAsync
request
- The request to remove tags from a CloudFront resource.public Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest request, AsyncHandler<UntagResourceRequest,UntagResourceResult> asyncHandler)
AmazonCloudFrontAsync
Remove tags from a CloudFront resource.
untagResourceAsync
in interface AmazonCloudFrontAsync
request
- The request to remove tags from a CloudFront resource.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.public Future<UpdateCloudFrontOriginAccessIdentityResult> updateCloudFrontOriginAccessIdentityAsync(UpdateCloudFrontOriginAccessIdentityRequest request)
AmazonCloudFrontAsync
Update an origin access identity.
updateCloudFrontOriginAccessIdentityAsync
in interface AmazonCloudFrontAsync
request
- The request to update an origin access identity.public Future<UpdateCloudFrontOriginAccessIdentityResult> updateCloudFrontOriginAccessIdentityAsync(UpdateCloudFrontOriginAccessIdentityRequest request, AsyncHandler<UpdateCloudFrontOriginAccessIdentityRequest,UpdateCloudFrontOriginAccessIdentityResult> asyncHandler)
AmazonCloudFrontAsync
Update an origin access identity.
updateCloudFrontOriginAccessIdentityAsync
in interface AmazonCloudFrontAsync
request
- The request to update an origin access identity.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.public Future<UpdateDistributionResult> updateDistributionAsync(UpdateDistributionRequest request)
AmazonCloudFrontAsync
Updates the configuration for a web distribution. Perform the following steps.
For information about updating a distribution using the CloudFront console, see Creating or Updating a Web Distribution Using the CloudFront Console in the Amazon CloudFront Developer Guide.
To update a web distribution using the CloudFront API
Submit a GetDistributionConfig request to get the current configuration and an Etag
header
for the distribution.
If you update the distribution again, you need to get a new Etag
header.
Update the XML document that was returned in the response to your GetDistributionConfig
request to
include the desired changes. You can't change the value of CallerReference
. If you try to change
this value, CloudFront returns an IllegalUpdate
error.
The new configuration replaces the existing configuration; the values that you specify in an
UpdateDistribution
request are not merged into the existing configuration. When you add, delete, or
replace values in an element that allows multiple values (for example, CNAME
), you must specify all
of the values that you want to appear in the updated distribution. In addition, you must update the corresponding
Quantity
element.
Submit an UpdateDistribution
request to update the configuration for your distribution:
In the request body, include the XML document that you updated in Step 2. The request body must include an XML
document with a DistributionConfig
element.
Set the value of the HTTP If-Match
header to the value of the ETag
header that
CloudFront returned when you submitted the GetDistributionConfig
request in Step 1.
Review the response to the UpdateDistribution
request to confirm that the configuration was
successfully updated.
Optional: Submit a GetDistribution request to confirm that your changes have propagated. When propagation
is complete, the value of Status
is Deployed
.
Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML
document that you include in the request body when you create or update a distribution. With previous versions of
the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts
multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to
prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say
you're specifying in the Quantity
element and the number of values you're actually specifying.
updateDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to update a distribution.public Future<UpdateDistributionResult> updateDistributionAsync(UpdateDistributionRequest request, AsyncHandler<UpdateDistributionRequest,UpdateDistributionResult> asyncHandler)
AmazonCloudFrontAsync
Updates the configuration for a web distribution. Perform the following steps.
For information about updating a distribution using the CloudFront console, see Creating or Updating a Web Distribution Using the CloudFront Console in the Amazon CloudFront Developer Guide.
To update a web distribution using the CloudFront API
Submit a GetDistributionConfig request to get the current configuration and an Etag
header
for the distribution.
If you update the distribution again, you need to get a new Etag
header.
Update the XML document that was returned in the response to your GetDistributionConfig
request to
include the desired changes. You can't change the value of CallerReference
. If you try to change
this value, CloudFront returns an IllegalUpdate
error.
The new configuration replaces the existing configuration; the values that you specify in an
UpdateDistribution
request are not merged into the existing configuration. When you add, delete, or
replace values in an element that allows multiple values (for example, CNAME
), you must specify all
of the values that you want to appear in the updated distribution. In addition, you must update the corresponding
Quantity
element.
Submit an UpdateDistribution
request to update the configuration for your distribution:
In the request body, include the XML document that you updated in Step 2. The request body must include an XML
document with a DistributionConfig
element.
Set the value of the HTTP If-Match
header to the value of the ETag
header that
CloudFront returned when you submitted the GetDistributionConfig
request in Step 1.
Review the response to the UpdateDistribution
request to confirm that the configuration was
successfully updated.
Optional: Submit a GetDistribution request to confirm that your changes have propagated. When propagation
is complete, the value of Status
is Deployed
.
Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML
document that you include in the request body when you create or update a distribution. With previous versions of
the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts
multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to
prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say
you're specifying in the Quantity
element and the number of values you're actually specifying.
updateDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to update a distribution.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.public Future<UpdateStreamingDistributionResult> updateStreamingDistributionAsync(UpdateStreamingDistributionRequest request)
AmazonCloudFrontAsync
Update a streaming distribution.
updateStreamingDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to update a streaming distribution.public Future<UpdateStreamingDistributionResult> updateStreamingDistributionAsync(UpdateStreamingDistributionRequest request, AsyncHandler<UpdateStreamingDistributionRequest,UpdateStreamingDistributionResult> asyncHandler)
AmazonCloudFrontAsync
Update a streaming distribution.
updateStreamingDistributionAsync
in interface AmazonCloudFrontAsync
request
- The request to update a streaming distribution.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.public void shutdown()
getExecutorService().shutdown()
followed by getExecutorService().awaitTermination()
prior to
calling this method.shutdown
in interface AmazonCloudFront
shutdown
in class AmazonCloudFrontClient
Copyright © 2013 Amazon Web Services, Inc. All Rights Reserved.