public interface AmazonCloudFront
Modifier and Type | Method and Description |
---|---|
CreateCloudFrontOriginAccessIdentityResult |
createCloudFrontOriginAccessIdentity(CreateCloudFrontOriginAccessIdentityRequest createCloudFrontOriginAccessIdentityRequest)
Create a new origin access identity.
|
CreateDistributionResult |
createDistribution(CreateDistributionRequest createDistributionRequest)
Create a new distribution.
|
CreateInvalidationResult |
createInvalidation(CreateInvalidationRequest createInvalidationRequest)
Create a new invalidation.
|
CreateStreamingDistributionResult |
createStreamingDistribution(CreateStreamingDistributionRequest createStreamingDistributionRequest)
Create a new streaming distribution.
|
void |
deleteCloudFrontOriginAccessIdentity(DeleteCloudFrontOriginAccessIdentityRequest deleteCloudFrontOriginAccessIdentityRequest)
Delete an origin access identity.
|
void |
deleteDistribution(DeleteDistributionRequest deleteDistributionRequest)
Delete a distribution.
|
void |
deleteStreamingDistribution(DeleteStreamingDistributionRequest deleteStreamingDistributionRequest)
Delete a streaming distribution.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for
debugging issues where a service isn't acting as expected.
|
GetCloudFrontOriginAccessIdentityResult |
getCloudFrontOriginAccessIdentity(GetCloudFrontOriginAccessIdentityRequest getCloudFrontOriginAccessIdentityRequest)
Get the information about an origin access identity.
|
GetCloudFrontOriginAccessIdentityConfigResult |
getCloudFrontOriginAccessIdentityConfig(GetCloudFrontOriginAccessIdentityConfigRequest getCloudFrontOriginAccessIdentityConfigRequest)
Get the configuration information about an origin access identity.
|
GetDistributionResult |
getDistribution(GetDistributionRequest getDistributionRequest)
Get the information about a distribution.
|
GetDistributionConfigResult |
getDistributionConfig(GetDistributionConfigRequest getDistributionConfigRequest)
Get the configuration information about a distribution.
|
GetInvalidationResult |
getInvalidation(GetInvalidationRequest getInvalidationRequest)
Get the information about an invalidation.
|
GetStreamingDistributionResult |
getStreamingDistribution(GetStreamingDistributionRequest getStreamingDistributionRequest)
Get the information about a streaming distribution.
|
GetStreamingDistributionConfigResult |
getStreamingDistributionConfig(GetStreamingDistributionConfigRequest getStreamingDistributionConfigRequest)
Get the configuration information about a streaming distribution.
|
ListCloudFrontOriginAccessIdentitiesResult |
listCloudFrontOriginAccessIdentities(ListCloudFrontOriginAccessIdentitiesRequest listCloudFrontOriginAccessIdentitiesRequest)
List origin access identities.
|
ListDistributionsResult |
listDistributions(ListDistributionsRequest listDistributionsRequest)
List distributions.
|
ListInvalidationsResult |
listInvalidations(ListInvalidationsRequest listInvalidationsRequest)
List invalidation batches.
|
ListStreamingDistributionsResult |
listStreamingDistributions(ListStreamingDistributionsRequest listStreamingDistributionsRequest)
List streaming distributions.
|
void |
setEndpoint(String endpoint)
Overrides the default endpoint for this client ("https://cloudfront.amazonaws.com/").
|
void |
setRegion(Region region)
An alternative to
setEndpoint(String) , sets the
regional endpoint for this client's service calls. |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
UpdateCloudFrontOriginAccessIdentityResult |
updateCloudFrontOriginAccessIdentity(UpdateCloudFrontOriginAccessIdentityRequest updateCloudFrontOriginAccessIdentityRequest)
Update an origin access identity.
|
UpdateDistributionResult |
updateDistribution(UpdateDistributionRequest updateDistributionRequest)
Update a distribution.
|
UpdateStreamingDistributionResult |
updateStreamingDistribution(UpdateStreamingDistributionRequest updateStreamingDistributionRequest)
Update a streaming distribution.
|
void setEndpoint(String endpoint) throws IllegalArgumentException
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.
endpoint
- 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.IllegalArgumentException
- If any problems are detected with the specified endpoint.void setRegion(Region region) throws IllegalArgumentException
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.
region
- The region this client will communicate with. See
Region.getRegion(com.amazonaws.regions.Regions)
for
accessing a given region.IllegalArgumentException
- If the given region is null, or if this service isn't
available in the given region. See
Region.isServiceSupported(String)
Region.getRegion(com.amazonaws.regions.Regions)
,
Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
GetStreamingDistributionResult getStreamingDistribution(GetStreamingDistributionRequest getStreamingDistributionRequest) throws AmazonServiceException, AmazonClientException
Get the information about a streaming distribution.
getStreamingDistributionRequest
- Container for the necessary
parameters to execute the GetStreamingDistribution service method on
AmazonCloudFront.NoSuchStreamingDistributionException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.CreateStreamingDistributionResult createStreamingDistribution(CreateStreamingDistributionRequest createStreamingDistributionRequest) throws AmazonServiceException, AmazonClientException
Create a new streaming distribution.
createStreamingDistributionRequest
- Container for the necessary
parameters to execute the CreateStreamingDistribution service method
on AmazonCloudFront.TooManyTrustedSignersException
MissingBodyException
TooManyStreamingDistributionCNAMEsException
StreamingDistributionAlreadyExistsException
CNAMEAlreadyExistsException
AccessDeniedException
TooManyStreamingDistributionsException
InvalidArgumentException
InconsistentQuantitiesException
InvalidOriginAccessIdentityException
TrustedSignerDoesNotExistException
InvalidOriginException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.CreateCloudFrontOriginAccessIdentityResult createCloudFrontOriginAccessIdentity(CreateCloudFrontOriginAccessIdentityRequest createCloudFrontOriginAccessIdentityRequest) throws AmazonServiceException, AmazonClientException
Create a new origin access identity.
createCloudFrontOriginAccessIdentityRequest
- Container for the
necessary parameters to execute the
CreateCloudFrontOriginAccessIdentity service method on
AmazonCloudFront.TooManyCloudFrontOriginAccessIdentitiesException
MissingBodyException
InvalidArgumentException
InconsistentQuantitiesException
CloudFrontOriginAccessIdentityAlreadyExistsException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.GetStreamingDistributionConfigResult getStreamingDistributionConfig(GetStreamingDistributionConfigRequest getStreamingDistributionConfigRequest) throws AmazonServiceException, AmazonClientException
Get the configuration information about a streaming distribution.
getStreamingDistributionConfigRequest
- Container for the
necessary parameters to execute the GetStreamingDistributionConfig
service method on AmazonCloudFront.NoSuchStreamingDistributionException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.GetDistributionResult getDistribution(GetDistributionRequest getDistributionRequest) throws AmazonServiceException, AmazonClientException
Get the information about a distribution.
getDistributionRequest
- Container for the necessary parameters
to execute the GetDistribution service method on AmazonCloudFront.NoSuchDistributionException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.UpdateDistributionResult updateDistribution(UpdateDistributionRequest updateDistributionRequest) throws AmazonServiceException, AmazonClientException
Update a distribution.
updateDistributionRequest
- Container for the necessary
parameters to execute the UpdateDistribution service method on
AmazonCloudFront.TooManyCookieNamesInWhiteListException
InvalidGeoRestrictionParameterException
InvalidResponseCodeException
MissingBodyException
TooManyHeadersInForwardedValuesException
TooManyDistributionCNAMEsException
InvalidLocationCodeException
NoSuchOriginException
PreconditionFailedException
InvalidArgumentException
CNAMEAlreadyExistsException
InconsistentQuantitiesException
InvalidOriginAccessIdentityException
TooManyCacheBehaviorsException
TooManyTrustedSignersException
NoSuchDistributionException
InvalidViewerCertificateException
TooManyOriginsException
InvalidRequiredProtocolException
InvalidDefaultRootObjectException
InvalidIfMatchVersionException
IllegalUpdateException
InvalidForwardCookiesException
InvalidHeadersForS3OriginException
TrustedSignerDoesNotExistException
TooManyCertificatesException
InvalidMinimumProtocolVersionException
InvalidRelativePathException
InvalidErrorCodeException
AccessDeniedException
InvalidTTLOrderException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.ListStreamingDistributionsResult listStreamingDistributions(ListStreamingDistributionsRequest listStreamingDistributionsRequest) throws AmazonServiceException, AmazonClientException
List streaming distributions.
listStreamingDistributionsRequest
- Container for the necessary
parameters to execute the ListStreamingDistributions service method on
AmazonCloudFront.InvalidArgumentException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.GetInvalidationResult getInvalidation(GetInvalidationRequest getInvalidationRequest) throws AmazonServiceException, AmazonClientException
Get the information about an invalidation.
getInvalidationRequest
- Container for the necessary parameters
to execute the GetInvalidation service method on AmazonCloudFront.NoSuchInvalidationException
NoSuchDistributionException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.GetCloudFrontOriginAccessIdentityResult getCloudFrontOriginAccessIdentity(GetCloudFrontOriginAccessIdentityRequest getCloudFrontOriginAccessIdentityRequest) throws AmazonServiceException, AmazonClientException
Get the information about an origin access identity.
getCloudFrontOriginAccessIdentityRequest
- Container for the
necessary parameters to execute the GetCloudFrontOriginAccessIdentity
service method on AmazonCloudFront.NoSuchCloudFrontOriginAccessIdentityException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.GetDistributionConfigResult getDistributionConfig(GetDistributionConfigRequest getDistributionConfigRequest) throws AmazonServiceException, AmazonClientException
Get the configuration information about a distribution.
getDistributionConfigRequest
- Container for the necessary
parameters to execute the GetDistributionConfig service method on
AmazonCloudFront.NoSuchDistributionException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.UpdateStreamingDistributionResult updateStreamingDistribution(UpdateStreamingDistributionRequest updateStreamingDistributionRequest) throws AmazonServiceException, AmazonClientException
Update a streaming distribution.
updateStreamingDistributionRequest
- Container for the necessary
parameters to execute the UpdateStreamingDistribution service method
on AmazonCloudFront.InvalidIfMatchVersionException
IllegalUpdateException
MissingBodyException
PreconditionFailedException
InconsistentQuantitiesException
CNAMEAlreadyExistsException
InvalidArgumentException
InvalidOriginAccessIdentityException
TrustedSignerDoesNotExistException
TooManyTrustedSignersException
NoSuchStreamingDistributionException
TooManyStreamingDistributionCNAMEsException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.CreateDistributionResult createDistribution(CreateDistributionRequest createDistributionRequest) throws AmazonServiceException, AmazonClientException
Create a new distribution.
createDistributionRequest
- Container for the necessary
parameters to execute the CreateDistribution service method on
AmazonCloudFront.TooManyCookieNamesInWhiteListException
InvalidGeoRestrictionParameterException
InvalidResponseCodeException
TooManyHeadersInForwardedValuesException
MissingBodyException
TooManyDistributionCNAMEsException
InvalidLocationCodeException
TooManyDistributionsException
NoSuchOriginException
InvalidArgumentException
CNAMEAlreadyExistsException
InconsistentQuantitiesException
InvalidOriginAccessIdentityException
TooManyCacheBehaviorsException
TooManyTrustedSignersException
InvalidViewerCertificateException
TooManyOriginsException
DistributionAlreadyExistsException
InvalidRequiredProtocolException
InvalidDefaultRootObjectException
InvalidProtocolSettingsException
InvalidForwardCookiesException
InvalidHeadersForS3OriginException
TrustedSignerDoesNotExistException
InvalidOriginException
TooManyCertificatesException
InvalidRelativePathException
InvalidMinimumProtocolVersionException
InvalidErrorCodeException
AccessDeniedException
InvalidTTLOrderException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.CreateInvalidationResult createInvalidation(CreateInvalidationRequest createInvalidationRequest) throws AmazonServiceException, AmazonClientException
Create a new invalidation.
createInvalidationRequest
- Container for the necessary
parameters to execute the CreateInvalidation service method on
AmazonCloudFront.TooManyInvalidationsInProgressException
MissingBodyException
NoSuchDistributionException
BatchTooLargeException
AccessDeniedException
InvalidArgumentException
InconsistentQuantitiesException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.ListInvalidationsResult listInvalidations(ListInvalidationsRequest listInvalidationsRequest) throws AmazonServiceException, AmazonClientException
List invalidation batches.
listInvalidationsRequest
- Container for the necessary parameters
to execute the ListInvalidations service method on AmazonCloudFront.NoSuchDistributionException
InvalidArgumentException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.ListDistributionsResult listDistributions(ListDistributionsRequest listDistributionsRequest) throws AmazonServiceException, AmazonClientException
List distributions.
listDistributionsRequest
- Container for the necessary parameters
to execute the ListDistributions service method on AmazonCloudFront.InvalidArgumentException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.UpdateCloudFrontOriginAccessIdentityResult updateCloudFrontOriginAccessIdentity(UpdateCloudFrontOriginAccessIdentityRequest updateCloudFrontOriginAccessIdentityRequest) throws AmazonServiceException, AmazonClientException
Update an origin access identity.
updateCloudFrontOriginAccessIdentityRequest
- Container for the
necessary parameters to execute the
UpdateCloudFrontOriginAccessIdentity service method on
AmazonCloudFront.InvalidIfMatchVersionException
IllegalUpdateException
MissingBodyException
NoSuchCloudFrontOriginAccessIdentityException
PreconditionFailedException
AccessDeniedException
InvalidArgumentException
InconsistentQuantitiesException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.void deleteCloudFrontOriginAccessIdentity(DeleteCloudFrontOriginAccessIdentityRequest deleteCloudFrontOriginAccessIdentityRequest) throws AmazonServiceException, AmazonClientException
Delete an origin access identity.
deleteCloudFrontOriginAccessIdentityRequest
- Container for the
necessary parameters to execute the
DeleteCloudFrontOriginAccessIdentity service method on
AmazonCloudFront.InvalidIfMatchVersionException
CloudFrontOriginAccessIdentityInUseException
NoSuchCloudFrontOriginAccessIdentityException
PreconditionFailedException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.void deleteDistribution(DeleteDistributionRequest deleteDistributionRequest) throws AmazonServiceException, AmazonClientException
Delete a distribution.
deleteDistributionRequest
- Container for the necessary
parameters to execute the DeleteDistribution service method on
AmazonCloudFront.InvalidIfMatchVersionException
NoSuchDistributionException
DistributionNotDisabledException
PreconditionFailedException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.GetCloudFrontOriginAccessIdentityConfigResult getCloudFrontOriginAccessIdentityConfig(GetCloudFrontOriginAccessIdentityConfigRequest getCloudFrontOriginAccessIdentityConfigRequest) throws AmazonServiceException, AmazonClientException
Get the configuration information about an origin access identity.
getCloudFrontOriginAccessIdentityConfigRequest
- Container for
the necessary parameters to execute the
GetCloudFrontOriginAccessIdentityConfig service method on
AmazonCloudFront.NoSuchCloudFrontOriginAccessIdentityException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.void deleteStreamingDistribution(DeleteStreamingDistributionRequest deleteStreamingDistributionRequest) throws AmazonServiceException, AmazonClientException
Delete a streaming distribution.
deleteStreamingDistributionRequest
- Container for the necessary
parameters to execute the DeleteStreamingDistribution service method
on AmazonCloudFront.InvalidIfMatchVersionException
NoSuchStreamingDistributionException
StreamingDistributionNotDisabledException
PreconditionFailedException
AccessDeniedException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.ListCloudFrontOriginAccessIdentitiesResult listCloudFrontOriginAccessIdentities(ListCloudFrontOriginAccessIdentitiesRequest listCloudFrontOriginAccessIdentitiesRequest) throws AmazonServiceException, AmazonClientException
List origin access identities.
listCloudFrontOriginAccessIdentitiesRequest
- Container for the
necessary parameters to execute the
ListCloudFrontOriginAccessIdentities service method on
AmazonCloudFront.InvalidArgumentException
AmazonClientException
- If any internal errors are encountered inside the client while
attempting to make the request or handle the response. For example
if a network connection is not available.AmazonServiceException
- If an error response is returned by AmazonCloudFront indicating
either a problem with the data in the request, or a server side issue.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response 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.
request
- The originally executed request.Copyright © 2015. All rights reserved.