@ThreadSafe public class AmazonCloudFrontClient extends AmazonWebServiceClient implements AmazonCloudFront
LOGGING_AWS_REQUEST_METRIC
Constructor and Description |
---|
AmazonCloudFrontClient()
Constructs a new client to invoke service methods on CloudFront.
|
AmazonCloudFrontClient(AWSCredentials awsCredentials)
Constructs a new client to invoke service methods on CloudFront using the
specified AWS account credentials.
|
AmazonCloudFrontClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on CloudFront using the
specified AWS account credentials and client configuration options.
|
AmazonCloudFrontClient(AWSCredentialsProvider awsCredentialsProvider)
Constructs a new client to invoke service methods on CloudFront using the
specified AWS account credentials provider.
|
AmazonCloudFrontClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on CloudFront using the
specified AWS account credentials provider and client configuration
options.
|
AmazonCloudFrontClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
Constructs a new client to invoke service methods on CloudFront using the
specified AWS account credentials provider, client configuration options,
and request metric collector.
|
AmazonCloudFrontClient(ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on CloudFront.
|
addRequestHandler, addRequestHandler, configureRegion, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerRegionOverride, getTimeOffset, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
setEndpoint, setRegion, shutdown
public AmazonCloudFrontClient()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain
public AmazonCloudFrontClient(ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration
- The client configuration options controlling how this client
connects to CloudFront (ex: proxy settings, retry counts, etc.).DefaultAWSCredentialsProviderChain
public AmazonCloudFrontClient(AWSCredentials awsCredentials)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when
authenticating with AWS services.public AmazonCloudFrontClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when
authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this client
connects to CloudFront (ex: proxy settings, retry counts, etc.).public AmazonCloudFrontClient(AWSCredentialsProvider awsCredentialsProvider)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to
authenticate requests with AWS services.public AmazonCloudFrontClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to
authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client
connects to CloudFront (ex: proxy settings, retry counts, etc.).public AmazonCloudFrontClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to
authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client
connects to CloudFront (ex: proxy settings, retry counts, etc.).requestMetricCollector
- optional request metric collectorpublic CreateCloudFrontOriginAccessIdentityResult createCloudFrontOriginAccessIdentity(CreateCloudFrontOriginAccessIdentityRequest createCloudFrontOriginAccessIdentityRequest)
createCloudFrontOriginAccessIdentity
in interface AmazonCloudFront
createCloudFrontOriginAccessIdentityRequest
- The request to create a new origin access identity.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.public CreateDistributionResult createDistribution(CreateDistributionRequest createDistributionRequest)
createDistribution
in interface AmazonCloudFront
createDistributionRequest
- The request to create a new distribution.CNAMEAlreadyExistsException
DistributionAlreadyExistsException
- 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.InvalidViewerCertificateException
InvalidMinimumProtocolVersionException
MissingBodyException
- 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 (/).InvalidErrorCodeException
InvalidResponseCodeException
InvalidArgumentException
- 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.TooManyHeadersInForwardedValuesException
InvalidHeadersForS3OriginException
InconsistentQuantitiesException
- The value of Quantity and the size of Items do not match.TooManyCertificatesException
- You cannot create anymore custom ssl certificates.InvalidLocationCodeException
InvalidGeoRestrictionParameterException
InvalidProtocolSettingsException
- You cannot specify SSLv3 as the minimum protocol version if you
only want to support only clients that Support Server Name
Indication (SNI).InvalidTTLOrderException
InvalidWebACLIdException
TooManyOriginCustomHeadersException
public CreateInvalidationResult createInvalidation(CreateInvalidationRequest createInvalidationRequest)
createInvalidation
in interface AmazonCloudFront
createInvalidationRequest
- The request to create an invalidation.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.BatchTooLargeException
TooManyInvalidationsInProgressException
- 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.public CreateStreamingDistributionResult createStreamingDistribution(CreateStreamingDistributionRequest createStreamingDistributionRequest)
createStreamingDistribution
in interface AmazonCloudFront
createStreamingDistributionRequest
- The request to create a new streaming distribution.CNAMEAlreadyExistsException
StreamingDistributionAlreadyExistsException
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.MissingBodyException
- This operation requires a body. Ensure that the body is present
and the Content-Type header is set.TooManyStreamingDistributionCNAMEsException
TooManyStreamingDistributionsException
- 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.public void deleteCloudFrontOriginAccessIdentity(DeleteCloudFrontOriginAccessIdentityRequest deleteCloudFrontOriginAccessIdentityRequest)
deleteCloudFrontOriginAccessIdentity
in interface AmazonCloudFront
deleteCloudFrontOriginAccessIdentityRequest
- The request to delete a origin access identity.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.CloudFrontOriginAccessIdentityInUseException
public void deleteDistribution(DeleteDistributionRequest deleteDistributionRequest)
deleteDistribution
in interface AmazonCloudFront
deleteDistributionRequest
- The request to delete a distribution.AccessDeniedException
- Access denied.DistributionNotDisabledException
InvalidIfMatchVersionException
- 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.public void deleteStreamingDistribution(DeleteStreamingDistributionRequest deleteStreamingDistributionRequest)
deleteStreamingDistribution
in interface AmazonCloudFront
deleteStreamingDistributionRequest
- The request to delete a streaming distribution.AccessDeniedException
- Access denied.StreamingDistributionNotDisabledException
InvalidIfMatchVersionException
- 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.public GetCloudFrontOriginAccessIdentityResult getCloudFrontOriginAccessIdentity(GetCloudFrontOriginAccessIdentityRequest getCloudFrontOriginAccessIdentityRequest)
getCloudFrontOriginAccessIdentity
in interface AmazonCloudFront
getCloudFrontOriginAccessIdentityRequest
- The request to get an origin access identity's information.NoSuchCloudFrontOriginAccessIdentityException
- The specified origin access identity does not exist.AccessDeniedException
- Access denied.public GetCloudFrontOriginAccessIdentityConfigResult getCloudFrontOriginAccessIdentityConfig(GetCloudFrontOriginAccessIdentityConfigRequest getCloudFrontOriginAccessIdentityConfigRequest)
getCloudFrontOriginAccessIdentityConfig
in interface AmazonCloudFront
getCloudFrontOriginAccessIdentityConfigRequest
- The request to get an origin access identity's configuration.NoSuchCloudFrontOriginAccessIdentityException
- The specified origin access identity does not exist.AccessDeniedException
- Access denied.public GetDistributionResult getDistribution(GetDistributionRequest getDistributionRequest)
getDistribution
in interface AmazonCloudFront
getDistributionRequest
- The request to get a distribution's information.NoSuchDistributionException
- The specified distribution does not exist.AccessDeniedException
- Access denied.public GetDistributionConfigResult getDistributionConfig(GetDistributionConfigRequest getDistributionConfigRequest)
getDistributionConfig
in interface AmazonCloudFront
getDistributionConfigRequest
- The request to get a distribution configuration.NoSuchDistributionException
- The specified distribution does not exist.AccessDeniedException
- Access denied.public GetInvalidationResult getInvalidation(GetInvalidationRequest getInvalidationRequest)
getInvalidation
in interface AmazonCloudFront
getInvalidationRequest
- The request to get an invalidation's information.NoSuchInvalidationException
- The specified invalidation does not exist.NoSuchDistributionException
- The specified distribution does not exist.AccessDeniedException
- Access denied.public GetStreamingDistributionResult getStreamingDistribution(GetStreamingDistributionRequest getStreamingDistributionRequest)
getStreamingDistribution
in interface AmazonCloudFront
getStreamingDistributionRequest
- The request to get a streaming distribution's information.NoSuchStreamingDistributionException
- The specified streaming distribution does not exist.AccessDeniedException
- Access denied.public GetStreamingDistributionConfigResult getStreamingDistributionConfig(GetStreamingDistributionConfigRequest getStreamingDistributionConfigRequest)
getStreamingDistributionConfig
in interface AmazonCloudFront
getStreamingDistributionConfigRequest
- To request to get a streaming distribution configuration.NoSuchStreamingDistributionException
- The specified streaming distribution does not exist.AccessDeniedException
- Access denied.public ListCloudFrontOriginAccessIdentitiesResult listCloudFrontOriginAccessIdentities(ListCloudFrontOriginAccessIdentitiesRequest listCloudFrontOriginAccessIdentitiesRequest)
listCloudFrontOriginAccessIdentities
in interface AmazonCloudFront
listCloudFrontOriginAccessIdentitiesRequest
- The request to list origin access identities.InvalidArgumentException
- The argument is invalid.public ListDistributionsResult listDistributions(ListDistributionsRequest listDistributionsRequest)
listDistributions
in interface AmazonCloudFront
listDistributionsRequest
- The request to list your distributions.InvalidArgumentException
- The argument is invalid.public ListDistributionsByWebACLIdResult listDistributionsByWebACLId(ListDistributionsByWebACLIdRequest listDistributionsByWebACLIdRequest)
listDistributionsByWebACLId
in interface AmazonCloudFront
listDistributionsByWebACLIdRequest
- The request to list distributions that are associated with a
specified AWS WAF web ACL.InvalidArgumentException
- The argument is invalid.InvalidWebACLIdException
public ListInvalidationsResult listInvalidations(ListInvalidationsRequest listInvalidationsRequest)
listInvalidations
in interface AmazonCloudFront
listInvalidationsRequest
- The request to list invalidations.InvalidArgumentException
- The argument is invalid.NoSuchDistributionException
- The specified distribution does not exist.AccessDeniedException
- Access denied.public ListStreamingDistributionsResult listStreamingDistributions(ListStreamingDistributionsRequest listStreamingDistributionsRequest)
listStreamingDistributions
in interface AmazonCloudFront
listStreamingDistributionsRequest
- The request to list your streaming distributions.InvalidArgumentException
- The argument is invalid.public UpdateCloudFrontOriginAccessIdentityResult updateCloudFrontOriginAccessIdentity(UpdateCloudFrontOriginAccessIdentityRequest updateCloudFrontOriginAccessIdentityRequest)
updateCloudFrontOriginAccessIdentity
in interface AmazonCloudFront
updateCloudFrontOriginAccessIdentityRequest
- The request to update an origin access identity.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.public UpdateDistributionResult updateDistribution(UpdateDistributionRequest updateDistributionRequest)
updateDistribution
in interface AmazonCloudFront
updateDistributionRequest
- The request to update a distribution.AccessDeniedException
- Access denied.CNAMEAlreadyExistsException
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.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 (/).InvalidErrorCodeException
InvalidResponseCodeException
InvalidArgumentException
- 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.InvalidViewerCertificateException
InvalidMinimumProtocolVersionException
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.TooManyHeadersInForwardedValuesException
InvalidHeadersForS3OriginException
InconsistentQuantitiesException
- The value of Quantity and the size of Items do not match.TooManyCertificatesException
- You cannot create anymore custom ssl certificates.InvalidLocationCodeException
InvalidGeoRestrictionParameterException
InvalidTTLOrderException
InvalidWebACLIdException
TooManyOriginCustomHeadersException
public UpdateStreamingDistributionResult updateStreamingDistribution(UpdateStreamingDistributionRequest updateStreamingDistributionRequest)
updateStreamingDistribution
in interface AmazonCloudFront
updateStreamingDistributionRequest
- The request to update a streaming distribution.AccessDeniedException
- Access denied.CNAMEAlreadyExistsException
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.NoSuchStreamingDistributionException
- The specified streaming distribution does not exist.PreconditionFailedException
- The precondition given in one or more of the request-header
fields evaluated to false.TooManyStreamingDistributionCNAMEsException
InvalidArgumentException
- 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.public 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 the request.
getCachedResponseMetadata
in interface AmazonCloudFront
request
- The originally executed requestCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.