public interface AmazonCloudFront
void setEndpoint(String endpoint)
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.void setRegion(Region region)
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. 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)CreateCloudFrontOriginAccessIdentityResult createCloudFrontOriginAccessIdentity(CreateCloudFrontOriginAccessIdentityRequest createCloudFrontOriginAccessIdentityRequest)
createCloudFrontOriginAccessIdentityRequest - CloudFrontOriginAccessIdentityAlreadyExistsException - If the CallerReference is a value you already sent in a previous
request to create an identity but the content of the
CloudFrontOriginAccessIdentityConfig is different from the
original request, CloudFront returns a
CloudFrontOriginAccessIdentityAlreadyExists error.MissingBodyException - This operation requires a body. Ensure that the body is present
and the Content-Type header is set.TooManyCloudFrontOriginAccessIdentitiesException - Processing your request would cause you to exceed the maximum
number of origin access identities allowed.InvalidArgumentException - The argument is invalid.InconsistentQuantitiesException - The value of Quantity and the size of Items do not match.CreateDistributionResult createDistribution(CreateDistributionRequest createDistributionRequest)
createDistributionRequest - CNAMEAlreadyExistsExceptionDistributionAlreadyExistsException - The caller reference you attempted to create the distribution
with is associated with another distribution.InvalidOriginException - The Amazon S3 origin server specified does not refer to a valid
Amazon S3 bucket.InvalidOriginAccessIdentityException - The origin access identity is not valid or doesn't exist.AccessDeniedException - Access denied.TooManyTrustedSignersException - Your request contains more trusted signers than are allowed per
distribution.TrustedSignerDoesNotExistException - One or more of your trusted signers do not exist.InvalidViewerCertificateExceptionInvalidMinimumProtocolVersionExceptionMissingBodyException - This operation requires a body. Ensure that the body is present
and the Content-Type header is set.TooManyDistributionCNAMEsException - Your request contains more CNAMEs than are allowed per
distribution.TooManyDistributionsException - Processing your request would cause you to exceed the maximum
number of distributions allowed.InvalidDefaultRootObjectException - The default root object file name is too big or contains an
invalid character.InvalidRelativePathException - The relative path is too big, is not URL-encoded, or does not
begin with a slash (/).InvalidErrorCodeExceptionInvalidResponseCodeExceptionInvalidArgumentException - The argument is invalid.InvalidRequiredProtocolException - This operation requires the HTTPS protocol. Ensure that you
specify the HTTPS protocol in your request, or omit the
RequiredProtocols element from your distribution configuration.NoSuchOriginException - No origin exists with the specified Origin Id.TooManyOriginsException - You cannot create anymore origins for the distribution.TooManyCacheBehaviorsException - You cannot create anymore cache behaviors for the distribution.TooManyCookieNamesInWhiteListException - Your request contains more cookie names in the whitelist than are
allowed per cache behavior.InvalidForwardCookiesException - Your request contains forward cookies option which doesn't match
with the expectation for the whitelisted list of cookie names.
Either list of cookie names has been specified when not allowed
or list of cookie names is missing when expected.TooManyHeadersInForwardedValuesExceptionInvalidHeadersForS3OriginExceptionInconsistentQuantitiesException - The value of Quantity and the size of Items do not match.TooManyCertificatesException - You cannot create anymore custom ssl certificates.InvalidLocationCodeExceptionInvalidGeoRestrictionParameterExceptionInvalidProtocolSettingsException - You cannot specify SSLv3 as the minimum protocol version if you
only want to support only clients that Support Server Name
Indication (SNI).InvalidTTLOrderExceptionInvalidWebACLIdExceptionTooManyOriginCustomHeadersExceptionCreateInvalidationResult createInvalidation(CreateInvalidationRequest createInvalidationRequest)
createInvalidationRequest - AccessDeniedException - Access denied.MissingBodyException - This operation requires a body. Ensure that the body is present
and the Content-Type header is set.InvalidArgumentException - The argument is invalid.NoSuchDistributionException - The specified distribution does not exist.BatchTooLargeExceptionTooManyInvalidationsInProgressException - You have exceeded the maximum number of allowable InProgress
invalidation batch requests, or invalidation objects.InconsistentQuantitiesException - The value of Quantity and the size of Items do not match.CreateStreamingDistributionResult createStreamingDistribution(CreateStreamingDistributionRequest createStreamingDistributionRequest)
createStreamingDistributionRequest - CNAMEAlreadyExistsExceptionStreamingDistributionAlreadyExistsExceptionInvalidOriginException - The Amazon S3 origin server specified does not refer to a valid
Amazon S3 bucket.InvalidOriginAccessIdentityException - The origin access identity is not valid or doesn't exist.AccessDeniedException - Access denied.TooManyTrustedSignersException - Your request contains more trusted signers than are allowed per
distribution.TrustedSignerDoesNotExistException - One or more of your trusted signers do not exist.MissingBodyException - This operation requires a body. Ensure that the body is present
and the Content-Type header is set.TooManyStreamingDistributionCNAMEsExceptionTooManyStreamingDistributionsException - Processing your request would cause you to exceed the maximum
number of streaming distributions allowed.InvalidArgumentException - The argument is invalid.InconsistentQuantitiesException - The value of Quantity and the size of Items do not match.void deleteCloudFrontOriginAccessIdentity(DeleteCloudFrontOriginAccessIdentityRequest deleteCloudFrontOriginAccessIdentityRequest)
deleteCloudFrontOriginAccessIdentityRequest - AccessDeniedException - Access denied.InvalidIfMatchVersionException - The If-Match version is missing or not valid for the
distribution.NoSuchCloudFrontOriginAccessIdentityException - The specified origin access identity does not exist.PreconditionFailedException - The precondition given in one or more of the request-header
fields evaluated to false.CloudFrontOriginAccessIdentityInUseExceptionvoid deleteDistribution(DeleteDistributionRequest deleteDistributionRequest)
deleteDistributionRequest - AccessDeniedException - Access denied.DistributionNotDisabledExceptionInvalidIfMatchVersionException - The If-Match version is missing or not valid for the
distribution.NoSuchDistributionException - The specified distribution does not exist.PreconditionFailedException - The precondition given in one or more of the request-header
fields evaluated to false.void deleteStreamingDistribution(DeleteStreamingDistributionRequest deleteStreamingDistributionRequest)
deleteStreamingDistributionRequest - AccessDeniedException - Access denied.StreamingDistributionNotDisabledExceptionInvalidIfMatchVersionException - The If-Match version is missing or not valid for the
distribution.NoSuchStreamingDistributionException - The specified streaming distribution does not exist.PreconditionFailedException - The precondition given in one or more of the request-header
fields evaluated to false.GetCloudFrontOriginAccessIdentityResult getCloudFrontOriginAccessIdentity(GetCloudFrontOriginAccessIdentityRequest getCloudFrontOriginAccessIdentityRequest)
getCloudFrontOriginAccessIdentityRequest - NoSuchCloudFrontOriginAccessIdentityException - The specified origin access identity does not exist.AccessDeniedException - Access denied.GetCloudFrontOriginAccessIdentityConfigResult getCloudFrontOriginAccessIdentityConfig(GetCloudFrontOriginAccessIdentityConfigRequest getCloudFrontOriginAccessIdentityConfigRequest)
getCloudFrontOriginAccessIdentityConfigRequest - NoSuchCloudFrontOriginAccessIdentityException - The specified origin access identity does not exist.AccessDeniedException - Access denied.GetDistributionResult getDistribution(GetDistributionRequest getDistributionRequest)
getDistributionRequest - NoSuchDistributionException - The specified distribution does not exist.AccessDeniedException - Access denied.GetDistributionConfigResult getDistributionConfig(GetDistributionConfigRequest getDistributionConfigRequest)
getDistributionConfigRequest - NoSuchDistributionException - The specified distribution does not exist.AccessDeniedException - Access denied.GetInvalidationResult getInvalidation(GetInvalidationRequest getInvalidationRequest)
getInvalidationRequest - NoSuchInvalidationException - The specified invalidation does not exist.NoSuchDistributionException - The specified distribution does not exist.AccessDeniedException - Access denied.GetStreamingDistributionResult getStreamingDistribution(GetStreamingDistributionRequest getStreamingDistributionRequest)
getStreamingDistributionRequest - NoSuchStreamingDistributionException - The specified streaming distribution does not exist.AccessDeniedException - Access denied.GetStreamingDistributionConfigResult getStreamingDistributionConfig(GetStreamingDistributionConfigRequest getStreamingDistributionConfigRequest)
getStreamingDistributionConfigRequest - NoSuchStreamingDistributionException - The specified streaming distribution does not exist.AccessDeniedException - Access denied.ListCloudFrontOriginAccessIdentitiesResult listCloudFrontOriginAccessIdentities(ListCloudFrontOriginAccessIdentitiesRequest listCloudFrontOriginAccessIdentitiesRequest)
listCloudFrontOriginAccessIdentitiesRequest - InvalidArgumentException - The argument is invalid.ListDistributionsResult listDistributions(ListDistributionsRequest listDistributionsRequest)
listDistributionsRequest - InvalidArgumentException - The argument is invalid.ListDistributionsByWebACLIdResult listDistributionsByWebACLId(ListDistributionsByWebACLIdRequest listDistributionsByWebACLIdRequest)
listDistributionsByWebACLIdRequest - InvalidArgumentException - The argument is invalid.InvalidWebACLIdExceptionListInvalidationsResult listInvalidations(ListInvalidationsRequest listInvalidationsRequest)
listInvalidationsRequest - InvalidArgumentException - The argument is invalid.NoSuchDistributionException - The specified distribution does not exist.AccessDeniedException - Access denied.ListStreamingDistributionsResult listStreamingDistributions(ListStreamingDistributionsRequest listStreamingDistributionsRequest)
listStreamingDistributionsRequest - InvalidArgumentException - The argument is invalid.UpdateCloudFrontOriginAccessIdentityResult updateCloudFrontOriginAccessIdentity(UpdateCloudFrontOriginAccessIdentityRequest updateCloudFrontOriginAccessIdentityRequest)
updateCloudFrontOriginAccessIdentityRequest - AccessDeniedException - Access denied.IllegalUpdateException - Origin and CallerReference cannot be updated.InvalidIfMatchVersionException - The If-Match version is missing or not valid for the
distribution.MissingBodyException - This operation requires a body. Ensure that the body is present
and the Content-Type header is set.NoSuchCloudFrontOriginAccessIdentityException - The specified origin access identity does not exist.PreconditionFailedException - The precondition given in one or more of the request-header
fields evaluated to false.InvalidArgumentException - The argument is invalid.InconsistentQuantitiesException - The value of Quantity and the size of Items do not match.UpdateDistributionResult updateDistribution(UpdateDistributionRequest updateDistributionRequest)
updateDistributionRequest - AccessDeniedException - Access denied.CNAMEAlreadyExistsExceptionIllegalUpdateException - Origin and CallerReference cannot be updated.InvalidIfMatchVersionException - The If-Match version is missing or not valid for the
distribution.MissingBodyException - This operation requires a body. Ensure that the body is present
and the Content-Type header is set.NoSuchDistributionException - The specified distribution does not exist.PreconditionFailedException - The precondition given in one or more of the request-header
fields evaluated to false.TooManyDistributionCNAMEsException - Your request contains more CNAMEs than are allowed per
distribution.InvalidDefaultRootObjectException - The default root object file name is too big or contains an
invalid character.InvalidRelativePathException - The relative path is too big, is not URL-encoded, or does not
begin with a slash (/).InvalidErrorCodeExceptionInvalidResponseCodeExceptionInvalidArgumentException - The argument is invalid.InvalidOriginAccessIdentityException - The origin access identity is not valid or doesn't exist.TooManyTrustedSignersException - Your request contains more trusted signers than are allowed per
distribution.TrustedSignerDoesNotExistException - One or more of your trusted signers do not exist.InvalidViewerCertificateExceptionInvalidMinimumProtocolVersionExceptionInvalidRequiredProtocolException - This operation requires the HTTPS protocol. Ensure that you
specify the HTTPS protocol in your request, or omit the
RequiredProtocols element from your distribution configuration.NoSuchOriginException - No origin exists with the specified Origin Id.TooManyOriginsException - You cannot create anymore origins for the distribution.TooManyCacheBehaviorsException - You cannot create anymore cache behaviors for the distribution.TooManyCookieNamesInWhiteListException - Your request contains more cookie names in the whitelist than are
allowed per cache behavior.InvalidForwardCookiesException - Your request contains forward cookies option which doesn't match
with the expectation for the whitelisted list of cookie names.
Either list of cookie names has been specified when not allowed
or list of cookie names is missing when expected.TooManyHeadersInForwardedValuesExceptionInvalidHeadersForS3OriginExceptionInconsistentQuantitiesException - The value of Quantity and the size of Items do not match.TooManyCertificatesException - You cannot create anymore custom ssl certificates.InvalidLocationCodeExceptionInvalidGeoRestrictionParameterExceptionInvalidTTLOrderExceptionInvalidWebACLIdExceptionTooManyOriginCustomHeadersExceptionUpdateStreamingDistributionResult updateStreamingDistribution(UpdateStreamingDistributionRequest updateStreamingDistributionRequest)
updateStreamingDistributionRequest - AccessDeniedException - Access denied.CNAMEAlreadyExistsExceptionIllegalUpdateException - Origin and CallerReference cannot be updated.InvalidIfMatchVersionException - The If-Match version is missing or not valid for the
distribution.MissingBodyException - This operation requires a body. Ensure that the body is present
and the Content-Type header is set.NoSuchStreamingDistributionException - The specified streaming distribution does not exist.PreconditionFailedException - The precondition given in one or more of the request-header
fields evaluated to false.TooManyStreamingDistributionCNAMEsExceptionInvalidArgumentException - The argument is invalid.InvalidOriginAccessIdentityException - The origin access identity is not valid or doesn't exist.TooManyTrustedSignersException - Your request contains more trusted signers than are allowed per
distribution.TrustedSignerDoesNotExistException - One or more of your trusted signers do not exist.InconsistentQuantitiesException - The value of Quantity and the size of Items do not match.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 © 2013 Amazon Web Services, Inc. All Rights Reserved.