[−][src]Crate rusoto_cloudfront
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.
If you're using the service, you're probably looking for CloudFrontClient and CloudFront.
Structs
ActiveTrustedSigners | A complex type that lists the AWS accounts, if any, that you included in the The For more information, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide. |
AliasListSerializer | |
Aliases | A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution. |
AliasesSerializer | |
AllowedMethods | A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices:
If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. |
AllowedMethodsSerializer | |
AwsAccountNumberListSerializer | |
BooleanSerializer | |
CacheBehavior | A complex type that describes how CloudFront processes requests. You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to distribute objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin is never used. For the current limit on the number of cache behaviors that you can add to a distribution, see Amazon CloudFront Limits in the AWS General Reference. If you don't want to specify any cache behaviors, include only an empty To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution. For more information about cache behaviors, see Cache Behaviors in the Amazon CloudFront Developer Guide. |
CacheBehaviorListSerializer | |
CacheBehaviorSerializer | |
CacheBehaviors | A complex type that contains zero or more |
CacheBehaviorsSerializer | |
CachedMethods | A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices:
If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. |
CachedMethodsSerializer | |
CloudFrontClient | A client for the CloudFront API. |
CloudFrontOriginAccessIdentity | CloudFront origin access identity. |
CloudFrontOriginAccessIdentityConfig | Origin access identity configuration. Send a |
CloudFrontOriginAccessIdentityConfigSerializer | |
CloudFrontOriginAccessIdentityList | Lists the origin access identities for CloudFront.Send a |
CloudFrontOriginAccessIdentitySummary | Summary of the information about a CloudFront origin access identity. |
ContentTypeProfile | A field-level encryption content type profile. |
ContentTypeProfileConfig | The configuration for a field-level encryption content type-profile mapping. |
ContentTypeProfileConfigSerializer | |
ContentTypeProfileListSerializer | |
ContentTypeProfileSerializer | |
ContentTypeProfiles | Field-level encryption content type-profile. |
ContentTypeProfilesSerializer | |
CookieNameListSerializer | |
CookieNames | A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide. |
CookieNamesSerializer | |
CookiePreference | A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide. |
CookiePreferenceSerializer | |
CreateCloudFrontOriginAccessIdentityRequest | The request to create a new origin access identity. |
CreateCloudFrontOriginAccessIdentityResult | The returned result of the corresponding request. |
CreateDistributionRequest | The request to create a new distribution. |
CreateDistributionResult | The returned result of the corresponding request. |
CreateDistributionWithTagsRequest | The request to create a new distribution with tags. |
CreateDistributionWithTagsResult | The returned result of the corresponding request. |
CreateFieldLevelEncryptionConfigRequest | |
CreateFieldLevelEncryptionConfigResult | |
CreateFieldLevelEncryptionProfileRequest | |
CreateFieldLevelEncryptionProfileResult | |
CreateInvalidationRequest | The request to create an invalidation. |
CreateInvalidationResult | The returned result of the corresponding request. |
CreatePublicKeyRequest | |
CreatePublicKeyResult | |
CreateStreamingDistributionRequest | The request to create a new streaming distribution. |
CreateStreamingDistributionResult | The returned result of the corresponding request. |
CreateStreamingDistributionWithTagsRequest | The request to create a new streaming distribution with tags. |
CreateStreamingDistributionWithTagsResult | The returned result of the corresponding request. |
CustomErrorResponse | A complex type that controls:
For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide. |
CustomErrorResponseListSerializer | |
CustomErrorResponseSerializer | |
CustomErrorResponses | A complex type that controls:
For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide. |
CustomErrorResponsesSerializer | |
CustomHeaders | A complex type that contains the list of Custom Headers for each origin. |
CustomHeadersSerializer | |
CustomOriginConfig | A customer origin or an Amazon S3 bucket configured as a website endpoint. |
CustomOriginConfigSerializer | |
DefaultCacheBehavior | A complex type that describes the default cache behavior if you don't specify a |
DefaultCacheBehaviorSerializer | |
DeleteCloudFrontOriginAccessIdentityRequest | Deletes a origin access identity. |
DeleteDistributionRequest | 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:
For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the Amazon CloudFront Developer Guide. |
DeleteFieldLevelEncryptionConfigRequest | |
DeleteFieldLevelEncryptionProfileRequest | |
DeletePublicKeyRequest | |
DeleteStreamingDistributionRequest | The request to delete a streaming distribution. |
Distribution | The distribution's information. |
DistributionConfig | A distribution configuration. |
DistributionConfigSerializer | |
DistributionConfigWithTags | A distribution Configuration and a list of tags to be associated with the distribution. |
DistributionConfigWithTagsSerializer | |
DistributionList | A distribution list. |
DistributionSummary | A summary of the information about a CloudFront distribution. |
EncryptionEntities | Complex data type for field-level encryption profiles that includes all of the encryption entities. |
EncryptionEntitiesSerializer | |
EncryptionEntity | Complex data type for field-level encryption profiles that includes the encryption key and field pattern specifications. |
EncryptionEntityListSerializer | |
EncryptionEntitySerializer | |
EventTypeSerializer | |
FieldLevelEncryption | A complex data type that includes the profile configurations and other options specified for field-level encryption. |
FieldLevelEncryptionConfig | A complex data type that includes the profile configurations specified for field-level encryption. |
FieldLevelEncryptionConfigSerializer | |
FieldLevelEncryptionList | List of field-level encrpytion configurations. |
FieldLevelEncryptionProfile | A complex data type for field-level encryption profiles. |
FieldLevelEncryptionProfileConfig | A complex data type of profiles for the field-level encryption. |
FieldLevelEncryptionProfileConfigSerializer | |
FieldLevelEncryptionProfileList | List of field-level encryption profiles. |
FieldLevelEncryptionProfileSummary | The field-level encryption profile summary. |
FieldLevelEncryptionSummary | A summary of a field-level encryption item. |
FieldPatternListSerializer | |
FieldPatterns | A complex data type that includes the field patterns to match for field-level encryption. |
FieldPatternsSerializer | |
FormatSerializer | |
ForwardedValues | A complex type that specifies how CloudFront handles query strings and cookies. |
ForwardedValuesSerializer | |
GeoRestriction | A complex type that controls the countries in which your content is distributed. CloudFront determines the location of your users using |
GeoRestrictionSerializer | |
GeoRestrictionTypeSerializer | |
GetCloudFrontOriginAccessIdentityConfigRequest | The origin access identity's configuration information. For more information, see CloudFrontOriginAccessIdentityConfigComplexType. |
GetCloudFrontOriginAccessIdentityConfigResult | The returned result of the corresponding request. |
GetCloudFrontOriginAccessIdentityRequest | The request to get an origin access identity's information. |
GetCloudFrontOriginAccessIdentityResult | The returned result of the corresponding request. |
GetDistributionConfigRequest | The request to get a distribution configuration. |
GetDistributionConfigResult | The returned result of the corresponding request. |
GetDistributionRequest | The request to get a distribution's information. |
GetDistributionResult | The returned result of the corresponding request. |
GetFieldLevelEncryptionConfigRequest | |
GetFieldLevelEncryptionConfigResult | |
GetFieldLevelEncryptionProfileConfigRequest | |
GetFieldLevelEncryptionProfileConfigResult | |
GetFieldLevelEncryptionProfileRequest | |
GetFieldLevelEncryptionProfileResult | |
GetFieldLevelEncryptionRequest | |
GetFieldLevelEncryptionResult | |
GetInvalidationRequest | The request to get an invalidation's information. |
GetInvalidationResult | The returned result of the corresponding request. |
GetPublicKeyConfigRequest | |
GetPublicKeyConfigResult | |
GetPublicKeyRequest | |
GetPublicKeyResult | |
GetStreamingDistributionConfigRequest | To request to get a streaming distribution configuration. |
GetStreamingDistributionConfigResult | The returned result of the corresponding request. |
GetStreamingDistributionRequest | The request to get a streaming distribution's information. |
GetStreamingDistributionResult | The returned result of the corresponding request. |
HeaderListSerializer | |
Headers | A complex type that specifies the request headers, if any, that you want CloudFront to base caching on for this cache behavior. For the headers that you specify, CloudFront caches separate versions of a specified object based on the header values in viewer requests. For example, suppose viewer requests for |
HeadersSerializer | |
HttpVersionSerializer | |
IntegerSerializer | |
Invalidation | An invalidation. |
InvalidationBatch | An invalidation batch. |
InvalidationBatchSerializer | |
InvalidationList | The |
InvalidationSummary | A summary of an invalidation request. |
ItemSelectionSerializer | |
KeyPairIds | A complex type that lists the active CloudFront key pairs, if any, that are associated with For more information, see ActiveTrustedSigners. |
LambdaFunctionARNSerializer | |
LambdaFunctionAssociation | A complex type that contains a Lambda function association. |
LambdaFunctionAssociationListSerializer | |
LambdaFunctionAssociationSerializer | |
LambdaFunctionAssociations | A complex type that specifies a list of Lambda functions associations for a cache behavior. If you want to invoke one or more Lambda functions triggered by requests that match the If you don't want to invoke any Lambda functions for the requests that match |
LambdaFunctionAssociationsSerializer | |
ListCloudFrontOriginAccessIdentitiesRequest | The request to list origin access identities. |
ListCloudFrontOriginAccessIdentitiesResult | The returned result of the corresponding request. |
ListDistributionsByWebACLIdRequest | The request to list distributions that are associated with a specified AWS WAF web ACL. |
ListDistributionsByWebACLIdResult | The response to a request to list the distributions that are associated with a specified AWS WAF web ACL. |
ListDistributionsRequest | The request to list your distributions. |
ListDistributionsResult | The returned result of the corresponding request. |
ListFieldLevelEncryptionConfigsRequest | |
ListFieldLevelEncryptionConfigsResult | |
ListFieldLevelEncryptionProfilesRequest | |
ListFieldLevelEncryptionProfilesResult | |
ListInvalidationsRequest | The request to list invalidations. |
ListInvalidationsResult | The returned result of the corresponding request. |
ListPublicKeysRequest | |
ListPublicKeysResult | |
ListStreamingDistributionsRequest | The request to list your streaming distributions. |
ListStreamingDistributionsResult | The returned result of the corresponding request. |
ListTagsForResourceRequest | The request to list tags for a CloudFront resource. |
ListTagsForResourceResult | The returned result of the corresponding request. |
LocationListSerializer | |
LoggingConfig | A complex type that controls whether access logs are written for the distribution. |
LoggingConfigSerializer | |
LongSerializer | |
MethodSerializer | |
MethodsListSerializer | |
MinimumProtocolVersionSerializer | |
Origin | A complex type that describes the Amazon S3 bucket, HTTP server (for example, a web server), Amazon MediaStore, or other server from which CloudFront gets your files. This can also be an origin group, if you've created an origin group. You must specify at least one origin or origin group. For the current limit on the number of origins or origin groups that you can specify for a distribution, see Amazon CloudFront Limits in the AWS General Reference. |
OriginCustomHeader | A complex type that contains |
OriginCustomHeaderSerializer | |
OriginCustomHeadersListSerializer | |
OriginGroup | An origin group includes two origins (a primary origin and a second origin to failover to) and a failover criteria that you specify. You create an origin group to support origin failover in CloudFront. When you create or update a distribution, you can specifiy the origin group instead of a single origin, and CloudFront will failover from the primary origin to the second origin under the failover conditions that you've chosen. |
OriginGroupFailoverCriteria | A complex data type that includes information about the failover criteria for an origin group, including the status codes for which CloudFront will failover from the primary origin to the second origin. |
OriginGroupFailoverCriteriaSerializer | |
OriginGroupListSerializer | |
OriginGroupMember | An origin in an origin group. |
OriginGroupMemberListSerializer | |
OriginGroupMemberSerializer | |
OriginGroupMembers | A complex data type for the origins included in an origin group. |
OriginGroupMembersSerializer | |
OriginGroupSerializer | |
OriginGroups | A complex data type for the origin groups specified for a distribution. |
OriginGroupsSerializer | |
OriginListSerializer | |
OriginProtocolPolicySerializer | |
OriginSerializer | |
OriginSslProtocols | A complex type that contains information about the SSL/TLS protocols that CloudFront can use when establishing an HTTPS connection with your origin. |
OriginSslProtocolsSerializer | |
Origins | A complex type that contains information about origins and origin groups for this distribution. |
OriginsSerializer | |
PathListSerializer | |
Paths | A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate in the Amazon CloudFront Developer Guide. |
PathsSerializer | |
PriceClassSerializer | |
PublicKey | A complex data type of public keys you add to CloudFront to use with features like field-level encryption. |
PublicKeyConfig | Information about a public key you add to CloudFront to use with features like field-level encryption. |
PublicKeyConfigSerializer | |
PublicKeyList | A list of public keys you've added to CloudFront to use with features like field-level encryption. |
PublicKeySummary | A complex data type for public key information. |
QueryArgProfile | Query argument-profile mapping for field-level encryption. |
QueryArgProfileConfig | Configuration for query argument-profile mapping for field-level encryption. |
QueryArgProfileConfigSerializer | |
QueryArgProfileListSerializer | |
QueryArgProfileSerializer | |
QueryArgProfiles | Query argument-profile mapping for field-level encryption. |
QueryArgProfilesSerializer | |
QueryStringCacheKeys | |
QueryStringCacheKeysListSerializer | |
QueryStringCacheKeysSerializer | |
ResourceARNSerializer | |
Restrictions | A complex type that identifies ways in which you want to restrict distribution of your content. |
RestrictionsSerializer | |
S3Origin | A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution. |
S3OriginSerializer | |
S3OriginConfig | A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the |
S3OriginConfigSerializer | |
SSLSupportMethodSerializer | |
Signer | A complex type that lists the AWS accounts that were included in the |
SslProtocolSerializer | |
SslProtocolsListSerializer | |
StatusCodeListSerializer | |
StatusCodes | A complex data type for the status codes that you specify that, when returned by a primary origin, trigger CloudFront to failover to a second origin. |
StatusCodesSerializer | |
StreamingDistribution | A streaming distribution. |
StreamingDistributionConfig | The RTMP distribution's configuration information. |
StreamingDistributionConfigSerializer | |
StreamingDistributionConfigWithTags | A streaming distribution Configuration and a list of tags to be associated with the streaming distribution. |
StreamingDistributionConfigWithTagsSerializer | |
StreamingDistributionList | A streaming distribution list. |
StreamingDistributionSummary | A summary of the information for an Amazon CloudFront streaming distribution. |
StreamingLoggingConfig | A complex type that controls whether access logs are written for this streaming distribution. |
StreamingLoggingConfigSerializer | |
StringSerializer | |
Tag | A complex type that contains |
TagKeyListSerializer | |
TagKeySerializer | |
TagKeys | A complex type that contains zero or more |
TagKeysSerializer | |
TagListSerializer | |
TagResourceRequest | The request to add tags to a CloudFront resource. |
TagSerializer | |
TagValueSerializer | |
Tags | A complex type that contains zero or more |
TagsSerializer | |
TrustedSigners | A complex type that specifies the AWS accounts, if any, that you want to allow to create signed URLs for private content. If you want to require signed URLs in requests for objects in the target origin that match the If you don't want to require signed URLs in requests for objects that match To add, change, or remove one or more trusted signers, change For more information about updating the distribution configuration, see DistributionConfig . |
TrustedSignersSerializer | |
UntagResourceRequest | The request to remove tags from a CloudFront resource. |
UpdateCloudFrontOriginAccessIdentityRequest | The request to update an origin access identity. |
UpdateCloudFrontOriginAccessIdentityResult | The returned result of the corresponding request. |
UpdateDistributionRequest | The request to update a distribution. |
UpdateDistributionResult | The returned result of the corresponding request. |
UpdateFieldLevelEncryptionConfigRequest | |
UpdateFieldLevelEncryptionConfigResult | |
UpdateFieldLevelEncryptionProfileRequest | |
UpdateFieldLevelEncryptionProfileResult | |
UpdatePublicKeyRequest | |
UpdatePublicKeyResult | |
UpdateStreamingDistributionRequest | The request to update a streaming distribution. |
UpdateStreamingDistributionResult | The returned result of the corresponding request. |
ViewerCertificate | A complex type that specifies the following:
You must specify only one of the following values: Don't specify If you want viewers to use HTTP instead of HTTPS to request your objects: Specify the following value: In addition, specify If you want viewers to use HTTPS to request your objects: Choose the type of certificate that you want to use based on whether you're using an alternate domain name for your objects or the CloudFront domain name:
If you want viewers to use HTTPS, you must also specify one of the following values in your cache behaviors:
You can also optionally require that CloudFront use HTTPS to communicate with your origin by specifying one of the following values for the applicable origins:
For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide. |
ViewerCertificateSerializer | |
ViewerProtocolPolicySerializer |
Enums
CreateCloudFrontOriginAccessIdentityError | Errors returned by CreateCloudFrontOriginAccessIdentity |
CreateDistributionError | Errors returned by CreateDistribution |
CreateDistributionWithTagsError | Errors returned by CreateDistributionWithTags |
CreateFieldLevelEncryptionConfigError | Errors returned by CreateFieldLevelEncryptionConfig |
CreateFieldLevelEncryptionProfileError | Errors returned by CreateFieldLevelEncryptionProfile |
CreateInvalidationError | Errors returned by CreateInvalidation |
CreatePublicKeyError | Errors returned by CreatePublicKey |
CreateStreamingDistributionError | Errors returned by CreateStreamingDistribution |
CreateStreamingDistributionWithTagsError | Errors returned by CreateStreamingDistributionWithTags |
DeleteCloudFrontOriginAccessIdentityError | Errors returned by DeleteCloudFrontOriginAccessIdentity |
DeleteDistributionError | Errors returned by DeleteDistribution |
DeleteFieldLevelEncryptionConfigError | Errors returned by DeleteFieldLevelEncryptionConfig |
DeleteFieldLevelEncryptionProfileError | Errors returned by DeleteFieldLevelEncryptionProfile |
DeletePublicKeyError | Errors returned by DeletePublicKey |
DeleteStreamingDistributionError | Errors returned by DeleteStreamingDistribution |
GetCloudFrontOriginAccessIdentityConfigError | Errors returned by GetCloudFrontOriginAccessIdentityConfig |
GetCloudFrontOriginAccessIdentityError | Errors returned by GetCloudFrontOriginAccessIdentity |
GetDistributionConfigError | Errors returned by GetDistributionConfig |
GetDistributionError | Errors returned by GetDistribution |
GetFieldLevelEncryptionConfigError | Errors returned by GetFieldLevelEncryptionConfig |
GetFieldLevelEncryptionError | Errors returned by GetFieldLevelEncryption |
GetFieldLevelEncryptionProfileConfigError | Errors returned by GetFieldLevelEncryptionProfileConfig |
GetFieldLevelEncryptionProfileError | Errors returned by GetFieldLevelEncryptionProfile |
GetInvalidationError | Errors returned by GetInvalidation |
GetPublicKeyConfigError | Errors returned by GetPublicKeyConfig |
GetPublicKeyError | Errors returned by GetPublicKey |
GetStreamingDistributionConfigError | Errors returned by GetStreamingDistributionConfig |
GetStreamingDistributionError | Errors returned by GetStreamingDistribution |
ListCloudFrontOriginAccessIdentitiesError | Errors returned by ListCloudFrontOriginAccessIdentities |
ListDistributionsByWebACLIdError | Errors returned by ListDistributionsByWebACLId |
ListDistributionsError | Errors returned by ListDistributions |
ListFieldLevelEncryptionConfigsError | Errors returned by ListFieldLevelEncryptionConfigs |
ListFieldLevelEncryptionProfilesError | Errors returned by ListFieldLevelEncryptionProfiles |
ListInvalidationsError | Errors returned by ListInvalidations |
ListPublicKeysError | Errors returned by ListPublicKeys |
ListStreamingDistributionsError | Errors returned by ListStreamingDistributions |
ListTagsForResourceError | Errors returned by ListTagsForResource |
TagResourceError | Errors returned by TagResource |
UntagResourceError | Errors returned by UntagResource |
UpdateCloudFrontOriginAccessIdentityError | Errors returned by UpdateCloudFrontOriginAccessIdentity |
UpdateDistributionError | Errors returned by UpdateDistribution |
UpdateFieldLevelEncryptionConfigError | Errors returned by UpdateFieldLevelEncryptionConfig |
UpdateFieldLevelEncryptionProfileError | Errors returned by UpdateFieldLevelEncryptionProfile |
UpdatePublicKeyError | Errors returned by UpdatePublicKey |
UpdateStreamingDistributionError | Errors returned by UpdateStreamingDistribution |
Traits
CloudFront | Trait representing the capabilities of the CloudFront API. CloudFront clients implement this trait. |