@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAmazonCloudFront extends Object implements AmazonCloudFront
AmazonCloudFront. Convenient method forms pass through to the corresponding
overload that takes a request object, which throws an UnsupportedOperationException.ENDPOINT_PREFIXpublic void setEndpoint(String endpoint)
AmazonCloudFront
Callers can pass in just the endpoint (ex: "cloudfront.amazonaws.com/") or a full URL, including the protocol
(ex: "https://cloudfront.amazonaws.com/"). If the protocol is not specified here, the default protocol from this
client's ClientConfiguration will be used, which by default is HTTPS.
For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912
This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
setEndpoint in interface AmazonCloudFrontendpoint - The endpoint (ex: "cloudfront.amazonaws.com/") or a full URL, including the protocol (ex:
"https://cloudfront.amazonaws.com/") of the region specific AWS endpoint this client will communicate
with.public void setRegion(Region region)
AmazonCloudFrontAmazonCloudFront.setEndpoint(String), sets the regional endpoint for this client's
service calls. Callers can use this method to control which AWS region they want to work with.
By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the
ClientConfiguration supplied at construction.
This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
setRegion in interface AmazonCloudFrontregion - The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions)
for accessing a given region. Must not be null and must be a region where the service is available.Region.getRegion(com.amazonaws.regions.Regions),
Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration),
Region.isServiceSupported(String)public CreateCloudFrontOriginAccessIdentityResult createCloudFrontOriginAccessIdentity(CreateCloudFrontOriginAccessIdentityRequest request)
AmazonCloudFrontCreates 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.
createCloudFrontOriginAccessIdentity in interface AmazonCloudFrontrequest - The request to create a new origin access identity.public CreateDistributionResult createDistribution(CreateDistributionRequest request)
AmazonCloudFront
Creates a new web distribution. Send a POST request to the
/CloudFront API version/distribution/distribution ID resource.
createDistribution in interface AmazonCloudFrontrequest - The request to create a new distribution.public CreateDistributionWithTagsResult createDistributionWithTags(CreateDistributionWithTagsRequest request)
AmazonCloudFrontCreate a new distribution with tags.
createDistributionWithTags in interface AmazonCloudFrontrequest - The request to create a new distribution with tags.public CreateInvalidationResult createInvalidation(CreateInvalidationRequest request)
AmazonCloudFrontCreate a new invalidation.
createInvalidation in interface AmazonCloudFrontrequest - The request to create an invalidation.public CreateStreamingDistributionResult createStreamingDistribution(CreateStreamingDistributionRequest request)
AmazonCloudFrontCreates 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.
createStreamingDistribution in interface AmazonCloudFrontrequest - The request to create a new streaming distribution.public CreateStreamingDistributionWithTagsResult createStreamingDistributionWithTags(CreateStreamingDistributionWithTagsRequest request)
AmazonCloudFrontCreate a new streaming distribution with tags.
createStreamingDistributionWithTags in interface AmazonCloudFrontrequest - The request to create a new streaming distribution with tags.public DeleteCloudFrontOriginAccessIdentityResult deleteCloudFrontOriginAccessIdentity(DeleteCloudFrontOriginAccessIdentityRequest request)
AmazonCloudFrontDelete an origin access identity.
deleteCloudFrontOriginAccessIdentity in interface AmazonCloudFrontrequest - Deletes a origin access identity.public DeleteDistributionResult deleteDistribution(DeleteDistributionRequest request)
AmazonCloudFrontDelete a distribution.
deleteDistribution in interface AmazonCloudFrontrequest - 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 DeleteServiceLinkedRoleResult deleteServiceLinkedRole(DeleteServiceLinkedRoleRequest request)
deleteServiceLinkedRole in interface AmazonCloudFrontpublic DeleteStreamingDistributionResult deleteStreamingDistribution(DeleteStreamingDistributionRequest request)
AmazonCloudFrontDelete 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.
deleteStreamingDistribution in interface AmazonCloudFrontrequest - The request to delete a streaming distribution.public GetCloudFrontOriginAccessIdentityResult getCloudFrontOriginAccessIdentity(GetCloudFrontOriginAccessIdentityRequest request)
AmazonCloudFrontGet the information about an origin access identity.
getCloudFrontOriginAccessIdentity in interface AmazonCloudFrontrequest - The request to get an origin access identity's information.public GetCloudFrontOriginAccessIdentityConfigResult getCloudFrontOriginAccessIdentityConfig(GetCloudFrontOriginAccessIdentityConfigRequest request)
AmazonCloudFrontGet the configuration information about an origin access identity.
getCloudFrontOriginAccessIdentityConfig in interface AmazonCloudFrontrequest - The origin access identity's configuration information. For more information, see
CloudFrontOriginAccessIdentityConfigComplexType.public GetDistributionResult getDistribution(GetDistributionRequest request)
AmazonCloudFrontGet the information about a distribution.
getDistribution in interface AmazonCloudFrontrequest - The request to get a distribution's information.public GetDistributionConfigResult getDistributionConfig(GetDistributionConfigRequest request)
AmazonCloudFrontGet the configuration information about a distribution.
getDistributionConfig in interface AmazonCloudFrontrequest - The request to get a distribution configuration.public GetInvalidationResult getInvalidation(GetInvalidationRequest request)
AmazonCloudFrontGet the information about an invalidation.
getInvalidation in interface AmazonCloudFrontrequest - The request to get an invalidation's information.public GetStreamingDistributionResult getStreamingDistribution(GetStreamingDistributionRequest request)
AmazonCloudFrontGets information about a specified RTMP distribution, including the distribution configuration.
getStreamingDistribution in interface AmazonCloudFrontrequest - The request to get a streaming distribution's information.public GetStreamingDistributionConfigResult getStreamingDistributionConfig(GetStreamingDistributionConfigRequest request)
AmazonCloudFrontGet the configuration information about a streaming distribution.
getStreamingDistributionConfig in interface AmazonCloudFrontrequest - To request to get a streaming distribution configuration.public ListCloudFrontOriginAccessIdentitiesResult listCloudFrontOriginAccessIdentities(ListCloudFrontOriginAccessIdentitiesRequest request)
AmazonCloudFrontLists origin access identities.
listCloudFrontOriginAccessIdentities in interface AmazonCloudFrontrequest - The request to list origin access identities.public ListDistributionsResult listDistributions(ListDistributionsRequest request)
AmazonCloudFrontList distributions.
listDistributions in interface AmazonCloudFrontrequest - The request to list your distributions.public ListDistributionsByWebACLIdResult listDistributionsByWebACLId(ListDistributionsByWebACLIdRequest request)
AmazonCloudFrontList the distributions that are associated with a specified AWS WAF web ACL.
listDistributionsByWebACLId in interface AmazonCloudFrontrequest - The request to list distributions that are associated with a specified AWS WAF web ACL.public ListInvalidationsResult listInvalidations(ListInvalidationsRequest request)
AmazonCloudFrontLists invalidation batches.
listInvalidations in interface AmazonCloudFrontrequest - The request to list invalidations.public ListStreamingDistributionsResult listStreamingDistributions(ListStreamingDistributionsRequest request)
AmazonCloudFrontList streaming distributions.
listStreamingDistributions in interface AmazonCloudFrontrequest - The request to list your streaming distributions.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
AmazonCloudFrontList tags for a CloudFront resource.
listTagsForResource in interface AmazonCloudFrontrequest - The request to list tags for a CloudFront resource.public TagResourceResult tagResource(TagResourceRequest request)
AmazonCloudFrontAdd tags to a CloudFront resource.
tagResource in interface AmazonCloudFrontrequest - The request to add tags to a CloudFront resource.public UntagResourceResult untagResource(UntagResourceRequest request)
AmazonCloudFrontRemove tags from a CloudFront resource.
untagResource in interface AmazonCloudFrontrequest - The request to remove tags from a CloudFront resource.public UpdateCloudFrontOriginAccessIdentityResult updateCloudFrontOriginAccessIdentity(UpdateCloudFrontOriginAccessIdentityRequest request)
AmazonCloudFrontUpdate an origin access identity.
updateCloudFrontOriginAccessIdentity in interface AmazonCloudFrontrequest - The request to update an origin access identity.public UpdateDistributionResult updateDistribution(UpdateDistributionRequest request)
AmazonCloudFrontUpdates 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.
updateDistribution in interface AmazonCloudFrontrequest - The request to update a distribution.public UpdateStreamingDistributionResult updateStreamingDistribution(UpdateStreamingDistributionRequest request)
AmazonCloudFrontUpdate a streaming distribution.
updateStreamingDistribution in interface AmazonCloudFrontrequest - The request to update a streaming distribution.public void shutdown()
AmazonCloudFrontshutdown in interface AmazonCloudFrontpublic ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonCloudFrontResponse metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata in interface AmazonCloudFrontrequest - The originally executed request.public AmazonCloudFrontWaiters waiters()
waiters in interface AmazonCloudFrontCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.