Documentation ¶
Overview ¶
Package cloudfront provides a client for Amazon CloudFront.
Index ¶
- Constants
- type ActiveTrustedSigners
- type Aliases
- type AllowedMethods
- type CacheBehavior
- type CacheBehaviors
- type CachedMethods
- type CloudFront
- func (c *CloudFront) CreateCloudFrontOriginAccessIdentity(input *CreateCloudFrontOriginAccessIdentityInput) (*CreateCloudFrontOriginAccessIdentityOutput, error)
- func (c *CloudFront) CreateCloudFrontOriginAccessIdentityRequest(input *CreateCloudFrontOriginAccessIdentityInput) (req *request.Request, output *CreateCloudFrontOriginAccessIdentityOutput)
- func (c *CloudFront) CreateDistribution(input *CreateDistributionInput) (*CreateDistributionOutput, error)
- func (c *CloudFront) CreateDistributionRequest(input *CreateDistributionInput) (req *request.Request, output *CreateDistributionOutput)
- func (c *CloudFront) CreateDistributionWithTags(input *CreateDistributionWithTagsInput) (*CreateDistributionWithTagsOutput, error)
- func (c *CloudFront) CreateDistributionWithTagsRequest(input *CreateDistributionWithTagsInput) (req *request.Request, output *CreateDistributionWithTagsOutput)
- func (c *CloudFront) CreateInvalidation(input *CreateInvalidationInput) (*CreateInvalidationOutput, error)
- func (c *CloudFront) CreateInvalidationRequest(input *CreateInvalidationInput) (req *request.Request, output *CreateInvalidationOutput)
- func (c *CloudFront) CreateStreamingDistribution(input *CreateStreamingDistributionInput) (*CreateStreamingDistributionOutput, error)
- func (c *CloudFront) CreateStreamingDistributionRequest(input *CreateStreamingDistributionInput) (req *request.Request, output *CreateStreamingDistributionOutput)
- func (c *CloudFront) CreateStreamingDistributionWithTags(input *CreateStreamingDistributionWithTagsInput) (*CreateStreamingDistributionWithTagsOutput, error)
- func (c *CloudFront) CreateStreamingDistributionWithTagsRequest(input *CreateStreamingDistributionWithTagsInput) (req *request.Request, output *CreateStreamingDistributionWithTagsOutput)
- func (c *CloudFront) DeleteCloudFrontOriginAccessIdentity(input *DeleteCloudFrontOriginAccessIdentityInput) (*DeleteCloudFrontOriginAccessIdentityOutput, error)
- func (c *CloudFront) DeleteCloudFrontOriginAccessIdentityRequest(input *DeleteCloudFrontOriginAccessIdentityInput) (req *request.Request, output *DeleteCloudFrontOriginAccessIdentityOutput)
- func (c *CloudFront) DeleteDistribution(input *DeleteDistributionInput) (*DeleteDistributionOutput, error)
- func (c *CloudFront) DeleteDistributionRequest(input *DeleteDistributionInput) (req *request.Request, output *DeleteDistributionOutput)
- func (c *CloudFront) DeleteStreamingDistribution(input *DeleteStreamingDistributionInput) (*DeleteStreamingDistributionOutput, error)
- func (c *CloudFront) DeleteStreamingDistributionRequest(input *DeleteStreamingDistributionInput) (req *request.Request, output *DeleteStreamingDistributionOutput)
- func (c *CloudFront) GetCloudFrontOriginAccessIdentity(input *GetCloudFrontOriginAccessIdentityInput) (*GetCloudFrontOriginAccessIdentityOutput, error)
- func (c *CloudFront) GetCloudFrontOriginAccessIdentityConfig(input *GetCloudFrontOriginAccessIdentityConfigInput) (*GetCloudFrontOriginAccessIdentityConfigOutput, error)
- func (c *CloudFront) GetCloudFrontOriginAccessIdentityConfigRequest(input *GetCloudFrontOriginAccessIdentityConfigInput) (req *request.Request, output *GetCloudFrontOriginAccessIdentityConfigOutput)
- func (c *CloudFront) GetCloudFrontOriginAccessIdentityRequest(input *GetCloudFrontOriginAccessIdentityInput) (req *request.Request, output *GetCloudFrontOriginAccessIdentityOutput)
- func (c *CloudFront) GetDistribution(input *GetDistributionInput) (*GetDistributionOutput, error)
- func (c *CloudFront) GetDistributionConfig(input *GetDistributionConfigInput) (*GetDistributionConfigOutput, error)
- func (c *CloudFront) GetDistributionConfigRequest(input *GetDistributionConfigInput) (req *request.Request, output *GetDistributionConfigOutput)
- func (c *CloudFront) GetDistributionRequest(input *GetDistributionInput) (req *request.Request, output *GetDistributionOutput)
- func (c *CloudFront) GetInvalidation(input *GetInvalidationInput) (*GetInvalidationOutput, error)
- func (c *CloudFront) GetInvalidationRequest(input *GetInvalidationInput) (req *request.Request, output *GetInvalidationOutput)
- func (c *CloudFront) GetStreamingDistribution(input *GetStreamingDistributionInput) (*GetStreamingDistributionOutput, error)
- func (c *CloudFront) GetStreamingDistributionConfig(input *GetStreamingDistributionConfigInput) (*GetStreamingDistributionConfigOutput, error)
- func (c *CloudFront) GetStreamingDistributionConfigRequest(input *GetStreamingDistributionConfigInput) (req *request.Request, output *GetStreamingDistributionConfigOutput)
- func (c *CloudFront) GetStreamingDistributionRequest(input *GetStreamingDistributionInput) (req *request.Request, output *GetStreamingDistributionOutput)
- func (c *CloudFront) ListCloudFrontOriginAccessIdentities(input *ListCloudFrontOriginAccessIdentitiesInput) (*ListCloudFrontOriginAccessIdentitiesOutput, error)
- func (c *CloudFront) ListCloudFrontOriginAccessIdentitiesPages(input *ListCloudFrontOriginAccessIdentitiesInput, ...) error
- func (c *CloudFront) ListCloudFrontOriginAccessIdentitiesRequest(input *ListCloudFrontOriginAccessIdentitiesInput) (req *request.Request, output *ListCloudFrontOriginAccessIdentitiesOutput)
- func (c *CloudFront) ListDistributions(input *ListDistributionsInput) (*ListDistributionsOutput, error)
- func (c *CloudFront) ListDistributionsByWebACLId(input *ListDistributionsByWebACLIdInput) (*ListDistributionsByWebACLIdOutput, error)
- func (c *CloudFront) ListDistributionsByWebACLIdRequest(input *ListDistributionsByWebACLIdInput) (req *request.Request, output *ListDistributionsByWebACLIdOutput)
- func (c *CloudFront) ListDistributionsPages(input *ListDistributionsInput, ...) error
- func (c *CloudFront) ListDistributionsRequest(input *ListDistributionsInput) (req *request.Request, output *ListDistributionsOutput)
- func (c *CloudFront) ListInvalidations(input *ListInvalidationsInput) (*ListInvalidationsOutput, error)
- func (c *CloudFront) ListInvalidationsPages(input *ListInvalidationsInput, ...) error
- func (c *CloudFront) ListInvalidationsRequest(input *ListInvalidationsInput) (req *request.Request, output *ListInvalidationsOutput)
- func (c *CloudFront) ListStreamingDistributions(input *ListStreamingDistributionsInput) (*ListStreamingDistributionsOutput, error)
- func (c *CloudFront) ListStreamingDistributionsPages(input *ListStreamingDistributionsInput, ...) error
- func (c *CloudFront) ListStreamingDistributionsRequest(input *ListStreamingDistributionsInput) (req *request.Request, output *ListStreamingDistributionsOutput)
- func (c *CloudFront) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error)
- func (c *CloudFront) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput)
- func (c *CloudFront) TagResource(input *TagResourceInput) (*TagResourceOutput, error)
- func (c *CloudFront) TagResourceRequest(input *TagResourceInput) (req *request.Request, output *TagResourceOutput)
- func (c *CloudFront) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error)
- func (c *CloudFront) UntagResourceRequest(input *UntagResourceInput) (req *request.Request, output *UntagResourceOutput)
- func (c *CloudFront) UpdateCloudFrontOriginAccessIdentity(input *UpdateCloudFrontOriginAccessIdentityInput) (*UpdateCloudFrontOriginAccessIdentityOutput, error)
- func (c *CloudFront) UpdateCloudFrontOriginAccessIdentityRequest(input *UpdateCloudFrontOriginAccessIdentityInput) (req *request.Request, output *UpdateCloudFrontOriginAccessIdentityOutput)
- func (c *CloudFront) UpdateDistribution(input *UpdateDistributionInput) (*UpdateDistributionOutput, error)
- func (c *CloudFront) UpdateDistributionRequest(input *UpdateDistributionInput) (req *request.Request, output *UpdateDistributionOutput)
- func (c *CloudFront) UpdateStreamingDistribution(input *UpdateStreamingDistributionInput) (*UpdateStreamingDistributionOutput, error)
- func (c *CloudFront) UpdateStreamingDistributionRequest(input *UpdateStreamingDistributionInput) (req *request.Request, output *UpdateStreamingDistributionOutput)
- func (c *CloudFront) WaitUntilDistributionDeployed(input *GetDistributionInput) error
- func (c *CloudFront) WaitUntilInvalidationCompleted(input *GetInvalidationInput) error
- func (c *CloudFront) WaitUntilStreamingDistributionDeployed(input *GetStreamingDistributionInput) error
- type CookieNames
- type CookiePreference
- type CreateCloudFrontOriginAccessIdentityInput
- type CreateCloudFrontOriginAccessIdentityOutput
- type CreateDistributionInput
- type CreateDistributionOutput
- type CreateDistributionWithTagsInput
- type CreateDistributionWithTagsOutput
- type CreateInvalidationInput
- type CreateInvalidationOutput
- type CreateStreamingDistributionInput
- type CreateStreamingDistributionOutput
- type CreateStreamingDistributionWithTagsInput
- type CreateStreamingDistributionWithTagsOutput
- type CustomErrorResponse
- type CustomErrorResponses
- type CustomHeaders
- type CustomOriginConfig
- type DefaultCacheBehavior
- type DeleteCloudFrontOriginAccessIdentityInput
- type DeleteCloudFrontOriginAccessIdentityOutput
- type DeleteDistributionInput
- type DeleteDistributionOutput
- type DeleteStreamingDistributionInput
- type DeleteStreamingDistributionOutput
- type Distribution
- type DistributionConfig
- type DistributionConfigWithTags
- type DistributionList
- type DistributionSummary
- type ForwardedValues
- type GeoRestriction
- type GetCloudFrontOriginAccessIdentityConfigInput
- type GetCloudFrontOriginAccessIdentityConfigOutput
- type GetCloudFrontOriginAccessIdentityInput
- type GetCloudFrontOriginAccessIdentityOutput
- type GetDistributionConfigInput
- type GetDistributionConfigOutput
- type GetDistributionInput
- type GetDistributionOutput
- type GetInvalidationInput
- type GetInvalidationOutput
- type GetStreamingDistributionConfigInput
- type GetStreamingDistributionConfigOutput
- type GetStreamingDistributionInput
- type GetStreamingDistributionOutput
- type Headers
- type Invalidation
- type InvalidationBatch
- type InvalidationList
- type InvalidationSummary
- type KeyPairIds
- type ListCloudFrontOriginAccessIdentitiesInput
- type ListCloudFrontOriginAccessIdentitiesOutput
- type ListDistributionsByWebACLIdInput
- type ListDistributionsByWebACLIdOutput
- type ListDistributionsInput
- type ListDistributionsOutput
- type ListInvalidationsInput
- type ListInvalidationsOutput
- type ListStreamingDistributionsInput
- type ListStreamingDistributionsOutput
- type ListTagsForResourceInput
- type ListTagsForResourceOutput
- type LoggingConfig
- type Origin
- type OriginAccessIdentity
- type OriginAccessIdentityConfig
- type OriginAccessIdentityList
- type OriginAccessIdentitySummary
- type OriginCustomHeader
- type OriginSslProtocols
- type Origins
- type Paths
- type QueryStringCacheKeys
- type Restrictions
- type S3Origin
- type S3OriginConfig
- type Signer
- type StreamingDistribution
- type StreamingDistributionConfig
- type StreamingDistributionConfigWithTags
- type StreamingDistributionList
- type StreamingDistributionSummary
- type StreamingLoggingConfig
- type Tag
- type TagKeys
- type TagResourceInput
- type TagResourceOutput
- type Tags
- type TrustedSigners
- type UntagResourceInput
- type UntagResourceOutput
- type UpdateCloudFrontOriginAccessIdentityInput
- type UpdateCloudFrontOriginAccessIdentityOutput
- type UpdateDistributionInput
- type UpdateDistributionOutput
- type UpdateStreamingDistributionInput
- type UpdateStreamingDistributionOutput
- type ViewerCertificate
Examples ¶
- CloudFront.CreateCloudFrontOriginAccessIdentity
- CloudFront.CreateDistribution
- CloudFront.CreateDistributionWithTags
- CloudFront.CreateInvalidation
- CloudFront.CreateStreamingDistribution
- CloudFront.CreateStreamingDistributionWithTags
- CloudFront.DeleteCloudFrontOriginAccessIdentity
- CloudFront.DeleteDistribution
- CloudFront.DeleteStreamingDistribution
- CloudFront.GetCloudFrontOriginAccessIdentity
- CloudFront.GetCloudFrontOriginAccessIdentityConfig
- CloudFront.GetDistribution
- CloudFront.GetDistributionConfig
- CloudFront.GetInvalidation
- CloudFront.GetStreamingDistribution
- CloudFront.GetStreamingDistributionConfig
- CloudFront.ListCloudFrontOriginAccessIdentities
- CloudFront.ListDistributions
- CloudFront.ListDistributionsByWebACLId
- CloudFront.ListInvalidations
- CloudFront.ListStreamingDistributions
- CloudFront.ListTagsForResource
- CloudFront.TagResource
- CloudFront.UntagResource
- CloudFront.UpdateCloudFrontOriginAccessIdentity
- CloudFront.UpdateDistribution
- CloudFront.UpdateStreamingDistribution
Constants ¶
const ( // CertificateSourceCloudfront is a CertificateSource enum value CertificateSourceCloudfront = "cloudfront" // CertificateSourceIam is a CertificateSource enum value CertificateSourceIam = "iam" // CertificateSourceAcm is a CertificateSource enum value CertificateSourceAcm = "acm" )
const ( // GeoRestrictionTypeBlacklist is a GeoRestrictionType enum value GeoRestrictionTypeBlacklist = "blacklist" // GeoRestrictionTypeWhitelist is a GeoRestrictionType enum value GeoRestrictionTypeWhitelist = "whitelist" // GeoRestrictionTypeNone is a GeoRestrictionType enum value GeoRestrictionTypeNone = "none" )
const ( // HttpVersionHttp11 is a HttpVersion enum value HttpVersionHttp11 = "http1.1" // HttpVersionHttp2 is a HttpVersion enum value HttpVersionHttp2 = "http2" )
const ( // ItemSelectionNone is a ItemSelection enum value ItemSelectionNone = "none" // ItemSelectionWhitelist is a ItemSelection enum value ItemSelectionWhitelist = "whitelist" // ItemSelectionAll is a ItemSelection enum value ItemSelectionAll = "all" )
const ( // MethodGet is a Method enum value MethodGet = "GET" // MethodHead is a Method enum value MethodHead = "HEAD" // MethodPost is a Method enum value MethodPost = "POST" // MethodPut is a Method enum value MethodPut = "PUT" // MethodPatch is a Method enum value MethodPatch = "PATCH" // MethodOptions is a Method enum value MethodOptions = "OPTIONS" // MethodDelete is a Method enum value MethodDelete = "DELETE" )
const ( // MinimumProtocolVersionSslv3 is a MinimumProtocolVersion enum value MinimumProtocolVersionSslv3 = "SSLv3" // MinimumProtocolVersionTlsv1 is a MinimumProtocolVersion enum value MinimumProtocolVersionTlsv1 = "TLSv1" )
const ( // OriginProtocolPolicyHttpOnly is a OriginProtocolPolicy enum value OriginProtocolPolicyHttpOnly = "http-only" // OriginProtocolPolicyMatchViewer is a OriginProtocolPolicy enum value OriginProtocolPolicyMatchViewer = "match-viewer" // OriginProtocolPolicyHttpsOnly is a OriginProtocolPolicy enum value OriginProtocolPolicyHttpsOnly = "https-only" )
const ( // PriceClassPriceClass100 is a PriceClass enum value PriceClassPriceClass100 = "PriceClass_100" // PriceClassPriceClass200 is a PriceClass enum value PriceClassPriceClass200 = "PriceClass_200" // PriceClassPriceClassAll is a PriceClass enum value PriceClassPriceClassAll = "PriceClass_All" )
const ( // SSLSupportMethodSniOnly is a SSLSupportMethod enum value SSLSupportMethodSniOnly = "sni-only" // SSLSupportMethodVip is a SSLSupportMethod enum value SSLSupportMethodVip = "vip" )
const ( // SslProtocolSslv3 is a SslProtocol enum value SslProtocolSslv3 = "SSLv3" // SslProtocolTlsv1 is a SslProtocol enum value SslProtocolTlsv1 = "TLSv1" // SslProtocolTlsv11 is a SslProtocol enum value SslProtocolTlsv11 = "TLSv1.1" // SslProtocolTlsv12 is a SslProtocol enum value SslProtocolTlsv12 = "TLSv1.2" )
const ( // ViewerProtocolPolicyAllowAll is a ViewerProtocolPolicy enum value ViewerProtocolPolicyAllowAll = "allow-all" // ViewerProtocolPolicyHttpsOnly is a ViewerProtocolPolicy enum value ViewerProtocolPolicyHttpsOnly = "https-only" // ViewerProtocolPolicyRedirectToHttps is a ViewerProtocolPolicy enum value ViewerProtocolPolicyRedirectToHttps = "redirect-to-https" )
const ServiceName = "cloudfront"
A ServiceName is the name of the service the client will make API calls to.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ActiveTrustedSigners ¶
type ActiveTrustedSigners struct { // Enabled is true if any of the AWS accounts listed in the TrustedSigners complex // type for this RTMP distribution have active CloudFront key pairs. If not, // Enabled is false. // // For more information, see ActiveTrustedSigners. // // Enabled is a required field Enabled *bool `type:"boolean" required:"true"` // A complex type that contains one Signer complex type for each trusted signer // that is specified in the TrustedSigners complex type. // // For more information, see ActiveTrustedSigners. Items []*Signer `locationNameList:"Signer" type:"list"` // A complex type that contains one Signer complex type for each trusted signer // specified in the TrustedSigners complex type. // // For more information, see ActiveTrustedSigners. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that lists the AWS accounts, if any, that you included in the TrustedSigners complex type for this distribution. These are the accounts that you want to allow to create signed URLs for private content.
The Signer complex type lists the AWS account number of the trusted signer or self if the signer is the AWS account that created the distribution. The Signer element also includes the IDs of any active CloudFront key pairs that are associated with the trusted signer's AWS account. If no KeyPairId element appears for a Signer, that signer can't create signed URLs.
For more information, see Serving Private Content through CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) in the Amazon CloudFront Developer Guide.
func (ActiveTrustedSigners) GoString ¶
func (s ActiveTrustedSigners) GoString() string
GoString returns the string representation
func (ActiveTrustedSigners) String ¶
func (s ActiveTrustedSigners) String() string
String returns the string representation
type Aliases ¶
type Aliases struct { // A complex type that contains the CNAME aliases, if any, that you want to // associate with this distribution. Items []*string `locationNameList:"CNAME" type:"list"` // The number of CNAME aliases, if any, that you want to associate with this // distribution. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
type AllowedMethods ¶
type AllowedMethods struct { // A complex type that controls whether CloudFront caches the response to requests // using the specified HTTP methods. There are two choices: // // * CloudFront caches responses to GET and HEAD requests. // // * CloudFront caches responses to GET, HEAD, and OPTIONS requests. // // 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. CachedMethods *CachedMethods `type:"structure"` // A complex type that contains the HTTP methods that you want CloudFront to // process and forward to your origin. // // Items is a required field Items []*string `locationNameList:"Method" type:"list" required:"true"` // The number of HTTP methods that you want CloudFront to forward to your origin. // Valid values are 2 (for GET and HEAD requests), 3 (for GET, HEAD, and OPTIONS // requests) and 7 (for GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests). // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
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:
CloudFront forwards only GET and HEAD requests.
CloudFront forwards only GET, HEAD, and OPTIONS requests.
CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE requests.
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.
func (AllowedMethods) GoString ¶
func (s AllowedMethods) GoString() string
GoString returns the string representation
func (AllowedMethods) String ¶
func (s AllowedMethods) String() string
String returns the string representation
func (*AllowedMethods) Validate ¶
func (s *AllowedMethods) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CacheBehavior ¶
type CacheBehavior struct { // 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: // // * CloudFront forwards only GET and HEAD requests. // // * CloudFront forwards only GET, HEAD, and OPTIONS requests. // // * CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE // requests. // // 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. AllowedMethods *AllowedMethods `type:"structure"` // Whether you want CloudFront to automatically compress certain files for this // cache behavior. If so, specify true; if not, specify false. For more information, // see Serving Compressed Files (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/ServingCompressedFiles.html) // in the Amazon CloudFront Developer Guide. Compress *bool `type:"boolean"` // The default amount of time that you want objects to stay in CloudFront caches // before CloudFront forwards another request to your origin to determine whether // the object has been updated. The value that you specify applies only when // your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control // s-maxage, and Expires to objects. For more information, see Specifying How // Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) // in the Amazon CloudFront Developer Guide. DefaultTTL *int64 `type:"long"` // A complex type that specifies how CloudFront handles query strings and cookies. // // ForwardedValues is a required field ForwardedValues *ForwardedValues `type:"structure" required:"true"` // The maximum amount of time that you want objects to stay in CloudFront caches // before CloudFront forwards another request to your origin to determine whether // the object has been updated. The value that you specify applies only when // your origin adds HTTP headers such as Cache-Control max-age, Cache-Control // s-maxage, and Expires to objects. For more information, see Specifying How // Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) // in the Amazon CloudFront Developer Guide. MaxTTL *int64 `type:"long"` // The minimum amount of time that you want objects to stay in CloudFront caches // before CloudFront forwards another request to your origin to determine whether // the object has been updated. For more information, see Specifying How Long // Objects and Errors Stay in a CloudFront Edge Cache (Expiration) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) // in the Amazon Amazon CloudFront Developer Guide. // // You must specify 0 for MinTTL if you configure CloudFront to forward all // headers to your origin (under Headers, if you specify 1 for Quantity and // * for Name). // // MinTTL is a required field MinTTL *int64 `type:"long" required:"true"` // The pattern (for example, images/*.jpg) that specifies which requests to // apply the behavior to. When CloudFront receives a viewer request, the requested // path is compared with path patterns in the order in which cache behaviors // are listed in the distribution. // // You can optionally include a slash (/) at the beginning of the path pattern. // For example, /images/*.jpg. CloudFront behavior is the same with or without // the leading /. // // The path pattern for the default cache behavior is * and cannot be changed. // If the request for an object does not match the path pattern for any cache // behaviors, CloudFront applies the behavior in the default cache behavior. // // For more information, see Path Pattern (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesPathPattern) // in the Amazon CloudFront Developer Guide. // // PathPattern is a required field PathPattern *string `type:"string" required:"true"` // Indicates whether you want to distribute media files in the Microsoft Smooth // Streaming format using the origin that is associated with this cache behavior. // If so, specify true; if not, specify false. If you specify true for SmoothStreaming, // you can still distribute other content using this cache behavior if the content // matches the value of PathPattern. SmoothStreaming *bool `type:"boolean"` // The value of ID for the origin that you want CloudFront to route requests // to when a request matches the path pattern either for a cache behavior or // for the default cache behavior. // // TargetOriginId is a required field TargetOriginId *string `type:"string" required:"true"` // 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 PathPattern for this cache behavior, specify true for // Enabled, and specify the applicable values for Quantity and Items. For more // information, see Serving Private Content through CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) // in the Amazon Amazon CloudFront Developer Guide. // // If you don't want to require signed URLs in requests for objects that match // PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. // // To add, change, or remove one or more trusted signers, change Enabled to // true (if it's currently false), change Quantity as applicable, and specify // all of the trusted signers that you want to include in the updated distribution. // // TrustedSigners is a required field TrustedSigners *TrustedSigners `type:"structure" required:"true"` // The protocol that viewers can use to access the files in the origin specified // by TargetOriginId when a request matches the path pattern in PathPattern. // You can specify the following options: // // * allow-all: Viewers can use HTTP or HTTPS. // // * redirect-to-https: If a viewer submits an HTTP request, CloudFront returns // an HTTP status code of 301 (Moved Permanently) to the viewer along with // the HTTPS URL. The viewer then resubmits the request using the new URL. // // // * https-only: If a viewer sends an HTTP request, CloudFront returns an // HTTP status code of 403 (Forbidden). // // For more information about requiring the HTTPS protocol, see Using an HTTPS // Connection to Access Your Objects (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html) // in the Amazon CloudFront Developer Guide. // // The only way to guarantee that viewers retrieve an object that was fetched // from the origin using HTTPS is never to use any other protocol to fetch the // object. If you have recently changed from HTTP to HTTPS, we recommend that // you clear your objects' cache because cached objects are protocol agnostic. // That means that an edge location will return an object from the cache regardless // of whether the current request protocol matches the protocol used previously. // For more information, see Specifying How Long Objects and Errors Stay in // a CloudFront Edge Cache (Expiration) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) // in the Amazon CloudFront Developer Guide. // // ViewerProtocolPolicy is a required field ViewerProtocolPolicy *string `type:"string" required:"true" enum:"ViewerProtocolPolicy"` // contains filtered or unexported fields }
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 (http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_cloudfront) in the AWS General Reference.
If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't include an empty CacheBehavior element, or CloudFront returns a MalformedXML error.
To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element.
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 (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesCacheBehavior) in the Amazon CloudFront Developer Guide.
func (CacheBehavior) GoString ¶
func (s CacheBehavior) GoString() string
GoString returns the string representation
func (CacheBehavior) String ¶
func (s CacheBehavior) String() string
String returns the string representation
func (*CacheBehavior) Validate ¶
func (s *CacheBehavior) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CacheBehaviors ¶
type CacheBehaviors struct { // Optional: A complex type that contains cache behaviors for this distribution. // If Quantity is 0, you can omit Items. Items []*CacheBehavior `locationNameList:"CacheBehavior" type:"list"` // The number of cache behaviors for this distribution. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that contains zero or more CacheBehavior elements.
func (CacheBehaviors) GoString ¶
func (s CacheBehaviors) GoString() string
GoString returns the string representation
func (CacheBehaviors) String ¶
func (s CacheBehaviors) String() string
String returns the string representation
func (*CacheBehaviors) Validate ¶
func (s *CacheBehaviors) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CachedMethods ¶
type CachedMethods struct { // A complex type that contains the HTTP methods that you want CloudFront to // cache responses to. // // Items is a required field Items []*string `locationNameList:"Method" type:"list" required:"true"` // The number of HTTP methods for which you want CloudFront to cache responses. // Valid values are 2 (for caching responses to GET and HEAD requests) and 3 // (for caching responses to GET, HEAD, and OPTIONS requests). // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices:
CloudFront caches responses to GET and HEAD requests.
CloudFront caches responses to GET, HEAD, and OPTIONS requests.
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.
func (CachedMethods) GoString ¶
func (s CachedMethods) GoString() string
GoString returns the string representation
func (CachedMethods) String ¶
func (s CachedMethods) String() string
String returns the string representation
func (*CachedMethods) Validate ¶
func (s *CachedMethods) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CloudFront ¶
This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about the CloudFront API actions, data types, and errors. For detailed information about CloudFront features and their associated API calls, see the Amazon CloudFront Developer Guide. The service client's operations are safe to be used concurrently. It is not safe to mutate any of the client's properties though.
func New ¶
func New(p client.ConfigProvider, cfgs ...*aws.Config) *CloudFront
New creates a new instance of the CloudFront client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.
Example:
// Create a CloudFront client from just a session. svc := cloudfront.New(mySession) // Create a CloudFront client with additional configuration svc := cloudfront.New(mySession, aws.NewConfig().WithRegion("us-west-2"))
func (*CloudFront) CreateCloudFrontOriginAccessIdentity ¶
func (c *CloudFront) CreateCloudFrontOriginAccessIdentity(input *CreateCloudFrontOriginAccessIdentityInput) (*CreateCloudFrontOriginAccessIdentityOutput, error)
CreateCloudFrontOriginAccessIdentity API operation for Amazon CloudFront.
Creates a new origin access identity. If you're using Amazon S3 for your origin, you can use an origin access identity to require users to access your content using a CloudFront URL instead of the Amazon S3 URL. For more information about how to use origin access identities, see Serving Private Content through CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) in the Amazon CloudFront Developer Guide.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation CreateCloudFrontOriginAccessIdentity for usage and error information.
Returned Error Codes:
OriginAccessIdentityAlreadyExists 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.
MissingBody This operation requires a body. Ensure that the body is present and the Content-Type header is set.
TooManyCloudFrontOriginAccessIdentities Processing your request would cause you to exceed the maximum number of origin access identities allowed.
InvalidArgument The argument is invalid.
InconsistentQuantities The value of Quantity and the size of Items do not match.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.CreateCloudFrontOriginAccessIdentityInput{ CloudFrontOriginAccessIdentityConfig: &cloudfront.OriginAccessIdentityConfig{ // Required CallerReference: aws.String("string"), // Required Comment: aws.String("string"), // Required }, } resp, err := svc.CreateCloudFrontOriginAccessIdentity(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) CreateCloudFrontOriginAccessIdentityRequest ¶
func (c *CloudFront) CreateCloudFrontOriginAccessIdentityRequest(input *CreateCloudFrontOriginAccessIdentityInput) (req *request.Request, output *CreateCloudFrontOriginAccessIdentityOutput)
CreateCloudFrontOriginAccessIdentityRequest generates a "aws/request.Request" representing the client's request for the CreateCloudFrontOriginAccessIdentity operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See CreateCloudFrontOriginAccessIdentity for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateCloudFrontOriginAccessIdentity method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the CreateCloudFrontOriginAccessIdentityRequest method. req, resp := client.CreateCloudFrontOriginAccessIdentityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) CreateDistribution ¶
func (c *CloudFront) CreateDistribution(input *CreateDistributionInput) (*CreateDistributionOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.CreateDistributionInput{ DistributionConfig: &cloudfront.DistributionConfig{ // Required CallerReference: aws.String("string"), // Required Comment: aws.String("string"), // Required DefaultCacheBehavior: &cloudfront.DefaultCacheBehavior{ // Required ForwardedValues: &cloudfront.ForwardedValues{ // Required Cookies: &cloudfront.CookiePreference{ // Required Forward: aws.String("ItemSelection"), // Required WhitelistedNames: &cloudfront.CookieNames{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, QueryString: aws.Bool(true), // Required Headers: &cloudfront.Headers{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, QueryStringCacheKeys: &cloudfront.QueryStringCacheKeys{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, MinTTL: aws.Int64(1), // Required TargetOriginId: aws.String("string"), // Required TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, ViewerProtocolPolicy: aws.String("ViewerProtocolPolicy"), // Required AllowedMethods: &cloudfront.AllowedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required CachedMethods: &cloudfront.CachedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, Compress: aws.Bool(true), DefaultTTL: aws.Int64(1), MaxTTL: aws.Int64(1), SmoothStreaming: aws.Bool(true), }, Enabled: aws.Bool(true), // Required Origins: &cloudfront.Origins{ // Required Quantity: aws.Int64(1), // Required Items: []*cloudfront.Origin{ { // Required DomainName: aws.String("string"), // Required Id: aws.String("string"), // Required CustomHeaders: &cloudfront.CustomHeaders{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.OriginCustomHeader{ { // Required HeaderName: aws.String("string"), // Required HeaderValue: aws.String("string"), // Required }, // More values... }, }, CustomOriginConfig: &cloudfront.CustomOriginConfig{ HTTPPort: aws.Int64(1), // Required HTTPSPort: aws.Int64(1), // Required OriginProtocolPolicy: aws.String("OriginProtocolPolicy"), // Required OriginSslProtocols: &cloudfront.OriginSslProtocols{ Items: []*string{ // Required aws.String("SslProtocol"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, OriginPath: aws.String("string"), S3OriginConfig: &cloudfront.S3OriginConfig{ OriginAccessIdentity: aws.String("string"), // Required }, }, // More values... }, }, Aliases: &cloudfront.Aliases{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, CacheBehaviors: &cloudfront.CacheBehaviors{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.CacheBehavior{ { // Required ForwardedValues: &cloudfront.ForwardedValues{ // Required Cookies: &cloudfront.CookiePreference{ // Required Forward: aws.String("ItemSelection"), // Required WhitelistedNames: &cloudfront.CookieNames{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, QueryString: aws.Bool(true), // Required Headers: &cloudfront.Headers{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, QueryStringCacheKeys: &cloudfront.QueryStringCacheKeys{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, MinTTL: aws.Int64(1), // Required PathPattern: aws.String("string"), // Required TargetOriginId: aws.String("string"), // Required TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, ViewerProtocolPolicy: aws.String("ViewerProtocolPolicy"), // Required AllowedMethods: &cloudfront.AllowedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required CachedMethods: &cloudfront.CachedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, Compress: aws.Bool(true), DefaultTTL: aws.Int64(1), MaxTTL: aws.Int64(1), SmoothStreaming: aws.Bool(true), }, // More values... }, }, CustomErrorResponses: &cloudfront.CustomErrorResponses{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.CustomErrorResponse{ { // Required ErrorCode: aws.Int64(1), // Required ErrorCachingMinTTL: aws.Int64(1), ResponseCode: aws.String("string"), ResponsePagePath: aws.String("string"), }, // More values... }, }, DefaultRootObject: aws.String("string"), HttpVersion: aws.String("HttpVersion"), IsIPV6Enabled: aws.Bool(true), Logging: &cloudfront.LoggingConfig{ Bucket: aws.String("string"), // Required Enabled: aws.Bool(true), // Required IncludeCookies: aws.Bool(true), // Required Prefix: aws.String("string"), // Required }, PriceClass: aws.String("PriceClass"), Restrictions: &cloudfront.Restrictions{ GeoRestriction: &cloudfront.GeoRestriction{ // Required Quantity: aws.Int64(1), // Required RestrictionType: aws.String("GeoRestrictionType"), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, ViewerCertificate: &cloudfront.ViewerCertificate{ ACMCertificateArn: aws.String("string"), Certificate: aws.String("string"), CertificateSource: aws.String("CertificateSource"), CloudFrontDefaultCertificate: aws.Bool(true), IAMCertificateId: aws.String("string"), MinimumProtocolVersion: aws.String("MinimumProtocolVersion"), SSLSupportMethod: aws.String("SSLSupportMethod"), }, WebACLId: aws.String("string"), }, } resp, err := svc.CreateDistribution(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) CreateDistributionRequest ¶
func (c *CloudFront) CreateDistributionRequest(input *CreateDistributionInput) (req *request.Request, output *CreateDistributionOutput)
CreateDistributionRequest generates a "aws/request.Request" representing the client's request for the CreateDistribution operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See CreateDistribution for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateDistribution method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the CreateDistributionRequest method. req, resp := client.CreateDistributionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) CreateDistributionWithTags ¶
func (c *CloudFront) CreateDistributionWithTags(input *CreateDistributionWithTagsInput) (*CreateDistributionWithTagsOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.CreateDistributionWithTagsInput{ DistributionConfigWithTags: &cloudfront.DistributionConfigWithTags{ // Required DistributionConfig: &cloudfront.DistributionConfig{ // Required CallerReference: aws.String("string"), // Required Comment: aws.String("string"), // Required DefaultCacheBehavior: &cloudfront.DefaultCacheBehavior{ // Required ForwardedValues: &cloudfront.ForwardedValues{ // Required Cookies: &cloudfront.CookiePreference{ // Required Forward: aws.String("ItemSelection"), // Required WhitelistedNames: &cloudfront.CookieNames{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, QueryString: aws.Bool(true), // Required Headers: &cloudfront.Headers{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, QueryStringCacheKeys: &cloudfront.QueryStringCacheKeys{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, MinTTL: aws.Int64(1), // Required TargetOriginId: aws.String("string"), // Required TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, ViewerProtocolPolicy: aws.String("ViewerProtocolPolicy"), // Required AllowedMethods: &cloudfront.AllowedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required CachedMethods: &cloudfront.CachedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, Compress: aws.Bool(true), DefaultTTL: aws.Int64(1), MaxTTL: aws.Int64(1), SmoothStreaming: aws.Bool(true), }, Enabled: aws.Bool(true), // Required Origins: &cloudfront.Origins{ // Required Quantity: aws.Int64(1), // Required Items: []*cloudfront.Origin{ { // Required DomainName: aws.String("string"), // Required Id: aws.String("string"), // Required CustomHeaders: &cloudfront.CustomHeaders{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.OriginCustomHeader{ { // Required HeaderName: aws.String("string"), // Required HeaderValue: aws.String("string"), // Required }, // More values... }, }, CustomOriginConfig: &cloudfront.CustomOriginConfig{ HTTPPort: aws.Int64(1), // Required HTTPSPort: aws.Int64(1), // Required OriginProtocolPolicy: aws.String("OriginProtocolPolicy"), // Required OriginSslProtocols: &cloudfront.OriginSslProtocols{ Items: []*string{ // Required aws.String("SslProtocol"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, OriginPath: aws.String("string"), S3OriginConfig: &cloudfront.S3OriginConfig{ OriginAccessIdentity: aws.String("string"), // Required }, }, // More values... }, }, Aliases: &cloudfront.Aliases{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, CacheBehaviors: &cloudfront.CacheBehaviors{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.CacheBehavior{ { // Required ForwardedValues: &cloudfront.ForwardedValues{ // Required Cookies: &cloudfront.CookiePreference{ // Required Forward: aws.String("ItemSelection"), // Required WhitelistedNames: &cloudfront.CookieNames{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, QueryString: aws.Bool(true), // Required Headers: &cloudfront.Headers{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, QueryStringCacheKeys: &cloudfront.QueryStringCacheKeys{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, MinTTL: aws.Int64(1), // Required PathPattern: aws.String("string"), // Required TargetOriginId: aws.String("string"), // Required TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, ViewerProtocolPolicy: aws.String("ViewerProtocolPolicy"), // Required AllowedMethods: &cloudfront.AllowedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required CachedMethods: &cloudfront.CachedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, Compress: aws.Bool(true), DefaultTTL: aws.Int64(1), MaxTTL: aws.Int64(1), SmoothStreaming: aws.Bool(true), }, // More values... }, }, CustomErrorResponses: &cloudfront.CustomErrorResponses{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.CustomErrorResponse{ { // Required ErrorCode: aws.Int64(1), // Required ErrorCachingMinTTL: aws.Int64(1), ResponseCode: aws.String("string"), ResponsePagePath: aws.String("string"), }, // More values... }, }, DefaultRootObject: aws.String("string"), HttpVersion: aws.String("HttpVersion"), IsIPV6Enabled: aws.Bool(true), Logging: &cloudfront.LoggingConfig{ Bucket: aws.String("string"), // Required Enabled: aws.Bool(true), // Required IncludeCookies: aws.Bool(true), // Required Prefix: aws.String("string"), // Required }, PriceClass: aws.String("PriceClass"), Restrictions: &cloudfront.Restrictions{ GeoRestriction: &cloudfront.GeoRestriction{ // Required Quantity: aws.Int64(1), // Required RestrictionType: aws.String("GeoRestrictionType"), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, ViewerCertificate: &cloudfront.ViewerCertificate{ ACMCertificateArn: aws.String("string"), Certificate: aws.String("string"), CertificateSource: aws.String("CertificateSource"), CloudFrontDefaultCertificate: aws.Bool(true), IAMCertificateId: aws.String("string"), MinimumProtocolVersion: aws.String("MinimumProtocolVersion"), SSLSupportMethod: aws.String("SSLSupportMethod"), }, WebACLId: aws.String("string"), }, Tags: &cloudfront.Tags{ // Required Items: []*cloudfront.Tag{ { // Required Key: aws.String("TagKey"), // Required Value: aws.String("TagValue"), }, // More values... }, }, }, } resp, err := svc.CreateDistributionWithTags(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) CreateDistributionWithTagsRequest ¶
func (c *CloudFront) CreateDistributionWithTagsRequest(input *CreateDistributionWithTagsInput) (req *request.Request, output *CreateDistributionWithTagsOutput)
CreateDistributionWithTagsRequest generates a "aws/request.Request" representing the client's request for the CreateDistributionWithTags operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See CreateDistributionWithTags for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateDistributionWithTags method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the CreateDistributionWithTagsRequest method. req, resp := client.CreateDistributionWithTagsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) CreateInvalidation ¶
func (c *CloudFront) CreateInvalidation(input *CreateInvalidationInput) (*CreateInvalidationOutput, error)
* TooManyInvalidationsInProgress You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.
* InconsistentQuantities The value of Quantity and the size of Items do not match.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.CreateInvalidationInput{ DistributionId: aws.String("string"), // Required InvalidationBatch: &cloudfront.InvalidationBatch{ // Required CallerReference: aws.String("string"), // Required Paths: &cloudfront.Paths{ // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, } resp, err := svc.CreateInvalidation(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) CreateInvalidationRequest ¶
func (c *CloudFront) CreateInvalidationRequest(input *CreateInvalidationInput) (req *request.Request, output *CreateInvalidationOutput)
CreateInvalidationRequest generates a "aws/request.Request" representing the client's request for the CreateInvalidation operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See CreateInvalidation for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateInvalidation method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the CreateInvalidationRequest method. req, resp := client.CreateInvalidationRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) CreateStreamingDistribution ¶
func (c *CloudFront) CreateStreamingDistribution(input *CreateStreamingDistributionInput) (*CreateStreamingDistributionOutput, error)
* TooManyStreamingDistributions Processing your request would cause you to exceed the maximum number of streaming distributions allowed.
* InvalidArgument The argument is invalid.
* InconsistentQuantities The value of Quantity and the size of Items do not match.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.CreateStreamingDistributionInput{ StreamingDistributionConfig: &cloudfront.StreamingDistributionConfig{ // Required CallerReference: aws.String("string"), // Required Comment: aws.String("string"), // Required Enabled: aws.Bool(true), // Required S3Origin: &cloudfront.S3Origin{ // Required DomainName: aws.String("string"), // Required OriginAccessIdentity: aws.String("string"), // Required }, TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, Aliases: &cloudfront.Aliases{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, Logging: &cloudfront.StreamingLoggingConfig{ Bucket: aws.String("string"), // Required Enabled: aws.Bool(true), // Required Prefix: aws.String("string"), // Required }, PriceClass: aws.String("PriceClass"), }, } resp, err := svc.CreateStreamingDistribution(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) CreateStreamingDistributionRequest ¶
func (c *CloudFront) CreateStreamingDistributionRequest(input *CreateStreamingDistributionInput) (req *request.Request, output *CreateStreamingDistributionOutput)
CreateStreamingDistributionRequest generates a "aws/request.Request" representing the client's request for the CreateStreamingDistribution operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See CreateStreamingDistribution for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateStreamingDistribution method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the CreateStreamingDistributionRequest method. req, resp := client.CreateStreamingDistributionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) CreateStreamingDistributionWithTags ¶
func (c *CloudFront) CreateStreamingDistributionWithTags(input *CreateStreamingDistributionWithTagsInput) (*CreateStreamingDistributionWithTagsOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.CreateStreamingDistributionWithTagsInput{ StreamingDistributionConfigWithTags: &cloudfront.StreamingDistributionConfigWithTags{ // Required StreamingDistributionConfig: &cloudfront.StreamingDistributionConfig{ // Required CallerReference: aws.String("string"), // Required Comment: aws.String("string"), // Required Enabled: aws.Bool(true), // Required S3Origin: &cloudfront.S3Origin{ // Required DomainName: aws.String("string"), // Required OriginAccessIdentity: aws.String("string"), // Required }, TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, Aliases: &cloudfront.Aliases{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, Logging: &cloudfront.StreamingLoggingConfig{ Bucket: aws.String("string"), // Required Enabled: aws.Bool(true), // Required Prefix: aws.String("string"), // Required }, PriceClass: aws.String("PriceClass"), }, Tags: &cloudfront.Tags{ // Required Items: []*cloudfront.Tag{ { // Required Key: aws.String("TagKey"), // Required Value: aws.String("TagValue"), }, // More values... }, }, }, } resp, err := svc.CreateStreamingDistributionWithTags(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) CreateStreamingDistributionWithTagsRequest ¶
func (c *CloudFront) CreateStreamingDistributionWithTagsRequest(input *CreateStreamingDistributionWithTagsInput) (req *request.Request, output *CreateStreamingDistributionWithTagsOutput)
CreateStreamingDistributionWithTagsRequest generates a "aws/request.Request" representing the client's request for the CreateStreamingDistributionWithTags operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See CreateStreamingDistributionWithTags for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateStreamingDistributionWithTags method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the CreateStreamingDistributionWithTagsRequest method. req, resp := client.CreateStreamingDistributionWithTagsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) DeleteCloudFrontOriginAccessIdentity ¶
func (c *CloudFront) DeleteCloudFrontOriginAccessIdentity(input *DeleteCloudFrontOriginAccessIdentityInput) (*DeleteCloudFrontOriginAccessIdentityOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.DeleteCloudFrontOriginAccessIdentityInput{ Id: aws.String("string"), // Required IfMatch: aws.String("string"), } resp, err := svc.DeleteCloudFrontOriginAccessIdentity(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) DeleteCloudFrontOriginAccessIdentityRequest ¶
func (c *CloudFront) DeleteCloudFrontOriginAccessIdentityRequest(input *DeleteCloudFrontOriginAccessIdentityInput) (req *request.Request, output *DeleteCloudFrontOriginAccessIdentityOutput)
DeleteCloudFrontOriginAccessIdentityRequest generates a "aws/request.Request" representing the client's request for the DeleteCloudFrontOriginAccessIdentity operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See DeleteCloudFrontOriginAccessIdentity for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteCloudFrontOriginAccessIdentity method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the DeleteCloudFrontOriginAccessIdentityRequest method. req, resp := client.DeleteCloudFrontOriginAccessIdentityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) DeleteDistribution ¶
func (c *CloudFront) DeleteDistribution(input *DeleteDistributionInput) (*DeleteDistributionOutput, error)
* InvalidIfMatchVersion The If-Match version is missing or not valid for the distribution.
* NoSuchDistribution The specified distribution does not exist.
* PreconditionFailed The precondition given in one or more of the request-header fields evaluated to false.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.DeleteDistributionInput{ Id: aws.String("string"), // Required IfMatch: aws.String("string"), } resp, err := svc.DeleteDistribution(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) DeleteDistributionRequest ¶
func (c *CloudFront) DeleteDistributionRequest(input *DeleteDistributionInput) (req *request.Request, output *DeleteDistributionOutput)
DeleteDistributionRequest generates a "aws/request.Request" representing the client's request for the DeleteDistribution operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See DeleteDistribution for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteDistribution method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the DeleteDistributionRequest method. req, resp := client.DeleteDistributionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) DeleteStreamingDistribution ¶
func (c *CloudFront) DeleteStreamingDistribution(input *DeleteStreamingDistributionInput) (*DeleteStreamingDistributionOutput, error)
* InvalidIfMatchVersion The If-Match version is missing or not valid for the distribution.
* NoSuchStreamingDistribution The specified streaming distribution does not exist.
* PreconditionFailed The precondition given in one or more of the request-header fields evaluated to false.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.DeleteStreamingDistributionInput{ Id: aws.String("string"), // Required IfMatch: aws.String("string"), } resp, err := svc.DeleteStreamingDistribution(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) DeleteStreamingDistributionRequest ¶
func (c *CloudFront) DeleteStreamingDistributionRequest(input *DeleteStreamingDistributionInput) (req *request.Request, output *DeleteStreamingDistributionOutput)
DeleteStreamingDistributionRequest generates a "aws/request.Request" representing the client's request for the DeleteStreamingDistribution operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See DeleteStreamingDistribution for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteStreamingDistribution method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the DeleteStreamingDistributionRequest method. req, resp := client.DeleteStreamingDistributionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) GetCloudFrontOriginAccessIdentity ¶
func (c *CloudFront) GetCloudFrontOriginAccessIdentity(input *GetCloudFrontOriginAccessIdentityInput) (*GetCloudFrontOriginAccessIdentityOutput, error)
GetCloudFrontOriginAccessIdentity API operation for Amazon CloudFront.
Get the information about an origin access identity.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation GetCloudFrontOriginAccessIdentity for usage and error information.
Returned Error Codes:
NoSuchCloudFrontOriginAccessIdentity The specified origin access identity does not exist.
AccessDenied Access denied.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.GetCloudFrontOriginAccessIdentityInput{ Id: aws.String("string"), // Required } resp, err := svc.GetCloudFrontOriginAccessIdentity(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) GetCloudFrontOriginAccessIdentityConfig ¶
func (c *CloudFront) GetCloudFrontOriginAccessIdentityConfig(input *GetCloudFrontOriginAccessIdentityConfigInput) (*GetCloudFrontOriginAccessIdentityConfigOutput, error)
GetCloudFrontOriginAccessIdentityConfig API operation for Amazon CloudFront.
Get the configuration information about an origin access identity.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation GetCloudFrontOriginAccessIdentityConfig for usage and error information.
Returned Error Codes:
NoSuchCloudFrontOriginAccessIdentity The specified origin access identity does not exist.
AccessDenied Access denied.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.GetCloudFrontOriginAccessIdentityConfigInput{ Id: aws.String("string"), // Required } resp, err := svc.GetCloudFrontOriginAccessIdentityConfig(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) GetCloudFrontOriginAccessIdentityConfigRequest ¶
func (c *CloudFront) GetCloudFrontOriginAccessIdentityConfigRequest(input *GetCloudFrontOriginAccessIdentityConfigInput) (req *request.Request, output *GetCloudFrontOriginAccessIdentityConfigOutput)
GetCloudFrontOriginAccessIdentityConfigRequest generates a "aws/request.Request" representing the client's request for the GetCloudFrontOriginAccessIdentityConfig operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetCloudFrontOriginAccessIdentityConfig for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetCloudFrontOriginAccessIdentityConfig method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetCloudFrontOriginAccessIdentityConfigRequest method. req, resp := client.GetCloudFrontOriginAccessIdentityConfigRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) GetCloudFrontOriginAccessIdentityRequest ¶
func (c *CloudFront) GetCloudFrontOriginAccessIdentityRequest(input *GetCloudFrontOriginAccessIdentityInput) (req *request.Request, output *GetCloudFrontOriginAccessIdentityOutput)
GetCloudFrontOriginAccessIdentityRequest generates a "aws/request.Request" representing the client's request for the GetCloudFrontOriginAccessIdentity operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetCloudFrontOriginAccessIdentity for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetCloudFrontOriginAccessIdentity method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetCloudFrontOriginAccessIdentityRequest method. req, resp := client.GetCloudFrontOriginAccessIdentityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) GetDistribution ¶
func (c *CloudFront) GetDistribution(input *GetDistributionInput) (*GetDistributionOutput, error)
GetDistribution API operation for Amazon CloudFront.
Get the information about a distribution.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation GetDistribution for usage and error information.
Returned Error Codes:
NoSuchDistribution The specified distribution does not exist.
AccessDenied Access denied.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.GetDistributionInput{ Id: aws.String("string"), // Required } resp, err := svc.GetDistribution(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) GetDistributionConfig ¶
func (c *CloudFront) GetDistributionConfig(input *GetDistributionConfigInput) (*GetDistributionConfigOutput, error)
GetDistributionConfig API operation for Amazon CloudFront.
Get the configuration information about a distribution.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation GetDistributionConfig for usage and error information.
Returned Error Codes:
NoSuchDistribution The specified distribution does not exist.
AccessDenied Access denied.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.GetDistributionConfigInput{ Id: aws.String("string"), // Required } resp, err := svc.GetDistributionConfig(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) GetDistributionConfigRequest ¶
func (c *CloudFront) GetDistributionConfigRequest(input *GetDistributionConfigInput) (req *request.Request, output *GetDistributionConfigOutput)
GetDistributionConfigRequest generates a "aws/request.Request" representing the client's request for the GetDistributionConfig operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetDistributionConfig for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetDistributionConfig method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetDistributionConfigRequest method. req, resp := client.GetDistributionConfigRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) GetDistributionRequest ¶
func (c *CloudFront) GetDistributionRequest(input *GetDistributionInput) (req *request.Request, output *GetDistributionOutput)
GetDistributionRequest generates a "aws/request.Request" representing the client's request for the GetDistribution operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetDistribution for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetDistribution method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetDistributionRequest method. req, resp := client.GetDistributionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) GetInvalidation ¶
func (c *CloudFront) GetInvalidation(input *GetInvalidationInput) (*GetInvalidationOutput, error)
GetInvalidation API operation for Amazon CloudFront.
Get the information about an invalidation.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation GetInvalidation for usage and error information.
Returned Error Codes:
NoSuchInvalidation The specified invalidation does not exist.
NoSuchDistribution The specified distribution does not exist.
AccessDenied Access denied.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.GetInvalidationInput{ DistributionId: aws.String("string"), // Required Id: aws.String("string"), // Required } resp, err := svc.GetInvalidation(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) GetInvalidationRequest ¶
func (c *CloudFront) GetInvalidationRequest(input *GetInvalidationInput) (req *request.Request, output *GetInvalidationOutput)
GetInvalidationRequest generates a "aws/request.Request" representing the client's request for the GetInvalidation operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetInvalidation for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetInvalidation method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetInvalidationRequest method. req, resp := client.GetInvalidationRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) GetStreamingDistribution ¶
func (c *CloudFront) GetStreamingDistribution(input *GetStreamingDistributionInput) (*GetStreamingDistributionOutput, error)
GetStreamingDistribution API operation for Amazon CloudFront.
Gets information about a specified RTMP distribution, including the distribution configuration.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation GetStreamingDistribution for usage and error information.
Returned Error Codes:
NoSuchStreamingDistribution The specified streaming distribution does not exist.
AccessDenied Access denied.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.GetStreamingDistributionInput{ Id: aws.String("string"), // Required } resp, err := svc.GetStreamingDistribution(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) GetStreamingDistributionConfig ¶
func (c *CloudFront) GetStreamingDistributionConfig(input *GetStreamingDistributionConfigInput) (*GetStreamingDistributionConfigOutput, error)
GetStreamingDistributionConfig API operation for Amazon CloudFront.
Get the configuration information about a streaming distribution.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation GetStreamingDistributionConfig for usage and error information.
Returned Error Codes:
NoSuchStreamingDistribution The specified streaming distribution does not exist.
AccessDenied Access denied.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.GetStreamingDistributionConfigInput{ Id: aws.String("string"), // Required } resp, err := svc.GetStreamingDistributionConfig(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) GetStreamingDistributionConfigRequest ¶
func (c *CloudFront) GetStreamingDistributionConfigRequest(input *GetStreamingDistributionConfigInput) (req *request.Request, output *GetStreamingDistributionConfigOutput)
GetStreamingDistributionConfigRequest generates a "aws/request.Request" representing the client's request for the GetStreamingDistributionConfig operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetStreamingDistributionConfig for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetStreamingDistributionConfig method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetStreamingDistributionConfigRequest method. req, resp := client.GetStreamingDistributionConfigRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) GetStreamingDistributionRequest ¶
func (c *CloudFront) GetStreamingDistributionRequest(input *GetStreamingDistributionInput) (req *request.Request, output *GetStreamingDistributionOutput)
GetStreamingDistributionRequest generates a "aws/request.Request" representing the client's request for the GetStreamingDistribution operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetStreamingDistribution for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetStreamingDistribution method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetStreamingDistributionRequest method. req, resp := client.GetStreamingDistributionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) ListCloudFrontOriginAccessIdentities ¶
func (c *CloudFront) ListCloudFrontOriginAccessIdentities(input *ListCloudFrontOriginAccessIdentitiesInput) (*ListCloudFrontOriginAccessIdentitiesOutput, error)
ListCloudFrontOriginAccessIdentities API operation for Amazon CloudFront.
Lists origin access identities.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation ListCloudFrontOriginAccessIdentities for usage and error information.
Returned Error Codes:
- InvalidArgument The argument is invalid.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.ListCloudFrontOriginAccessIdentitiesInput{ Marker: aws.String("string"), MaxItems: aws.Int64(1), } resp, err := svc.ListCloudFrontOriginAccessIdentities(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) ListCloudFrontOriginAccessIdentitiesPages ¶
func (c *CloudFront) ListCloudFrontOriginAccessIdentitiesPages(input *ListCloudFrontOriginAccessIdentitiesInput, fn func(p *ListCloudFrontOriginAccessIdentitiesOutput, lastPage bool) (shouldContinue bool)) error
ListCloudFrontOriginAccessIdentitiesPages iterates over the pages of a ListCloudFrontOriginAccessIdentities operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.
See ListCloudFrontOriginAccessIdentities method for more information on how to use this operation.
Note: This operation can generate multiple requests to a service.
// Example iterating over at most 3 pages of a ListCloudFrontOriginAccessIdentities operation. pageNum := 0 err := client.ListCloudFrontOriginAccessIdentitiesPages(params, func(page *ListCloudFrontOriginAccessIdentitiesOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })
func (*CloudFront) ListCloudFrontOriginAccessIdentitiesRequest ¶
func (c *CloudFront) ListCloudFrontOriginAccessIdentitiesRequest(input *ListCloudFrontOriginAccessIdentitiesInput) (req *request.Request, output *ListCloudFrontOriginAccessIdentitiesOutput)
ListCloudFrontOriginAccessIdentitiesRequest generates a "aws/request.Request" representing the client's request for the ListCloudFrontOriginAccessIdentities operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See ListCloudFrontOriginAccessIdentities for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListCloudFrontOriginAccessIdentities method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the ListCloudFrontOriginAccessIdentitiesRequest method. req, resp := client.ListCloudFrontOriginAccessIdentitiesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) ListDistributions ¶
func (c *CloudFront) ListDistributions(input *ListDistributionsInput) (*ListDistributionsOutput, error)
ListDistributions API operation for Amazon CloudFront.
List distributions.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation ListDistributions for usage and error information.
Returned Error Codes:
- InvalidArgument The argument is invalid.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.ListDistributionsInput{ Marker: aws.String("string"), MaxItems: aws.Int64(1), } resp, err := svc.ListDistributions(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) ListDistributionsByWebACLId ¶
func (c *CloudFront) ListDistributionsByWebACLId(input *ListDistributionsByWebACLIdInput) (*ListDistributionsByWebACLIdOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.ListDistributionsByWebACLIdInput{ WebACLId: aws.String("string"), // Required Marker: aws.String("string"), MaxItems: aws.Int64(1), } resp, err := svc.ListDistributionsByWebACLId(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) ListDistributionsByWebACLIdRequest ¶
func (c *CloudFront) ListDistributionsByWebACLIdRequest(input *ListDistributionsByWebACLIdInput) (req *request.Request, output *ListDistributionsByWebACLIdOutput)
ListDistributionsByWebACLIdRequest generates a "aws/request.Request" representing the client's request for the ListDistributionsByWebACLId operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See ListDistributionsByWebACLId for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListDistributionsByWebACLId method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the ListDistributionsByWebACLIdRequest method. req, resp := client.ListDistributionsByWebACLIdRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) ListDistributionsPages ¶
func (c *CloudFront) ListDistributionsPages(input *ListDistributionsInput, fn func(p *ListDistributionsOutput, lastPage bool) (shouldContinue bool)) error
ListDistributionsPages iterates over the pages of a ListDistributions operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.
See ListDistributions method for more information on how to use this operation.
Note: This operation can generate multiple requests to a service.
// Example iterating over at most 3 pages of a ListDistributions operation. pageNum := 0 err := client.ListDistributionsPages(params, func(page *ListDistributionsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })
func (*CloudFront) ListDistributionsRequest ¶
func (c *CloudFront) ListDistributionsRequest(input *ListDistributionsInput) (req *request.Request, output *ListDistributionsOutput)
ListDistributionsRequest generates a "aws/request.Request" representing the client's request for the ListDistributions operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See ListDistributions for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListDistributions method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the ListDistributionsRequest method. req, resp := client.ListDistributionsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) ListInvalidations ¶
func (c *CloudFront) ListInvalidations(input *ListInvalidationsInput) (*ListInvalidationsOutput, error)
ListInvalidations API operation for Amazon CloudFront.
Lists invalidation batches.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation ListInvalidations for usage and error information.
Returned Error Codes:
InvalidArgument The argument is invalid.
NoSuchDistribution The specified distribution does not exist.
AccessDenied Access denied.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.ListInvalidationsInput{ DistributionId: aws.String("string"), // Required Marker: aws.String("string"), MaxItems: aws.Int64(1), } resp, err := svc.ListInvalidations(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) ListInvalidationsPages ¶
func (c *CloudFront) ListInvalidationsPages(input *ListInvalidationsInput, fn func(p *ListInvalidationsOutput, lastPage bool) (shouldContinue bool)) error
ListInvalidationsPages iterates over the pages of a ListInvalidations operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.
See ListInvalidations method for more information on how to use this operation.
Note: This operation can generate multiple requests to a service.
// Example iterating over at most 3 pages of a ListInvalidations operation. pageNum := 0 err := client.ListInvalidationsPages(params, func(page *ListInvalidationsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })
func (*CloudFront) ListInvalidationsRequest ¶
func (c *CloudFront) ListInvalidationsRequest(input *ListInvalidationsInput) (req *request.Request, output *ListInvalidationsOutput)
ListInvalidationsRequest generates a "aws/request.Request" representing the client's request for the ListInvalidations operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See ListInvalidations for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListInvalidations method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the ListInvalidationsRequest method. req, resp := client.ListInvalidationsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) ListStreamingDistributions ¶
func (c *CloudFront) ListStreamingDistributions(input *ListStreamingDistributionsInput) (*ListStreamingDistributionsOutput, error)
ListStreamingDistributions API operation for Amazon CloudFront.
List streaming distributions.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation ListStreamingDistributions for usage and error information.
Returned Error Codes:
- InvalidArgument The argument is invalid.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.ListStreamingDistributionsInput{ Marker: aws.String("string"), MaxItems: aws.Int64(1), } resp, err := svc.ListStreamingDistributions(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) ListStreamingDistributionsPages ¶
func (c *CloudFront) ListStreamingDistributionsPages(input *ListStreamingDistributionsInput, fn func(p *ListStreamingDistributionsOutput, lastPage bool) (shouldContinue bool)) error
ListStreamingDistributionsPages iterates over the pages of a ListStreamingDistributions operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.
See ListStreamingDistributions method for more information on how to use this operation.
Note: This operation can generate multiple requests to a service.
// Example iterating over at most 3 pages of a ListStreamingDistributions operation. pageNum := 0 err := client.ListStreamingDistributionsPages(params, func(page *ListStreamingDistributionsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })
func (*CloudFront) ListStreamingDistributionsRequest ¶
func (c *CloudFront) ListStreamingDistributionsRequest(input *ListStreamingDistributionsInput) (req *request.Request, output *ListStreamingDistributionsOutput)
ListStreamingDistributionsRequest generates a "aws/request.Request" representing the client's request for the ListStreamingDistributions operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See ListStreamingDistributions for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListStreamingDistributions method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the ListStreamingDistributionsRequest method. req, resp := client.ListStreamingDistributionsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) ListTagsForResource ¶
func (c *CloudFront) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.ListTagsForResourceInput{ Resource: aws.String("ResourceARN"), // Required } resp, err := svc.ListTagsForResource(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) ListTagsForResourceRequest ¶
func (c *CloudFront) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput)
ListTagsForResourceRequest generates a "aws/request.Request" representing the client's request for the ListTagsForResource operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See ListTagsForResource for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListTagsForResource method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the ListTagsForResourceRequest method. req, resp := client.ListTagsForResourceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) TagResource ¶
func (c *CloudFront) TagResource(input *TagResourceInput) (*TagResourceOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.TagResourceInput{ Resource: aws.String("ResourceARN"), // Required Tags: &cloudfront.Tags{ // Required Items: []*cloudfront.Tag{ { // Required Key: aws.String("TagKey"), // Required Value: aws.String("TagValue"), }, // More values... }, }, } resp, err := svc.TagResource(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) TagResourceRequest ¶
func (c *CloudFront) TagResourceRequest(input *TagResourceInput) (req *request.Request, output *TagResourceOutput)
TagResourceRequest generates a "aws/request.Request" representing the client's request for the TagResource operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See TagResource for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the TagResource method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the TagResourceRequest method. req, resp := client.TagResourceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) UntagResource ¶
func (c *CloudFront) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.UntagResourceInput{ Resource: aws.String("ResourceARN"), // Required TagKeys: &cloudfront.TagKeys{ // Required Items: []*string{ aws.String("TagKey"), // Required // More values... }, }, } resp, err := svc.UntagResource(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) UntagResourceRequest ¶
func (c *CloudFront) UntagResourceRequest(input *UntagResourceInput) (req *request.Request, output *UntagResourceOutput)
UntagResourceRequest generates a "aws/request.Request" representing the client's request for the UntagResource operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See UntagResource for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UntagResource method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the UntagResourceRequest method. req, resp := client.UntagResourceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) UpdateCloudFrontOriginAccessIdentity ¶
func (c *CloudFront) UpdateCloudFrontOriginAccessIdentity(input *UpdateCloudFrontOriginAccessIdentityInput) (*UpdateCloudFrontOriginAccessIdentityOutput, error)
UpdateCloudFrontOriginAccessIdentity API operation for Amazon CloudFront.
Update an origin access identity.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for Amazon CloudFront's API operation UpdateCloudFrontOriginAccessIdentity for usage and error information.
Returned Error Codes:
AccessDenied Access denied.
IllegalUpdate Origin and CallerReference cannot be updated.
InvalidIfMatchVersion The If-Match version is missing or not valid for the distribution.
MissingBody This operation requires a body. Ensure that the body is present and the Content-Type header is set.
NoSuchCloudFrontOriginAccessIdentity The specified origin access identity does not exist.
PreconditionFailed The precondition given in one or more of the request-header fields evaluated to false.
InvalidArgument The argument is invalid.
InconsistentQuantities The value of Quantity and the size of Items do not match.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.UpdateCloudFrontOriginAccessIdentityInput{ CloudFrontOriginAccessIdentityConfig: &cloudfront.OriginAccessIdentityConfig{ // Required CallerReference: aws.String("string"), // Required Comment: aws.String("string"), // Required }, Id: aws.String("string"), // Required IfMatch: aws.String("string"), } resp, err := svc.UpdateCloudFrontOriginAccessIdentity(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) UpdateCloudFrontOriginAccessIdentityRequest ¶
func (c *CloudFront) UpdateCloudFrontOriginAccessIdentityRequest(input *UpdateCloudFrontOriginAccessIdentityInput) (req *request.Request, output *UpdateCloudFrontOriginAccessIdentityOutput)
UpdateCloudFrontOriginAccessIdentityRequest generates a "aws/request.Request" representing the client's request for the UpdateCloudFrontOriginAccessIdentity operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See UpdateCloudFrontOriginAccessIdentity for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UpdateCloudFrontOriginAccessIdentity method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the UpdateCloudFrontOriginAccessIdentityRequest method. req, resp := client.UpdateCloudFrontOriginAccessIdentityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) UpdateDistribution ¶
func (c *CloudFront) UpdateDistribution(input *UpdateDistributionInput) (*UpdateDistributionOutput, error)
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.UpdateDistributionInput{ DistributionConfig: &cloudfront.DistributionConfig{ // Required CallerReference: aws.String("string"), // Required Comment: aws.String("string"), // Required DefaultCacheBehavior: &cloudfront.DefaultCacheBehavior{ // Required ForwardedValues: &cloudfront.ForwardedValues{ // Required Cookies: &cloudfront.CookiePreference{ // Required Forward: aws.String("ItemSelection"), // Required WhitelistedNames: &cloudfront.CookieNames{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, QueryString: aws.Bool(true), // Required Headers: &cloudfront.Headers{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, QueryStringCacheKeys: &cloudfront.QueryStringCacheKeys{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, MinTTL: aws.Int64(1), // Required TargetOriginId: aws.String("string"), // Required TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, ViewerProtocolPolicy: aws.String("ViewerProtocolPolicy"), // Required AllowedMethods: &cloudfront.AllowedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required CachedMethods: &cloudfront.CachedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, Compress: aws.Bool(true), DefaultTTL: aws.Int64(1), MaxTTL: aws.Int64(1), SmoothStreaming: aws.Bool(true), }, Enabled: aws.Bool(true), // Required Origins: &cloudfront.Origins{ // Required Quantity: aws.Int64(1), // Required Items: []*cloudfront.Origin{ { // Required DomainName: aws.String("string"), // Required Id: aws.String("string"), // Required CustomHeaders: &cloudfront.CustomHeaders{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.OriginCustomHeader{ { // Required HeaderName: aws.String("string"), // Required HeaderValue: aws.String("string"), // Required }, // More values... }, }, CustomOriginConfig: &cloudfront.CustomOriginConfig{ HTTPPort: aws.Int64(1), // Required HTTPSPort: aws.Int64(1), // Required OriginProtocolPolicy: aws.String("OriginProtocolPolicy"), // Required OriginSslProtocols: &cloudfront.OriginSslProtocols{ Items: []*string{ // Required aws.String("SslProtocol"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, OriginPath: aws.String("string"), S3OriginConfig: &cloudfront.S3OriginConfig{ OriginAccessIdentity: aws.String("string"), // Required }, }, // More values... }, }, Aliases: &cloudfront.Aliases{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, CacheBehaviors: &cloudfront.CacheBehaviors{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.CacheBehavior{ { // Required ForwardedValues: &cloudfront.ForwardedValues{ // Required Cookies: &cloudfront.CookiePreference{ // Required Forward: aws.String("ItemSelection"), // Required WhitelistedNames: &cloudfront.CookieNames{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, QueryString: aws.Bool(true), // Required Headers: &cloudfront.Headers{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, QueryStringCacheKeys: &cloudfront.QueryStringCacheKeys{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, MinTTL: aws.Int64(1), // Required PathPattern: aws.String("string"), // Required TargetOriginId: aws.String("string"), // Required TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, ViewerProtocolPolicy: aws.String("ViewerProtocolPolicy"), // Required AllowedMethods: &cloudfront.AllowedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required CachedMethods: &cloudfront.CachedMethods{ Items: []*string{ // Required aws.String("Method"), // Required // More values... }, Quantity: aws.Int64(1), // Required }, }, Compress: aws.Bool(true), DefaultTTL: aws.Int64(1), MaxTTL: aws.Int64(1), SmoothStreaming: aws.Bool(true), }, // More values... }, }, CustomErrorResponses: &cloudfront.CustomErrorResponses{ Quantity: aws.Int64(1), // Required Items: []*cloudfront.CustomErrorResponse{ { // Required ErrorCode: aws.Int64(1), // Required ErrorCachingMinTTL: aws.Int64(1), ResponseCode: aws.String("string"), ResponsePagePath: aws.String("string"), }, // More values... }, }, DefaultRootObject: aws.String("string"), HttpVersion: aws.String("HttpVersion"), IsIPV6Enabled: aws.Bool(true), Logging: &cloudfront.LoggingConfig{ Bucket: aws.String("string"), // Required Enabled: aws.Bool(true), // Required IncludeCookies: aws.Bool(true), // Required Prefix: aws.String("string"), // Required }, PriceClass: aws.String("PriceClass"), Restrictions: &cloudfront.Restrictions{ GeoRestriction: &cloudfront.GeoRestriction{ // Required Quantity: aws.Int64(1), // Required RestrictionType: aws.String("GeoRestrictionType"), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, }, ViewerCertificate: &cloudfront.ViewerCertificate{ ACMCertificateArn: aws.String("string"), Certificate: aws.String("string"), CertificateSource: aws.String("CertificateSource"), CloudFrontDefaultCertificate: aws.Bool(true), IAMCertificateId: aws.String("string"), MinimumProtocolVersion: aws.String("MinimumProtocolVersion"), SSLSupportMethod: aws.String("SSLSupportMethod"), }, WebACLId: aws.String("string"), }, Id: aws.String("string"), // Required IfMatch: aws.String("string"), } resp, err := svc.UpdateDistribution(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) UpdateDistributionRequest ¶
func (c *CloudFront) UpdateDistributionRequest(input *UpdateDistributionInput) (req *request.Request, output *UpdateDistributionOutput)
UpdateDistributionRequest generates a "aws/request.Request" representing the client's request for the UpdateDistribution operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See UpdateDistribution for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UpdateDistribution method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the UpdateDistributionRequest method. req, resp := client.UpdateDistributionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) UpdateStreamingDistribution ¶
func (c *CloudFront) UpdateStreamingDistribution(input *UpdateStreamingDistributionInput) (*UpdateStreamingDistributionOutput, error)
* InvalidArgument The argument is invalid.
* InvalidOriginAccessIdentity The origin access identity is not valid or doesn't exist.
* TooManyTrustedSigners Your request contains more trusted signers than are allowed per distribution.
* TrustedSignerDoesNotExist One or more of your trusted signers do not exist.
* InconsistentQuantities The value of Quantity and the size of Items do not match.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/cloudfront" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := cloudfront.New(sess) params := &cloudfront.UpdateStreamingDistributionInput{ Id: aws.String("string"), // Required StreamingDistributionConfig: &cloudfront.StreamingDistributionConfig{ // Required CallerReference: aws.String("string"), // Required Comment: aws.String("string"), // Required Enabled: aws.Bool(true), // Required S3Origin: &cloudfront.S3Origin{ // Required DomainName: aws.String("string"), // Required OriginAccessIdentity: aws.String("string"), // Required }, TrustedSigners: &cloudfront.TrustedSigners{ // Required Enabled: aws.Bool(true), // Required Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, Aliases: &cloudfront.Aliases{ Quantity: aws.Int64(1), // Required Items: []*string{ aws.String("string"), // Required // More values... }, }, Logging: &cloudfront.StreamingLoggingConfig{ Bucket: aws.String("string"), // Required Enabled: aws.Bool(true), // Required Prefix: aws.String("string"), // Required }, PriceClass: aws.String("PriceClass"), }, IfMatch: aws.String("string"), } resp, err := svc.UpdateStreamingDistribution(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*CloudFront) UpdateStreamingDistributionRequest ¶
func (c *CloudFront) UpdateStreamingDistributionRequest(input *UpdateStreamingDistributionInput) (req *request.Request, output *UpdateStreamingDistributionOutput)
UpdateStreamingDistributionRequest generates a "aws/request.Request" representing the client's request for the UpdateStreamingDistribution operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See UpdateStreamingDistribution for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UpdateStreamingDistribution method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the UpdateStreamingDistributionRequest method. req, resp := client.UpdateStreamingDistributionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*CloudFront) WaitUntilDistributionDeployed ¶
func (c *CloudFront) WaitUntilDistributionDeployed(input *GetDistributionInput) error
WaitUntilDistributionDeployed uses the CloudFront API operation GetDistribution to wait for a condition to be met before returning. If the condition is not meet within the max attempt window an error will be returned.
func (*CloudFront) WaitUntilInvalidationCompleted ¶
func (c *CloudFront) WaitUntilInvalidationCompleted(input *GetInvalidationInput) error
WaitUntilInvalidationCompleted uses the CloudFront API operation GetInvalidation to wait for a condition to be met before returning. If the condition is not meet within the max attempt window an error will be returned.
func (*CloudFront) WaitUntilStreamingDistributionDeployed ¶
func (c *CloudFront) WaitUntilStreamingDistributionDeployed(input *GetStreamingDistributionInput) error
WaitUntilStreamingDistributionDeployed uses the CloudFront API operation GetStreamingDistribution to wait for a condition to be met before returning. If the condition is not meet within the max attempt window an error will be returned.
type CookieNames ¶
type CookieNames struct { // A complex type that contains one Name element for each cookie that you want // CloudFront to forward to the origin for this cache behavior. Items []*string `locationNameList:"Name" type:"list"` // The number of different cookies that you want CloudFront to forward to the // origin for this cache behavior. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
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 (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Cookies.html) in the Amazon CloudFront Developer Guide.
func (CookieNames) GoString ¶
func (s CookieNames) GoString() string
GoString returns the string representation
func (CookieNames) String ¶
func (s CookieNames) String() string
String returns the string representation
func (*CookieNames) Validate ¶
func (s *CookieNames) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CookiePreference ¶
type CookiePreference struct { // Specifies which cookies to forward to the origin for this cache behavior: // all, none, or the list of cookies specified in the WhitelistedNames complex // type. // // Amazon S3 doesn't process cookies. When the cache behavior is forwarding // requests to an Amazon S3 origin, specify none for the Forward element. // // Forward is a required field Forward *string `type:"string" required:"true" enum:"ItemSelection"` // Required if you specify whitelist for the value of Forward:. A complex type // that specifies how many different cookies you want CloudFront to forward // to the origin for this cache behavior and, if you want to forward selected // cookies, the names of those cookies. // // If you specify all or none for the value of Forward, omit WhitelistedNames. // If you change the value of Forward from whitelist to all or none and you // don't delete the WhitelistedNames element and its child elements, CloudFront // deletes them automatically. // // For the current limit on the number of cookie names that you can whitelist // for each cache behavior, see Amazon CloudFront Limits (http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_cloudfront) // in the AWS General Reference. WhitelistedNames *CookieNames `type:"structure"` // contains filtered or unexported fields }
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 (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Cookies.html) in the Amazon CloudFront Developer Guide.
func (CookiePreference) GoString ¶
func (s CookiePreference) GoString() string
GoString returns the string representation
func (CookiePreference) String ¶
func (s CookiePreference) String() string
String returns the string representation
func (*CookiePreference) Validate ¶
func (s *CookiePreference) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateCloudFrontOriginAccessIdentityInput ¶
type CreateCloudFrontOriginAccessIdentityInput struct { // The current configuration information for the identity. // // CloudFrontOriginAccessIdentityConfig is a required field CloudFrontOriginAccessIdentityConfig *OriginAccessIdentityConfig `locationName:"CloudFrontOriginAccessIdentityConfig" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to create a new origin access identity.
func (CreateCloudFrontOriginAccessIdentityInput) GoString ¶
func (s CreateCloudFrontOriginAccessIdentityInput) GoString() string
GoString returns the string representation
func (CreateCloudFrontOriginAccessIdentityInput) String ¶
func (s CreateCloudFrontOriginAccessIdentityInput) String() string
String returns the string representation
func (*CreateCloudFrontOriginAccessIdentityInput) Validate ¶
func (s *CreateCloudFrontOriginAccessIdentityInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateCloudFrontOriginAccessIdentityOutput ¶
type CreateCloudFrontOriginAccessIdentityOutput struct { // The origin access identity's information. CloudFrontOriginAccessIdentity *OriginAccessIdentity `type:"structure"` // The current version of the origin access identity created. ETag *string `location:"header" locationName:"ETag" type:"string"` // The fully qualified URI of the new origin access identity just created. For // example: https://cloudfront.amazonaws.com/2010-11-01/origin-access-identity/cloudfront/E74FTE3AJFJ256A. Location *string `location:"header" locationName:"Location" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (CreateCloudFrontOriginAccessIdentityOutput) GoString ¶
func (s CreateCloudFrontOriginAccessIdentityOutput) GoString() string
GoString returns the string representation
func (CreateCloudFrontOriginAccessIdentityOutput) String ¶
func (s CreateCloudFrontOriginAccessIdentityOutput) String() string
String returns the string representation
type CreateDistributionInput ¶
type CreateDistributionInput struct { // The distribution's configuration information. // // DistributionConfig is a required field DistributionConfig *DistributionConfig `locationName:"DistributionConfig" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to create a new distribution.
func (CreateDistributionInput) GoString ¶
func (s CreateDistributionInput) GoString() string
GoString returns the string representation
func (CreateDistributionInput) String ¶
func (s CreateDistributionInput) String() string
String returns the string representation
func (*CreateDistributionInput) Validate ¶
func (s *CreateDistributionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateDistributionOutput ¶
type CreateDistributionOutput struct { // The distribution's information. Distribution *Distribution `type:"structure"` // The current version of the distribution created. ETag *string `location:"header" locationName:"ETag" type:"string"` // The fully qualified URI of the new distribution resource just created. For // example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5. Location *string `location:"header" locationName:"Location" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (CreateDistributionOutput) GoString ¶
func (s CreateDistributionOutput) GoString() string
GoString returns the string representation
func (CreateDistributionOutput) String ¶
func (s CreateDistributionOutput) String() string
String returns the string representation
type CreateDistributionWithTagsInput ¶
type CreateDistributionWithTagsInput struct { // The distribution's configuration information. // // DistributionConfigWithTags is a required field DistributionConfigWithTags *DistributionConfigWithTags `locationName:"DistributionConfigWithTags" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to create a new distribution with tags.
func (CreateDistributionWithTagsInput) GoString ¶
func (s CreateDistributionWithTagsInput) GoString() string
GoString returns the string representation
func (CreateDistributionWithTagsInput) String ¶
func (s CreateDistributionWithTagsInput) String() string
String returns the string representation
func (*CreateDistributionWithTagsInput) Validate ¶
func (s *CreateDistributionWithTagsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateDistributionWithTagsOutput ¶
type CreateDistributionWithTagsOutput struct { // The distribution's information. Distribution *Distribution `type:"structure"` // The current version of the distribution created. ETag *string `location:"header" locationName:"ETag" type:"string"` // The fully qualified URI of the new distribution resource just created. For // example: https://cloudfront.amazonaws.com/2010-11-01/distribution/EDFDVBD632BHDS5. Location *string `location:"header" locationName:"Location" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (CreateDistributionWithTagsOutput) GoString ¶
func (s CreateDistributionWithTagsOutput) GoString() string
GoString returns the string representation
func (CreateDistributionWithTagsOutput) String ¶
func (s CreateDistributionWithTagsOutput) String() string
String returns the string representation
type CreateInvalidationInput ¶
type CreateInvalidationInput struct { // The distribution's id. // // DistributionId is a required field DistributionId *string `location:"uri" locationName:"DistributionId" type:"string" required:"true"` // The batch information for the invalidation. // // InvalidationBatch is a required field InvalidationBatch *InvalidationBatch `locationName:"InvalidationBatch" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to create an invalidation.
func (CreateInvalidationInput) GoString ¶
func (s CreateInvalidationInput) GoString() string
GoString returns the string representation
func (CreateInvalidationInput) String ¶
func (s CreateInvalidationInput) String() string
String returns the string representation
func (*CreateInvalidationInput) Validate ¶
func (s *CreateInvalidationInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateInvalidationOutput ¶
type CreateInvalidationOutput struct { // The invalidation's information. Invalidation *Invalidation `type:"structure"` // The fully qualified URI of the distribution and invalidation batch request, // including the Invalidation ID. Location *string `location:"header" locationName:"Location" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (CreateInvalidationOutput) GoString ¶
func (s CreateInvalidationOutput) GoString() string
GoString returns the string representation
func (CreateInvalidationOutput) String ¶
func (s CreateInvalidationOutput) String() string
String returns the string representation
type CreateStreamingDistributionInput ¶
type CreateStreamingDistributionInput struct { // The streaming distribution's configuration information. // // StreamingDistributionConfig is a required field StreamingDistributionConfig *StreamingDistributionConfig `locationName:"StreamingDistributionConfig" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to create a new streaming distribution.
func (CreateStreamingDistributionInput) GoString ¶
func (s CreateStreamingDistributionInput) GoString() string
GoString returns the string representation
func (CreateStreamingDistributionInput) String ¶
func (s CreateStreamingDistributionInput) String() string
String returns the string representation
func (*CreateStreamingDistributionInput) Validate ¶
func (s *CreateStreamingDistributionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateStreamingDistributionOutput ¶
type CreateStreamingDistributionOutput struct { // The current version of the streaming distribution created. ETag *string `location:"header" locationName:"ETag" type:"string"` // The fully qualified URI of the new streaming distribution resource just created. // For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8. Location *string `location:"header" locationName:"Location" type:"string"` // The streaming distribution's information. StreamingDistribution *StreamingDistribution `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (CreateStreamingDistributionOutput) GoString ¶
func (s CreateStreamingDistributionOutput) GoString() string
GoString returns the string representation
func (CreateStreamingDistributionOutput) String ¶
func (s CreateStreamingDistributionOutput) String() string
String returns the string representation
type CreateStreamingDistributionWithTagsInput ¶
type CreateStreamingDistributionWithTagsInput struct { // The streaming distribution's configuration information. // // StreamingDistributionConfigWithTags is a required field StreamingDistributionConfigWithTags *StreamingDistributionConfigWithTags `locationName:"StreamingDistributionConfigWithTags" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to create a new streaming distribution with tags.
func (CreateStreamingDistributionWithTagsInput) GoString ¶
func (s CreateStreamingDistributionWithTagsInput) GoString() string
GoString returns the string representation
func (CreateStreamingDistributionWithTagsInput) String ¶
func (s CreateStreamingDistributionWithTagsInput) String() string
String returns the string representation
func (*CreateStreamingDistributionWithTagsInput) Validate ¶
func (s *CreateStreamingDistributionWithTagsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateStreamingDistributionWithTagsOutput ¶
type CreateStreamingDistributionWithTagsOutput struct { ETag *string `location:"header" locationName:"ETag" type:"string"` // The fully qualified URI of the new streaming distribution resource just created. // For example: https://cloudfront.amazonaws.com/2010-11-01/streaming-distribution/EGTXBD79H29TRA8. Location *string `location:"header" locationName:"Location" type:"string"` // The streaming distribution's information. StreamingDistribution *StreamingDistribution `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (CreateStreamingDistributionWithTagsOutput) GoString ¶
func (s CreateStreamingDistributionWithTagsOutput) GoString() string
GoString returns the string representation
func (CreateStreamingDistributionWithTagsOutput) String ¶
func (s CreateStreamingDistributionWithTagsOutput) String() string
String returns the string representation
type CustomErrorResponse ¶
type CustomErrorResponse struct { // The minimum amount of time, in seconds, that you want CloudFront to cache // the HTTP status code specified in ErrorCode. When this time period has elapsed, // CloudFront queries your origin to see whether the problem that caused the // error has been resolved and the requested object is now available. // // If you don't want to specify a value, include an empty element, <ErrorCachingMinTTL>, // in the XML document. // // For more information, see Customizing Error Responses (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html) // in the Amazon CloudFront Developer Guide. ErrorCachingMinTTL *int64 `type:"long"` // The HTTP status code for which you want to specify a custom error page and/or // a caching duration. // // ErrorCode is a required field ErrorCode *int64 `type:"integer" required:"true"` // The HTTP status code that you want CloudFront to return to the viewer along // with the custom error page. There are a variety of reasons that you might // want CloudFront to return a status code different from the status code that // your origin returned to CloudFront, for example: // // * Some Internet devices (some firewalls and corporate proxies, for example) // intercept HTTP 4xx and 5xx and prevent the response from being returned // to the viewer. If you substitute 200, the response typically won't be // intercepted. // // * If you don't care about distinguishing among different client errors // or server errors, you can specify 400 or 500 as the ResponseCode for all // 4xx or 5xx errors. // // * You might want to return a 200 status code (OK) and static website so // your customers don't know that your website is down. // // If you specify a value for ResponseCode, you must also specify a value for // ResponsePagePath. If you don't want to specify a value, include an empty // element, <ResponseCode>, in the XML document. ResponseCode *string `type:"string"` // The path to the custom error page that you want CloudFront to return to a // viewer when your origin returns the HTTP status code specified by ErrorCode, // for example, /4xx-errors/403-forbidden.html. If you want to store your objects // and your custom error pages in different locations, your distribution must // include a cache behavior for which the following is true: // // * The value of PathPattern matches the path to your custom error messages. // For example, suppose you saved custom error pages for 4xx errors in an // Amazon S3 bucket in a directory named /4xx-errors. Your distribution must // include a cache behavior for which the path pattern routes requests for // your custom error pages to that location, for example, /4xx-errors/*. // // // * The value of TargetOriginId specifies the value of the ID element for // the origin that contains your custom error pages. // // If you specify a value for ResponsePagePath, you must also specify a value // for ResponseCode. If you don't want to specify a value, include an empty // element, <ResponsePagePath>, in the XML document. // // We recommend that you store custom error pages in an Amazon S3 bucket. If // you store custom error pages on an HTTP server and the server starts to return // 5xx errors, CloudFront can't get the files that you want to return to viewers // because the origin server is unavailable. ResponsePagePath *string `type:"string"` // contains filtered or unexported fields }
A complex type that controls:
Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
For more information about custom error pages, see Customizing Error Responses (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html) in the Amazon CloudFront Developer Guide.
func (CustomErrorResponse) GoString ¶
func (s CustomErrorResponse) GoString() string
GoString returns the string representation
func (CustomErrorResponse) String ¶
func (s CustomErrorResponse) String() string
String returns the string representation
func (*CustomErrorResponse) Validate ¶
func (s *CustomErrorResponse) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CustomErrorResponses ¶
type CustomErrorResponses struct { // A complex type that contains a CustomErrorResponse element for each HTTP // status code for which you want to specify a custom error page and/or a caching // duration. Items []*CustomErrorResponse `locationNameList:"CustomErrorResponse" type:"list"` // The number of HTTP status codes for which you want to specify a custom error // page and/or a caching duration. If Quantity is 0, you can omit Items. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that controls:
Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
For more information about custom error pages, see Customizing Error Responses (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html) in the Amazon CloudFront Developer Guide.
func (CustomErrorResponses) GoString ¶
func (s CustomErrorResponses) GoString() string
GoString returns the string representation
func (CustomErrorResponses) String ¶
func (s CustomErrorResponses) String() string
String returns the string representation
func (*CustomErrorResponses) Validate ¶
func (s *CustomErrorResponses) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CustomHeaders ¶
type CustomHeaders struct { // Optional: A list that contains one OriginCustomHeader element for each custom // header that you want CloudFront to forward to the origin. If Quantity is // 0, omit Items. Items []*OriginCustomHeader `locationNameList:"OriginCustomHeader" type:"list"` // The number of custom headers, if any, for this distribution. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that contains the list of Custom Headers for each origin.
func (CustomHeaders) GoString ¶
func (s CustomHeaders) GoString() string
GoString returns the string representation
func (CustomHeaders) String ¶
func (s CustomHeaders) String() string
String returns the string representation
func (*CustomHeaders) Validate ¶
func (s *CustomHeaders) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CustomOriginConfig ¶
type CustomOriginConfig struct { // The HTTP port the custom origin listens on. // // HTTPPort is a required field HTTPPort *int64 `type:"integer" required:"true"` // The HTTPS port the custom origin listens on. // // HTTPSPort is a required field HTTPSPort *int64 `type:"integer" required:"true"` // The origin protocol policy to apply to your origin. // // OriginProtocolPolicy is a required field OriginProtocolPolicy *string `type:"string" required:"true" enum:"OriginProtocolPolicy"` // The SSL/TLS protocols that you want CloudFront to use when communicating // with your origin over HTTPS. OriginSslProtocols *OriginSslProtocols `type:"structure"` // contains filtered or unexported fields }
A customer origin.
func (CustomOriginConfig) GoString ¶
func (s CustomOriginConfig) GoString() string
GoString returns the string representation
func (CustomOriginConfig) String ¶
func (s CustomOriginConfig) String() string
String returns the string representation
func (*CustomOriginConfig) Validate ¶
func (s *CustomOriginConfig) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DefaultCacheBehavior ¶
type DefaultCacheBehavior struct { // 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: // // * CloudFront forwards only GET and HEAD requests. // // * CloudFront forwards only GET, HEAD, and OPTIONS requests. // // * CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, and DELETE // requests. // // 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. AllowedMethods *AllowedMethods `type:"structure"` // Whether you want CloudFront to automatically compress certain files for this // cache behavior. If so, specify true; if not, specify false. For more information, // see Serving Compressed Files (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/ServingCompressedFiles.html) // in the Amazon CloudFront Developer Guide. Compress *bool `type:"boolean"` // The default amount of time that you want objects to stay in CloudFront caches // before CloudFront forwards another request to your origin to determine whether // the object has been updated. The value that you specify applies only when // your origin does not add HTTP headers such as Cache-Control max-age, Cache-Control // s-maxage, and Expires to objects. For more information, see Specifying How // Long Objects and Errors Stay in a CloudFront Edge Cache (Expiration) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) // in the Amazon CloudFront Developer Guide. DefaultTTL *int64 `type:"long"` // A complex type that specifies how CloudFront handles query strings and cookies. // // ForwardedValues is a required field ForwardedValues *ForwardedValues `type:"structure" required:"true"` MaxTTL *int64 `type:"long"` // The minimum amount of time that you want objects to stay in CloudFront caches // before CloudFront forwards another request to your origin to determine whether // the object has been updated. For more information, see Specifying How Long // Objects and Errors Stay in a CloudFront Edge Cache (Expiration) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) // in the Amazon Amazon CloudFront Developer Guide. // // You must specify 0 for MinTTL if you configure CloudFront to forward all // headers to your origin (under Headers, if you specify 1 for Quantity and // * for Name). // // MinTTL is a required field MinTTL *int64 `type:"long" required:"true"` // Indicates whether you want to distribute media files in the Microsoft Smooth // Streaming format using the origin that is associated with this cache behavior. // If so, specify true; if not, specify false. If you specify true for SmoothStreaming, // you can still distribute other content using this cache behavior if the content // matches the value of PathPattern. SmoothStreaming *bool `type:"boolean"` // The value of ID for the origin that you want CloudFront to route requests // to when a request matches the path pattern either for a cache behavior or // for the default cache behavior. // // TargetOriginId is a required field TargetOriginId *string `type:"string" required:"true"` // 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 PathPattern for this cache behavior, specify true for // Enabled, and specify the applicable values for Quantity and Items. For more // information, see Serving Private Content through CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) // in the Amazon Amazon CloudFront Developer Guide. // // If you don't want to require signed URLs in requests for objects that match // PathPattern, specify false for Enabled and 0 for Quantity. Omit Items. // // To add, change, or remove one or more trusted signers, change Enabled to // true (if it's currently false), change Quantity as applicable, and specify // all of the trusted signers that you want to include in the updated distribution. // // TrustedSigners is a required field TrustedSigners *TrustedSigners `type:"structure" required:"true"` // The protocol that viewers can use to access the files in the origin specified // by TargetOriginId when a request matches the path pattern in PathPattern. // You can specify the following options: // // * allow-all: Viewers can use HTTP or HTTPS. // // * redirect-to-https: If a viewer submits an HTTP request, CloudFront returns // an HTTP status code of 301 (Moved Permanently) to the viewer along with // the HTTPS URL. The viewer then resubmits the request using the new URL. // // * https-only: If a viewer sends an HTTP request, CloudFront returns an // HTTP status code of 403 (Forbidden). // // For more information about requiring the HTTPS protocol, see Using an HTTPS // Connection to Access Your Objects (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html) // in the Amazon CloudFront Developer Guide. // // The only way to guarantee that viewers retrieve an object that was fetched // from the origin using HTTPS is never to use any other protocol to fetch the // object. If you have recently changed from HTTP to HTTPS, we recommend that // you clear your objects' cache because cached objects are protocol agnostic. // That means that an edge location will return an object from the cache regardless // of whether the current request protocol matches the protocol used previously. // For more information, see Specifying How Long Objects and Errors Stay in // a CloudFront Edge Cache (Expiration) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) // in the Amazon CloudFront Developer Guide. // // ViewerProtocolPolicy is a required field ViewerProtocolPolicy *string `type:"string" required:"true" enum:"ViewerProtocolPolicy"` // contains filtered or unexported fields }
A complex type that describes the default cache behavior if you do not specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.
func (DefaultCacheBehavior) GoString ¶
func (s DefaultCacheBehavior) GoString() string
GoString returns the string representation
func (DefaultCacheBehavior) String ¶
func (s DefaultCacheBehavior) String() string
String returns the string representation
func (*DefaultCacheBehavior) Validate ¶
func (s *DefaultCacheBehavior) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteCloudFrontOriginAccessIdentityInput ¶
type DeleteCloudFrontOriginAccessIdentityInput struct { // The origin access identity's ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // The value of the ETag header you received from a previous GET or PUT request. // For example: E2QWRUHAPOMQZL. IfMatch *string `location:"header" locationName:"If-Match" type:"string"` // contains filtered or unexported fields }
Deletes a origin access identity.
func (DeleteCloudFrontOriginAccessIdentityInput) GoString ¶
func (s DeleteCloudFrontOriginAccessIdentityInput) GoString() string
GoString returns the string representation
func (DeleteCloudFrontOriginAccessIdentityInput) String ¶
func (s DeleteCloudFrontOriginAccessIdentityInput) String() string
String returns the string representation
func (*DeleteCloudFrontOriginAccessIdentityInput) Validate ¶
func (s *DeleteCloudFrontOriginAccessIdentityInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteCloudFrontOriginAccessIdentityOutput ¶
type DeleteCloudFrontOriginAccessIdentityOutput struct {
// contains filtered or unexported fields
}
func (DeleteCloudFrontOriginAccessIdentityOutput) GoString ¶
func (s DeleteCloudFrontOriginAccessIdentityOutput) GoString() string
GoString returns the string representation
func (DeleteCloudFrontOriginAccessIdentityOutput) String ¶
func (s DeleteCloudFrontOriginAccessIdentityOutput) String() string
String returns the string representation
type DeleteDistributionInput ¶
type DeleteDistributionInput struct { // The distribution ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // The value of the ETag header that you received when you disabled the distribution. // For example: E2QWRUHAPOMQZL. IfMatch *string `location:"header" locationName:"If-Match" type:"string"` // contains filtered or unexported fields }
This action deletes a web distribution. To delete a web distribution using the CloudFront API, perform the following steps.
To delete a web distribution using the CloudFront API:
Disable the web distribution ¶
Submit a GET Distribution Config request to get the current configuration and the Etag header for the distribution.
Update the XML document that was returned in the response to your GET Distribution Config request to change the value of Enabled to false.
Submit a PUT Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 2.
Review the response to the PUT Distribution Config request to confirm that the distribution was successfully disabled.
Submit a GET Distribution request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.
Submit a DELETE Distribution request. Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Distribution Config request in Step 6.
Review the response to your DELETE Distribution request to confirm that the distribution was successfully deleted.
For information about deleting a distribution using the CloudFront console, see Deleting a Distribution (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/HowToDeleteDistribution.html) in the Amazon CloudFront Developer Guide.
func (DeleteDistributionInput) GoString ¶
func (s DeleteDistributionInput) GoString() string
GoString returns the string representation
func (DeleteDistributionInput) String ¶
func (s DeleteDistributionInput) String() string
String returns the string representation
func (*DeleteDistributionInput) Validate ¶
func (s *DeleteDistributionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteDistributionOutput ¶
type DeleteDistributionOutput struct {
// contains filtered or unexported fields
}
func (DeleteDistributionOutput) GoString ¶
func (s DeleteDistributionOutput) GoString() string
GoString returns the string representation
func (DeleteDistributionOutput) String ¶
func (s DeleteDistributionOutput) String() string
String returns the string representation
type DeleteStreamingDistributionInput ¶
type DeleteStreamingDistributionInput struct { // The distribution ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // The value of the ETag header that you received when you disabled the streaming // distribution. For example: E2QWRUHAPOMQZL. IfMatch *string `location:"header" locationName:"If-Match" type:"string"` // contains filtered or unexported fields }
The request to delete a streaming distribution.
func (DeleteStreamingDistributionInput) GoString ¶
func (s DeleteStreamingDistributionInput) GoString() string
GoString returns the string representation
func (DeleteStreamingDistributionInput) String ¶
func (s DeleteStreamingDistributionInput) String() string
String returns the string representation
func (*DeleteStreamingDistributionInput) Validate ¶
func (s *DeleteStreamingDistributionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteStreamingDistributionOutput ¶
type DeleteStreamingDistributionOutput struct {
// contains filtered or unexported fields
}
func (DeleteStreamingDistributionOutput) GoString ¶
func (s DeleteStreamingDistributionOutput) GoString() string
GoString returns the string representation
func (DeleteStreamingDistributionOutput) String ¶
func (s DeleteStreamingDistributionOutput) String() string
String returns the string representation
type Distribution ¶
type Distribution struct { // The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, // where 123456789012 is your AWS account ID. // // ARN is a required field ARN *string `type:"string" required:"true"` // CloudFront automatically adds this element to the response only if you've // set up the distribution to serve private content with signed URLs. The element // lists the key pair IDs that CloudFront is aware of for each trusted signer. // The Signer child element lists the AWS account number of the trusted signer // (or an empty Self element if the signer is you). The Signer element also // includes the IDs of any active key pairs associated with the trusted signer's // AWS account. If no KeyPairId element appears for a Signer, that signer can't // create working signed URLs. // // ActiveTrustedSigners is a required field ActiveTrustedSigners *ActiveTrustedSigners `type:"structure" required:"true"` // The current configuration information for the distribution. Send a GET request // to the /CloudFront API version/distribution ID/config resource. // // DistributionConfig is a required field DistributionConfig *DistributionConfig `type:"structure" required:"true"` // The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net. // // DomainName is a required field DomainName *string `type:"string" required:"true"` // The identifier for the distribution. For example: EDFDVBD632BHDS5. // // Id is a required field Id *string `type:"string" required:"true"` // The number of invalidation batches currently in progress. // // InProgressInvalidationBatches is a required field InProgressInvalidationBatches *int64 `type:"integer" required:"true"` // The date and time the distribution was last modified. // // LastModifiedTime is a required field LastModifiedTime *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"` // This response element indicates the current status of the distribution. When // the status is Deployed, the distribution's information is fully propagated // to all CloudFront edge locations. // // Status is a required field Status *string `type:"string" required:"true"` // contains filtered or unexported fields }
The distribution's information.
func (Distribution) GoString ¶
func (s Distribution) GoString() string
GoString returns the string representation
func (Distribution) String ¶
func (s Distribution) String() string
String returns the string representation
type DistributionConfig ¶
type DistributionConfig struct { // A complex type that contains information about CNAMEs (alternate domain names), // if any, for this distribution. Aliases *Aliases `type:"structure"` // A complex type that contains zero or more CacheBehavior elements. CacheBehaviors *CacheBehaviors `type:"structure"` // A unique value (for example, a date-time stamp) that ensures that the request // can't be replayed. // // If the value of CallerReference is new (regardless of the content of the // DistributionConfig object), CloudFront creates a new distribution. // // If CallerReference is a value you already sent in a previous request to create // a distribution, and if the content of the DistributionConfig is identical // to the original request (ignoring white space), CloudFront returns the same // the response that it returned to the original request. // // If CallerReference is a value you already sent in a previous request to create // a distribution but the content of the DistributionConfig is different from // the original request, CloudFront returns a DistributionAlreadyExists error. // // CallerReference is a required field CallerReference *string `type:"string" required:"true"` // Any comments you want to include about the distribution. // // If you don't want to specify a comment, include an empty Comment element. // // To delete an existing comment, update the distribution configuration and // include an empty Comment element. // // To add or change a comment, update the distribution configuration and specify // the new comment. // // Comment is a required field Comment *string `type:"string" required:"true"` // A complex type that controls the following: // // * Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range // with custom error messages before returning the response to the viewer. // // * How long CloudFront caches HTTP status codes in the 4xx and 5xx range. // // For more information about custom error pages, see Customizing Error Responses // (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html) // in the Amazon CloudFront Developer Guide. CustomErrorResponses *CustomErrorResponses `type:"structure"` // A complex type that describes the default cache behavior if you do not specify // a CacheBehavior element or if files don't match any of the values of PathPattern // in CacheBehavior elements. You must create exactly one default cache behavior. // // DefaultCacheBehavior is a required field DefaultCacheBehavior *DefaultCacheBehavior `type:"structure" required:"true"` // The object that you want CloudFront to request from your origin (for example, // index.html) when a viewer requests the root URL for your distribution (http://www.example.com) // instead of an object in your distribution (http://www.example.com/product-description.html). // Specifying a default root object avoids exposing the contents of your distribution. // // Specify only the object name, for example, index.html. Do not add a / before // the object name. // // If you don't want to specify a default root object when you create a distribution, // include an empty DefaultRootObject element. // // To delete the default root object from an existing distribution, update the // distribution configuration and include an empty DefaultRootObject element. // // To replace the default root object, update the distribution configuration // and specify the new object. // // For more information about the default root object, see Creating a Default // Root Object (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/DefaultRootObject.html) // in the Amazon CloudFront Developer Guide. DefaultRootObject *string `type:"string"` // Specifies whether you want CloudFront to save access logs to an Amazon S3 // bucket. // // If you do not want to enable logging when you create a distribution, or if // you want to disable logging for an existing distribution, specify false for // Enabled, and specify empty Bucket and Prefix elements. // // If you specify false for Enabled but you specify values for Bucket and Prefix, // the values are automatically deleted. // // Enabled is a required field Enabled *bool `type:"boolean" required:"true"` // (Optional) Specify the maximum HTTP version that you want viewers to use // to communicate with CloudFront. The default value for new web distributions // is http2. Viewers that don't support HTTP/2 automatically use an earlier // HTTP version. // // For viewers and CloudFront to use HTTP/2, viewers must support TLS 1.2 or // later, and must support Server Name Identification (SNI). // // In general, configuring CloudFront to communicate with viewers using HTTP/2 // reduces latency. You can improve performance by optimizing for HTTP/2. For // more information, do an Internet search for "http/2 optimization." HttpVersion *string `type:"string" enum:"HttpVersion"` // If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address // for your distribution, specify true. If you specify false, CloudFront responds // to IPv6 DNS requests with the DNS response code NOERROR and with no IP addresses. // This allows viewers to submit a second request, for an IPv4 address for your // distribution. // // In general, you should enable IPv6 if you have users on IPv6 networks who // want to access your content. However, if you're using signed URLs or signed // cookies to restrict access to your content, and if you're using a custom // policy that includes the IpAddress parameter to restrict the IP addresses // that can access your content, do not enable IPv6. If you want to restrict // access to some content by IP address and not restrict access to other content // (or restrict access but not by IP address), you can create two distributions. // For more information, see Creating a Signed URL Using a Custom Policy (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-creating-signed-url-custom-policy.html) // in the Amazon CloudFront Developer Guide. // // If you're using an Amazon Route 53 alias resource record set to route traffic // to your CloudFront distribution, you need to create a second alias resource // record set when both of the following are true: // // * You enable IPv6 for the distribution // // * You're using alternate domain names in the URLs for your objects // // For more information, see Routing Traffic to an Amazon CloudFront Web Distribution // by Using Your Domain Name (http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html) // in the Amazon Route 53 Developer Guide. // // If you created a CNAME resource record set, either with Amazon Route 53 or // with another DNS service, you don't need to make any changes. A CNAME record // will route traffic to your distribution regardless of the IP address format // of the viewer request. IsIPV6Enabled *bool `type:"boolean"` // A complex type that controls whether access logs are written for the distribution. // // For more information about logging, see Access Logs (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html) // in the Amazon CloudFront Developer Guide. Logging *LoggingConfig `type:"structure"` // A complex type that contains information about origins for this distribution. // // Origins is a required field Origins *Origins `type:"structure" required:"true"` // The price class that corresponds with the maximum price that you want to // pay for CloudFront service. If you specify PriceClass_All, CloudFront responds // to requests for your objects from all CloudFront edge locations. // // If you specify a price class other than PriceClass_All, CloudFront serves // your objects from the CloudFront edge location that has the lowest latency // among the edge locations in your price class. Viewers who are in or near // regions that are excluded from your specified price class may encounter slower // performance. // // For more information about price classes, see Choosing the Price Class for // a CloudFront Distribution (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PriceClass.html) // in the Amazon CloudFront Developer Guide. For information about CloudFront // pricing, including how price classes map to CloudFront regions, see Amazon // CloudFront Pricing (https://aws.amazon.com/cloudfront/pricing/). PriceClass *string `type:"string" enum:"PriceClass"` // A complex type that identifies ways in which you want to restrict distribution // of your content. Restrictions *Restrictions `type:"structure"` // A complex type that specifies the following: // // * Which SSL/TLS certificate to use when viewers request objects using // HTTPS // // * Whether you want CloudFront to use dedicated IP addresses or SNI when // you're using alternate domain names in your object names // // * The minimum protocol version that you want CloudFront to use when communicating // with viewers // // For more information, see Using an HTTPS Connection to Access Your Objects // (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html) // in the Amazon Amazon CloudFront Developer Guide. ViewerCertificate *ViewerCertificate `type:"structure"` // A unique identifier that specifies the AWS WAF web ACL, if any, to associate // with this distribution. // // AWS WAF is a web application firewall that lets you monitor the HTTP and // HTTPS requests that are forwarded to CloudFront, and lets you control access // to your content. Based on conditions that you specify, such as the IP addresses // that requests originate from or the values of query strings, CloudFront responds // to requests either with the requested content or with an HTTP 403 status // code (Forbidden). You can also configure CloudFront to return a custom error // page when a request is blocked. For more information about AWS WAF, see the // AWS WAF Developer Guide (http://docs.aws.amazon.com/waf/latest/developerguide/what-is-aws-waf.html). WebACLId *string `type:"string"` // contains filtered or unexported fields }
A distribution configuration.
func (DistributionConfig) GoString ¶
func (s DistributionConfig) GoString() string
GoString returns the string representation
func (DistributionConfig) String ¶
func (s DistributionConfig) String() string
String returns the string representation
func (*DistributionConfig) Validate ¶
func (s *DistributionConfig) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DistributionConfigWithTags ¶
type DistributionConfigWithTags struct { // A distribution configuration. // // DistributionConfig is a required field DistributionConfig *DistributionConfig `type:"structure" required:"true"` // A complex type that contains zero or more Tag elements. // // Tags is a required field Tags *Tags `type:"structure" required:"true"` // contains filtered or unexported fields }
A distribution Configuration and a list of tags to be associated with the distribution.
func (DistributionConfigWithTags) GoString ¶
func (s DistributionConfigWithTags) GoString() string
GoString returns the string representation
func (DistributionConfigWithTags) String ¶
func (s DistributionConfigWithTags) String() string
String returns the string representation
func (*DistributionConfigWithTags) Validate ¶
func (s *DistributionConfigWithTags) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DistributionList ¶
type DistributionList struct { // A flag that indicates whether more distributions remain to be listed. If // your results were truncated, you can make a follow-up pagination request // using the Marker request parameter to retrieve more distributions in the // list. // // IsTruncated is a required field IsTruncated *bool `type:"boolean" required:"true"` // A complex type that contains one DistributionSummary element for each distribution // that was created by the current AWS account. Items []*DistributionSummary `locationNameList:"DistributionSummary" type:"list"` // The value you provided for the Marker request parameter. // // Marker is a required field Marker *string `type:"string" required:"true"` // The value you provided for the MaxItems request parameter. // // MaxItems is a required field MaxItems *int64 `type:"integer" required:"true"` // If IsTruncated is true, this element is present and contains the value you // can use for the Marker request parameter to continue listing your distributions // where they left off. NextMarker *string `type:"string"` // The number of distributions that were created by the current AWS account. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A distribution list.
func (DistributionList) GoString ¶
func (s DistributionList) GoString() string
GoString returns the string representation
func (DistributionList) String ¶
func (s DistributionList) String() string
String returns the string representation
type DistributionSummary ¶
type DistributionSummary struct { // The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, // where 123456789012 is your AWS account ID. // // ARN is a required field ARN *string `type:"string" required:"true"` // A complex type that contains information about CNAMEs (alternate domain names), // if any, for this distribution. // // Aliases is a required field Aliases *Aliases `type:"structure" required:"true"` // A complex type that contains zero or more CacheBehavior elements. // // CacheBehaviors is a required field CacheBehaviors *CacheBehaviors `type:"structure" required:"true"` // The comment originally specified when this distribution was created. // // Comment is a required field Comment *string `type:"string" required:"true"` // A complex type that contains zero or more CustomErrorResponses elements. // // CustomErrorResponses is a required field CustomErrorResponses *CustomErrorResponses `type:"structure" required:"true"` // A complex type that describes the default cache behavior if you do not specify // a CacheBehavior element or if files don't match any of the values of PathPattern // in CacheBehavior elements. You must create exactly one default cache behavior. // // DefaultCacheBehavior is a required field DefaultCacheBehavior *DefaultCacheBehavior `type:"structure" required:"true"` // The domain name that corresponds to the distribution. For example: d604721fxaaqy9.cloudfront.net. // // DomainName is a required field DomainName *string `type:"string" required:"true"` // Whether the distribution is enabled to accept user requests for content. // // Enabled is a required field Enabled *bool `type:"boolean" required:"true"` // Specify the maximum HTTP version that you want viewers to use to communicate // with CloudFront. The default value for new web distributions is http2. Viewers // that don't support HTTP/2 will automatically use an earlier version. // // HttpVersion is a required field HttpVersion *string `type:"string" required:"true" enum:"HttpVersion"` // The identifier for the distribution. For example: EDFDVBD632BHDS5. // // Id is a required field Id *string `type:"string" required:"true"` // Whether CloudFront responds to IPv6 DNS requests with an IPv6 address for // your distribution. // // IsIPV6Enabled is a required field IsIPV6Enabled *bool `type:"boolean" required:"true"` // The date and time the distribution was last modified. // // LastModifiedTime is a required field LastModifiedTime *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"` // A complex type that contains information about origins for this distribution. // // Origins is a required field Origins *Origins `type:"structure" required:"true"` // PriceClass is a required field PriceClass *string `type:"string" required:"true" enum:"PriceClass"` // A complex type that identifies ways in which you want to restrict distribution // of your content. // // Restrictions is a required field Restrictions *Restrictions `type:"structure" required:"true"` // The current status of the distribution. When the status is Deployed, the // distribution's information is propagated to all CloudFront edge locations. // // Status is a required field Status *string `type:"string" required:"true"` // A complex type that specifies the following: // // * Which SSL/TLS certificate to use when viewers request objects using // HTTPS // // * Whether you want CloudFront to use dedicated IP addresses or SNI when // you're using alternate domain names in your object names // // * The minimum protocol version that you want CloudFront to use when communicating // with viewers // // For more information, see Using an HTTPS Connection to Access Your Objects // (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html) // in the Amazon Amazon CloudFront Developer Guide. // // ViewerCertificate is a required field ViewerCertificate *ViewerCertificate `type:"structure" required:"true"` // The Web ACL Id (if any) associated with the distribution. // // WebACLId is a required field WebACLId *string `type:"string" required:"true"` // contains filtered or unexported fields }
A summary of the information about a CloudFront distribution.
func (DistributionSummary) GoString ¶
func (s DistributionSummary) GoString() string
GoString returns the string representation
func (DistributionSummary) String ¶
func (s DistributionSummary) String() string
String returns the string representation
type ForwardedValues ¶
type ForwardedValues struct { // 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 // (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Cookies.html) // in the Amazon CloudFront Developer Guide. // // Cookies is a required field Cookies *CookiePreference `type:"structure" required:"true"` // A complex type that specifies the Headers, if any, that you want CloudFront // to vary upon for this cache behavior. Headers *Headers `type:"structure"` // Indicates whether you want CloudFront to forward query strings to the origin // that is associated with this cache behavior and cache based on the query // string parameters. CloudFront behavior depends on the value of QueryString // and on the values that you specify for QueryStringCacheKeys, if any: // // If you specify true for QueryString and you don't specify any values for // QueryStringCacheKeys, CloudFront forwards all query string parameters to // the origin and caches based on all query string parameters. Depending on // how many query string parameters and values you have, this can adversely // affect performance because CloudFront must forward more requests to the origin. // // If you specify true for QueryString and you specify one or more values for // QueryStringCacheKeys, CloudFront forwards all query string parameters to // the origin, but it only caches based on the query string parameters that // you specify. // // If you specify false for QueryString, CloudFront doesn't forward any query // string parameters to the origin, and doesn't cache based on query string // parameters. // // For more information, see Configuring CloudFront to Cache Based on Query // String Parameters (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/QueryStringParameters.html) // in the Amazon CloudFront Developer Guide. // // QueryString is a required field QueryString *bool `type:"boolean" required:"true"` // A complex type that contains information about the query string parameters // that you want CloudFront to use for caching for this cache behavior. QueryStringCacheKeys *QueryStringCacheKeys `type:"structure"` // contains filtered or unexported fields }
A complex type that specifies how CloudFront handles query strings and cookies.
func (ForwardedValues) GoString ¶
func (s ForwardedValues) GoString() string
GoString returns the string representation
func (ForwardedValues) String ¶
func (s ForwardedValues) String() string
String returns the string representation
func (*ForwardedValues) Validate ¶
func (s *ForwardedValues) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GeoRestriction ¶
type GeoRestriction struct { // A complex type that contains a Location element for each country in which // you want CloudFront either to distribute your content (whitelist) or not // distribute your content (blacklist). // // The Location element is a two-letter, uppercase country code for a country // that you want to include in your blacklist or whitelist. Include one Location // element for each country. // // CloudFront and MaxMind both use ISO 3166 country codes. For the current list // of countries and the corresponding codes, see ISO 3166-1-alpha-2 code on // the International Organization for Standardization website. You can also // refer to the country list in the CloudFront console, which includes both // country names and codes. Items []*string `locationNameList:"Location" type:"list"` // When geo restriction is enabled, this is the number of countries in your // whitelist or blacklist. Otherwise, when it is not enabled, Quantity is 0, // and you can omit Items. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // The method that you want to use to restrict distribution of your content // by country: // // * none: No geo restriction is enabled, meaning access to content is not // restricted by client geo location. // // * blacklist: The Location elements specify the countries in which you // do not want CloudFront to distribute your content. // // * whitelist: The Location elements specify the countries in which you // want CloudFront to distribute your content. // // RestrictionType is a required field RestrictionType *string `type:"string" required:"true" enum:"GeoRestrictionType"` // contains filtered or unexported fields }
A complex type that controls the countries in which your content is distributed. CloudFront determines the location of your users using MaxMind GeoIP databases.
func (GeoRestriction) GoString ¶
func (s GeoRestriction) GoString() string
GoString returns the string representation
func (GeoRestriction) String ¶
func (s GeoRestriction) String() string
String returns the string representation
func (*GeoRestriction) Validate ¶
func (s *GeoRestriction) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetCloudFrontOriginAccessIdentityConfigInput ¶
type GetCloudFrontOriginAccessIdentityConfigInput struct { // The identity's ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // contains filtered or unexported fields }
The origin access identity's configuration information. For more information, see CloudFrontOriginAccessIdentityConfigComplexType.
func (GetCloudFrontOriginAccessIdentityConfigInput) GoString ¶
func (s GetCloudFrontOriginAccessIdentityConfigInput) GoString() string
GoString returns the string representation
func (GetCloudFrontOriginAccessIdentityConfigInput) String ¶
func (s GetCloudFrontOriginAccessIdentityConfigInput) String() string
String returns the string representation
func (*GetCloudFrontOriginAccessIdentityConfigInput) Validate ¶
func (s *GetCloudFrontOriginAccessIdentityConfigInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetCloudFrontOriginAccessIdentityConfigOutput ¶
type GetCloudFrontOriginAccessIdentityConfigOutput struct { // The origin access identity's configuration information. CloudFrontOriginAccessIdentityConfig *OriginAccessIdentityConfig `type:"structure"` // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (GetCloudFrontOriginAccessIdentityConfigOutput) GoString ¶
func (s GetCloudFrontOriginAccessIdentityConfigOutput) GoString() string
GoString returns the string representation
func (GetCloudFrontOriginAccessIdentityConfigOutput) String ¶
func (s GetCloudFrontOriginAccessIdentityConfigOutput) String() string
String returns the string representation
type GetCloudFrontOriginAccessIdentityInput ¶
type GetCloudFrontOriginAccessIdentityInput struct { // The identity's ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // contains filtered or unexported fields }
The request to get an origin access identity's information.
func (GetCloudFrontOriginAccessIdentityInput) GoString ¶
func (s GetCloudFrontOriginAccessIdentityInput) GoString() string
GoString returns the string representation
func (GetCloudFrontOriginAccessIdentityInput) String ¶
func (s GetCloudFrontOriginAccessIdentityInput) String() string
String returns the string representation
func (*GetCloudFrontOriginAccessIdentityInput) Validate ¶
func (s *GetCloudFrontOriginAccessIdentityInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetCloudFrontOriginAccessIdentityOutput ¶
type GetCloudFrontOriginAccessIdentityOutput struct { // The origin access identity's information. CloudFrontOriginAccessIdentity *OriginAccessIdentity `type:"structure"` // The current version of the origin access identity's information. For example: // E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (GetCloudFrontOriginAccessIdentityOutput) GoString ¶
func (s GetCloudFrontOriginAccessIdentityOutput) GoString() string
GoString returns the string representation
func (GetCloudFrontOriginAccessIdentityOutput) String ¶
func (s GetCloudFrontOriginAccessIdentityOutput) String() string
String returns the string representation
type GetDistributionConfigInput ¶
type GetDistributionConfigInput struct { // The distribution's ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // contains filtered or unexported fields }
The request to get a distribution configuration.
func (GetDistributionConfigInput) GoString ¶
func (s GetDistributionConfigInput) GoString() string
GoString returns the string representation
func (GetDistributionConfigInput) String ¶
func (s GetDistributionConfigInput) String() string
String returns the string representation
func (*GetDistributionConfigInput) Validate ¶
func (s *GetDistributionConfigInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDistributionConfigOutput ¶
type GetDistributionConfigOutput struct { // The distribution's configuration information. DistributionConfig *DistributionConfig `type:"structure"` // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (GetDistributionConfigOutput) GoString ¶
func (s GetDistributionConfigOutput) GoString() string
GoString returns the string representation
func (GetDistributionConfigOutput) String ¶
func (s GetDistributionConfigOutput) String() string
String returns the string representation
type GetDistributionInput ¶
type GetDistributionInput struct { // The distribution's ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // contains filtered or unexported fields }
The request to get a distribution's information.
func (GetDistributionInput) GoString ¶
func (s GetDistributionInput) GoString() string
GoString returns the string representation
func (GetDistributionInput) String ¶
func (s GetDistributionInput) String() string
String returns the string representation
func (*GetDistributionInput) Validate ¶
func (s *GetDistributionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDistributionOutput ¶
type GetDistributionOutput struct { // The distribution's information. Distribution *Distribution `type:"structure"` // The current version of the distribution's information. For example: E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (GetDistributionOutput) GoString ¶
func (s GetDistributionOutput) GoString() string
GoString returns the string representation
func (GetDistributionOutput) String ¶
func (s GetDistributionOutput) String() string
String returns the string representation
type GetInvalidationInput ¶
type GetInvalidationInput struct { // The distribution's ID. // // DistributionId is a required field DistributionId *string `location:"uri" locationName:"DistributionId" type:"string" required:"true"` // The identifier for the invalidation request, for example, IDFDVBD632BHDS5. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // contains filtered or unexported fields }
The request to get an invalidation's information.
func (GetInvalidationInput) GoString ¶
func (s GetInvalidationInput) GoString() string
GoString returns the string representation
func (GetInvalidationInput) String ¶
func (s GetInvalidationInput) String() string
String returns the string representation
func (*GetInvalidationInput) Validate ¶
func (s *GetInvalidationInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetInvalidationOutput ¶
type GetInvalidationOutput struct { // The invalidation's information. For more information, see Invalidation Complex // Type (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/InvalidationDatatype.html). Invalidation *Invalidation `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (GetInvalidationOutput) GoString ¶
func (s GetInvalidationOutput) GoString() string
GoString returns the string representation
func (GetInvalidationOutput) String ¶
func (s GetInvalidationOutput) String() string
String returns the string representation
type GetStreamingDistributionConfigInput ¶
type GetStreamingDistributionConfigInput struct { // The streaming distribution's ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // contains filtered or unexported fields }
To request to get a streaming distribution configuration.
func (GetStreamingDistributionConfigInput) GoString ¶
func (s GetStreamingDistributionConfigInput) GoString() string
GoString returns the string representation
func (GetStreamingDistributionConfigInput) String ¶
func (s GetStreamingDistributionConfigInput) String() string
String returns the string representation
func (*GetStreamingDistributionConfigInput) Validate ¶
func (s *GetStreamingDistributionConfigInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetStreamingDistributionConfigOutput ¶
type GetStreamingDistributionConfigOutput struct { // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // The streaming distribution's configuration information. StreamingDistributionConfig *StreamingDistributionConfig `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (GetStreamingDistributionConfigOutput) GoString ¶
func (s GetStreamingDistributionConfigOutput) GoString() string
GoString returns the string representation
func (GetStreamingDistributionConfigOutput) String ¶
func (s GetStreamingDistributionConfigOutput) String() string
String returns the string representation
type GetStreamingDistributionInput ¶
type GetStreamingDistributionInput struct { // The streaming distribution's ID. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // contains filtered or unexported fields }
The request to get a streaming distribution's information.
func (GetStreamingDistributionInput) GoString ¶
func (s GetStreamingDistributionInput) GoString() string
GoString returns the string representation
func (GetStreamingDistributionInput) String ¶
func (s GetStreamingDistributionInput) String() string
String returns the string representation
func (*GetStreamingDistributionInput) Validate ¶
func (s *GetStreamingDistributionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetStreamingDistributionOutput ¶
type GetStreamingDistributionOutput struct { // The current version of the streaming distribution's information. For example: // E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // The streaming distribution's information. StreamingDistribution *StreamingDistribution `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (GetStreamingDistributionOutput) GoString ¶
func (s GetStreamingDistributionOutput) GoString() string
GoString returns the string representation
func (GetStreamingDistributionOutput) String ¶
func (s GetStreamingDistributionOutput) String() string
String returns the string representation
type Headers ¶
type Headers struct { // A complex type that contains one Name element for each header that you want // CloudFront to forward to the origin and to vary on for this cache behavior. // If Quantity is 0, omit Items. Items []*string `locationNameList:"Name" type:"list"` // The number of different headers that you want CloudFront to forward to the // origin for this cache behavior. You can configure each cache behavior in // a web distribution to do one of the following: // // * Forward all headers to your origin: Specify 1 for Quantity and * for // Name. // // If you configure CloudFront to forward all headers to your origin, CloudFront // doesn't cache the objects associated with this cache behavior. Instead, // it sends every request to the origin. // // * Forward a whitelist of headers you specify: Specify the number of headers // that you want to forward, and specify the header names in Name elements. // CloudFront caches your objects based on the values in all of the specified // headers. CloudFront also forwards the headers that it forwards by default, // but it caches your objects based only on the headers that you specify. // // // * Forward only the default headers: Specify 0 for Quantity and omit Items. // In this configuration, CloudFront doesn't cache based on the values in // the request headers. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that specifies the headers that you want CloudFront to forward to the origin for this cache behavior.
For the headers that you specify, CloudFront also caches separate versions of a specified object based on the header values in viewer requests. For example, suppose viewer requests for logo.jpg contain a custom Product header that has a value of either Acme or Apex, and you configure CloudFront to cache your content based on values in the Product header. CloudFront forwards the Product header to the origin and caches the response from the origin once for each header value. For more information about caching based on header values, see How CloudFront Forwards and Caches Headers (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/header-caching.html) in the Amazon CloudFront Developer Guide.
type Invalidation ¶
type Invalidation struct { // The date and time the invalidation request was first made. // // CreateTime is a required field CreateTime *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"` // The identifier for the invalidation request. For example: IDFDVBD632BHDS5. // // Id is a required field Id *string `type:"string" required:"true"` // The current invalidation information for the batch request. // // InvalidationBatch is a required field InvalidationBatch *InvalidationBatch `type:"structure" required:"true"` // The status of the invalidation request. When the invalidation batch is finished, // the status is Completed. // // Status is a required field Status *string `type:"string" required:"true"` // contains filtered or unexported fields }
An invalidation.
func (Invalidation) GoString ¶
func (s Invalidation) GoString() string
GoString returns the string representation
func (Invalidation) String ¶
func (s Invalidation) String() string
String returns the string representation
type InvalidationBatch ¶
type InvalidationBatch struct { // A value that you specify to uniquely identify an invalidation request. CloudFront // uses the value to prevent you from accidentally resubmitting an identical // request. Whenever you create a new invalidation request, you must specify // a new value for CallerReference and change other values in the request as // applicable. One way to ensure that the value of CallerReference is unique // is to use a timestamp, for example, 20120301090000. // // If you make a second invalidation request with the same value for CallerReference, // and if the rest of the request is the same, CloudFront doesn't create a new // invalidation request. Instead, CloudFront returns information about the invalidation // request that you previously created with the same CallerReference. // // If CallerReference is a value you already sent in a previous invalidation // batch request but the content of any Path is different from the original // request, CloudFront returns an InvalidationBatchAlreadyExists error. // // CallerReference is a required field CallerReference *string `type:"string" required:"true"` // A complex type that contains information about the objects that you want // to invalidate. For more information, see Specifying the Objects to Invalidate // (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html#invalidation-specifying-objects) // in the Amazon CloudFront Developer Guide. // // Paths is a required field Paths *Paths `type:"structure" required:"true"` // contains filtered or unexported fields }
An invalidation batch.
func (InvalidationBatch) GoString ¶
func (s InvalidationBatch) GoString() string
GoString returns the string representation
func (InvalidationBatch) String ¶
func (s InvalidationBatch) String() string
String returns the string representation
func (*InvalidationBatch) Validate ¶
func (s *InvalidationBatch) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type InvalidationList ¶
type InvalidationList struct { // A flag that indicates whether more invalidation batch requests remain to // be listed. If your results were truncated, you can make a follow-up pagination // request using the Marker request parameter to retrieve more invalidation // batches in the list. // // IsTruncated is a required field IsTruncated *bool `type:"boolean" required:"true"` // A complex type that contains one InvalidationSummary element for each invalidation // batch created by the current AWS account. Items []*InvalidationSummary `locationNameList:"InvalidationSummary" type:"list"` // The value that you provided for the Marker request parameter. // // Marker is a required field Marker *string `type:"string" required:"true"` // The value that you provided for the MaxItems request parameter. // // MaxItems is a required field MaxItems *int64 `type:"integer" required:"true"` // If IsTruncated is true, this element is present and contains the value that // you can use for the Marker request parameter to continue listing your invalidation // batches where they left off. NextMarker *string `type:"string"` // The number of invalidation batches that were created by the current AWS account. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
The InvalidationList complex type describes the list of invalidation objects. For more information about invalidation, see Invalidating Objects (Web Distributions Only) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html) in the Amazon CloudFront Developer Guide.
func (InvalidationList) GoString ¶
func (s InvalidationList) GoString() string
GoString returns the string representation
func (InvalidationList) String ¶
func (s InvalidationList) String() string
String returns the string representation
type InvalidationSummary ¶
type InvalidationSummary struct { // CreateTime is a required field CreateTime *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"` // The unique ID for an invalidation request. // // Id is a required field Id *string `type:"string" required:"true"` // The status of an invalidation request. // // Status is a required field Status *string `type:"string" required:"true"` // contains filtered or unexported fields }
A summary of an invalidation request.
func (InvalidationSummary) GoString ¶
func (s InvalidationSummary) GoString() string
GoString returns the string representation
func (InvalidationSummary) String ¶
func (s InvalidationSummary) String() string
String returns the string representation
type KeyPairIds ¶
type KeyPairIds struct { // A complex type that lists the active CloudFront key pairs, if any, that are // associated with AwsAccountNumber. // // For more information, see ActiveTrustedSigners. Items []*string `locationNameList:"KeyPairId" type:"list"` // The number of active CloudFront key pairs for AwsAccountNumber. // // For more information, see ActiveTrustedSigners. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that lists the active CloudFront key pairs, if any, that are associated with AwsAccountNumber.
For more information, see ActiveTrustedSigners.
func (KeyPairIds) GoString ¶
func (s KeyPairIds) GoString() string
GoString returns the string representation
func (KeyPairIds) String ¶
func (s KeyPairIds) String() string
String returns the string representation
type ListCloudFrontOriginAccessIdentitiesInput ¶
type ListCloudFrontOriginAccessIdentitiesInput struct { // Use this when paginating results to indicate where to begin in your list // of origin access identities. The results include identities in the list that // occur after the marker. To get the next page of results, set the Marker to // the value of the NextMarker from the current page's response (which is also // the ID of the last identity on that page). Marker *string `location:"querystring" locationName:"Marker" type:"string"` // The maximum number of origin access identities you want in the response body. MaxItems *int64 `location:"querystring" locationName:"MaxItems" type:"integer"` // contains filtered or unexported fields }
The request to list origin access identities.
func (ListCloudFrontOriginAccessIdentitiesInput) GoString ¶
func (s ListCloudFrontOriginAccessIdentitiesInput) GoString() string
GoString returns the string representation
func (ListCloudFrontOriginAccessIdentitiesInput) String ¶
func (s ListCloudFrontOriginAccessIdentitiesInput) String() string
String returns the string representation
type ListCloudFrontOriginAccessIdentitiesOutput ¶
type ListCloudFrontOriginAccessIdentitiesOutput struct { // The CloudFrontOriginAccessIdentityList type. CloudFrontOriginAccessIdentityList *OriginAccessIdentityList `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (ListCloudFrontOriginAccessIdentitiesOutput) GoString ¶
func (s ListCloudFrontOriginAccessIdentitiesOutput) GoString() string
GoString returns the string representation
func (ListCloudFrontOriginAccessIdentitiesOutput) String ¶
func (s ListCloudFrontOriginAccessIdentitiesOutput) String() string
String returns the string representation
type ListDistributionsByWebACLIdInput ¶
type ListDistributionsByWebACLIdInput struct { // Use Marker and MaxItems to control pagination of results. If you have more // than MaxItems distributions that satisfy the request, the response includes // a NextMarker element. To get the next page of results, submit another request. // For the value of Marker, specify the value of NextMarker from the last response. // (For the first request, omit Marker.) Marker *string `location:"querystring" locationName:"Marker" type:"string"` // The maximum number of distributions that you want CloudFront to return in // the response body. The maximum and default values are both 100. MaxItems *int64 `location:"querystring" locationName:"MaxItems" type:"integer"` // The ID of the AWS WAF web ACL that you want to list the associated distributions. // If you specify "null" for the ID, the request returns a list of the distributions // that aren't associated with a web ACL. // // WebACLId is a required field WebACLId *string `location:"uri" locationName:"WebACLId" type:"string" required:"true"` // contains filtered or unexported fields }
The request to list distributions that are associated with a specified AWS WAF web ACL.
func (ListDistributionsByWebACLIdInput) GoString ¶
func (s ListDistributionsByWebACLIdInput) GoString() string
GoString returns the string representation
func (ListDistributionsByWebACLIdInput) String ¶
func (s ListDistributionsByWebACLIdInput) String() string
String returns the string representation
func (*ListDistributionsByWebACLIdInput) Validate ¶
func (s *ListDistributionsByWebACLIdInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ListDistributionsByWebACLIdOutput ¶
type ListDistributionsByWebACLIdOutput struct { // The DistributionList type. DistributionList *DistributionList `type:"structure"` // contains filtered or unexported fields }
The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.
func (ListDistributionsByWebACLIdOutput) GoString ¶
func (s ListDistributionsByWebACLIdOutput) GoString() string
GoString returns the string representation
func (ListDistributionsByWebACLIdOutput) String ¶
func (s ListDistributionsByWebACLIdOutput) String() string
String returns the string representation
type ListDistributionsInput ¶
type ListDistributionsInput struct { // Use this when paginating results to indicate where to begin in your list // of distributions. The results include distributions in the list that occur // after the marker. To get the next page of results, set the Marker to the // value of the NextMarker from the current page's response (which is also the // ID of the last distribution on that page). Marker *string `location:"querystring" locationName:"Marker" type:"string"` // The maximum number of distributions you want in the response body. MaxItems *int64 `location:"querystring" locationName:"MaxItems" type:"integer"` // contains filtered or unexported fields }
The request to list your distributions.
func (ListDistributionsInput) GoString ¶
func (s ListDistributionsInput) GoString() string
GoString returns the string representation
func (ListDistributionsInput) String ¶
func (s ListDistributionsInput) String() string
String returns the string representation
type ListDistributionsOutput ¶
type ListDistributionsOutput struct { // The DistributionList type. DistributionList *DistributionList `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (ListDistributionsOutput) GoString ¶
func (s ListDistributionsOutput) GoString() string
GoString returns the string representation
func (ListDistributionsOutput) String ¶
func (s ListDistributionsOutput) String() string
String returns the string representation
type ListInvalidationsInput ¶
type ListInvalidationsInput struct { // The distribution's ID. // // DistributionId is a required field DistributionId *string `location:"uri" locationName:"DistributionId" type:"string" required:"true"` // Use this parameter when paginating results to indicate where to begin in // your list of invalidation batches. Because the results are returned in decreasing // order from most recent to oldest, the most recent results are on the first // page, the second page will contain earlier results, and so on. To get the // next page of results, set Marker to the value of the NextMarker from the // current page's response. This value is the same as the ID of the last invalidation // batch on that page. Marker *string `location:"querystring" locationName:"Marker" type:"string"` // The maximum number of invalidation batches that you want in the response // body. MaxItems *int64 `location:"querystring" locationName:"MaxItems" type:"integer"` // contains filtered or unexported fields }
The request to list invalidations.
func (ListInvalidationsInput) GoString ¶
func (s ListInvalidationsInput) GoString() string
GoString returns the string representation
func (ListInvalidationsInput) String ¶
func (s ListInvalidationsInput) String() string
String returns the string representation
func (*ListInvalidationsInput) Validate ¶
func (s *ListInvalidationsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ListInvalidationsOutput ¶
type ListInvalidationsOutput struct { // Information about invalidation batches. InvalidationList *InvalidationList `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (ListInvalidationsOutput) GoString ¶
func (s ListInvalidationsOutput) GoString() string
GoString returns the string representation
func (ListInvalidationsOutput) String ¶
func (s ListInvalidationsOutput) String() string
String returns the string representation
type ListStreamingDistributionsInput ¶
type ListStreamingDistributionsInput struct { // The value that you provided for the Marker request parameter. Marker *string `location:"querystring" locationName:"Marker" type:"string"` // The value that you provided for the MaxItems request parameter. MaxItems *int64 `location:"querystring" locationName:"MaxItems" type:"integer"` // contains filtered or unexported fields }
The request to list your streaming distributions.
func (ListStreamingDistributionsInput) GoString ¶
func (s ListStreamingDistributionsInput) GoString() string
GoString returns the string representation
func (ListStreamingDistributionsInput) String ¶
func (s ListStreamingDistributionsInput) String() string
String returns the string representation
type ListStreamingDistributionsOutput ¶
type ListStreamingDistributionsOutput struct { // The StreamingDistributionList type. StreamingDistributionList *StreamingDistributionList `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (ListStreamingDistributionsOutput) GoString ¶
func (s ListStreamingDistributionsOutput) GoString() string
GoString returns the string representation
func (ListStreamingDistributionsOutput) String ¶
func (s ListStreamingDistributionsOutput) String() string
String returns the string representation
type ListTagsForResourceInput ¶
type ListTagsForResourceInput struct { // An ARN of a CloudFront resource. // // Resource is a required field Resource *string `location:"querystring" locationName:"Resource" type:"string" required:"true"` // contains filtered or unexported fields }
The request to list tags for a CloudFront resource.
func (ListTagsForResourceInput) GoString ¶
func (s ListTagsForResourceInput) GoString() string
GoString returns the string representation
func (ListTagsForResourceInput) String ¶
func (s ListTagsForResourceInput) String() string
String returns the string representation
func (*ListTagsForResourceInput) Validate ¶
func (s *ListTagsForResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ListTagsForResourceOutput ¶
type ListTagsForResourceOutput struct { // A complex type that contains zero or more Tag elements. // // Tags is a required field Tags *Tags `type:"structure" required:"true"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (ListTagsForResourceOutput) GoString ¶
func (s ListTagsForResourceOutput) GoString() string
GoString returns the string representation
func (ListTagsForResourceOutput) String ¶
func (s ListTagsForResourceOutput) String() string
String returns the string representation
type LoggingConfig ¶
type LoggingConfig struct { // The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com. // // Bucket is a required field Bucket *string `type:"string" required:"true"` // Specifies whether you want CloudFront to save access logs to an Amazon S3 // bucket. If you do not want to enable logging when you create a distribution // or if you want to disable logging for an existing distribution, specify false // for Enabled, and specify empty Bucket and Prefix elements. If you specify // false for Enabled but you specify values for Bucket, prefix, and IncludeCookies, // the values are automatically deleted. // // Enabled is a required field Enabled *bool `type:"boolean" required:"true"` // Specifies whether you want CloudFront to include cookies in access logs, // specify true for IncludeCookies. If you choose to include cookies in logs, // CloudFront logs all cookies regardless of how you configure the cache behaviors // for this distribution. If you do not want to include cookies when you create // a distribution or if you want to disable include cookies for an existing // distribution, specify false for IncludeCookies. // // IncludeCookies is a required field IncludeCookies *bool `type:"boolean" required:"true"` // An optional string that you want CloudFront to prefix to the access log filenames // for this distribution, for example, myprefix/. If you want to enable logging, // but you do not want to specify a prefix, you still must include an empty // Prefix element in the Logging element. // // Prefix is a required field Prefix *string `type:"string" required:"true"` // contains filtered or unexported fields }
A complex type that controls whether access logs are written for the distribution.
func (LoggingConfig) GoString ¶
func (s LoggingConfig) GoString() string
GoString returns the string representation
func (LoggingConfig) String ¶
func (s LoggingConfig) String() string
String returns the string representation
func (*LoggingConfig) Validate ¶
func (s *LoggingConfig) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type Origin ¶
type Origin struct { // A complex type that contains names and values for the custom headers that // you want. CustomHeaders *CustomHeaders `type:"structure"` // A complex type that contains information about a custom origin. If the origin // is an Amazon S3 bucket, use the S3OriginConfig element instead. CustomOriginConfig *CustomOriginConfig `type:"structure"` // Amazon S3 origins: The DNS name of the Amazon S3 bucket from which you want // CloudFront to get objects for this origin, for example, myawsbucket.s3.amazonaws.com. // // Constraints for Amazon S3 origins: // // * If you configured Amazon S3 Transfer Acceleration for your bucket, do // not specify the s3-accelerate endpoint for DomainName. // // * The bucket name must be between 3 and 63 characters long (inclusive). // // * The bucket name must contain only lowercase characters, numbers, periods, // underscores, and dashes. // // * The bucket name must not contain adjacent periods. // // Custom Origins: The DNS domain name for the HTTP server from which you want // CloudFront to get objects for this origin, for example, www.example.com. // // Constraints for custom origins: // // * DomainName must be a valid DNS name that contains only a-z, A-Z, 0-9, // dot (.), hyphen (-), or underscore (_) characters. // // * The name cannot exceed 128 characters. // // DomainName is a required field DomainName *string `type:"string" required:"true"` // A unique identifier for the origin. The value of Id must be unique within // the distribution. // // When you specify the value of TargetOriginId for the default cache behavior // or for another cache behavior, you indicate the origin to which you want // the cache behavior to route requests by specifying the value of the Id element // for that origin. When a request matches the path pattern for that cache behavior, // CloudFront routes the request to the specified origin. For more information, // see Cache Behavior Settings (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesCacheBehavior) // in the Amazon CloudFront Developer Guide. // // Id is a required field Id *string `type:"string" required:"true"` // An optional element that causes CloudFront to request your content from a // directory in your Amazon S3 bucket or your custom origin. When you include // the OriginPath element, specify the directory name, beginning with a /. CloudFront // appends the directory name to the value of DomainName, for example, example.com/production. // Do not include a / at the end of the directory name. // // For example, suppose you've specified the following values for your distribution: // // * DomainName: An Amazon S3 bucket named myawsbucket. // // * OriginPath: /production // // * CNAME: example.com // // When a user enters example.com/index.html in a browser, CloudFront sends // a request to Amazon S3 for myawsbucket/production/index.html. // // When a user enters example.com/acme/index.html in a browser, CloudFront sends // a request to Amazon S3 for myawsbucket/production/acme/index.html. OriginPath *string `type:"string"` // A complex type that contains information about the Amazon S3 origin. If the // origin is a custom origin, use the CustomOriginConfig element instead. S3OriginConfig *S3OriginConfig `type:"structure"` // contains filtered or unexported fields }
A complex type that describes the Amazon S3 bucket or the HTTP server (for example, a web server) from which CloudFront gets your files. You must create at least one origin.
For the current limit on the number of origins that you can create for a distribution, see Amazon CloudFront Limits (http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_cloudfront) in the AWS General Reference.
type OriginAccessIdentity ¶
type OriginAccessIdentity struct { // The current configuration information for the identity. CloudFrontOriginAccessIdentityConfig *OriginAccessIdentityConfig `type:"structure"` // The ID for the origin access identity. For example: E74FTE3AJFJ256A. // // Id is a required field Id *string `type:"string" required:"true"` // The Amazon S3 canonical user ID for the origin access identity, used when // giving the origin access identity read permission to an object in Amazon // S3. // // S3CanonicalUserId is a required field S3CanonicalUserId *string `type:"string" required:"true"` // contains filtered or unexported fields }
CloudFront origin access identity.
func (OriginAccessIdentity) GoString ¶
func (s OriginAccessIdentity) GoString() string
GoString returns the string representation
func (OriginAccessIdentity) String ¶
func (s OriginAccessIdentity) String() string
String returns the string representation
type OriginAccessIdentityConfig ¶
type OriginAccessIdentityConfig struct { // A unique number that ensures the request can't be replayed. // // If the CallerReference is new (no matter the content of the CloudFrontOriginAccessIdentityConfig // object), a new origin access identity is created. // // If the CallerReference is a value already sent in a previous identity request, // and the content of the CloudFrontOriginAccessIdentityConfig is identical // to the original request (ignoring white space), the response includes the // same information returned to the original request. // // 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. // // CallerReference is a required field CallerReference *string `type:"string" required:"true"` // Any comments you want to include about the origin access identity. // // Comment is a required field Comment *string `type:"string" required:"true"` // contains filtered or unexported fields }
Origin access identity configuration. Send a GET request to the /CloudFront API version/CloudFront/identity ID/config resource.
func (OriginAccessIdentityConfig) GoString ¶
func (s OriginAccessIdentityConfig) GoString() string
GoString returns the string representation
func (OriginAccessIdentityConfig) String ¶
func (s OriginAccessIdentityConfig) String() string
String returns the string representation
func (*OriginAccessIdentityConfig) Validate ¶
func (s *OriginAccessIdentityConfig) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type OriginAccessIdentityList ¶
type OriginAccessIdentityList struct { // A flag that indicates whether more origin access identities remain to be // listed. If your results were truncated, you can make a follow-up pagination // request using the Marker request parameter to retrieve more items in the // list. // // IsTruncated is a required field IsTruncated *bool `type:"boolean" required:"true"` // A complex type that contains one CloudFrontOriginAccessIdentitySummary element // for each origin access identity that was created by the current AWS account. Items []*OriginAccessIdentitySummary `locationNameList:"CloudFrontOriginAccessIdentitySummary" type:"list"` // Use this when paginating results to indicate where to begin in your list // of origin access identities. The results include identities in the list that // occur after the marker. To get the next page of results, set the Marker to // the value of the NextMarker from the current page's response (which is also // the ID of the last identity on that page). // // Marker is a required field Marker *string `type:"string" required:"true"` // The maximum number of origin access identities you want in the response body. // // MaxItems is a required field MaxItems *int64 `type:"integer" required:"true"` // If IsTruncated is true, this element is present and contains the value you // can use for the Marker request parameter to continue listing your origin // access identities where they left off. NextMarker *string `type:"string"` // The number of CloudFront origin access identities that were created by the // current AWS account. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
Lists the origin access identities for CloudFront.Send a GET request to the /CloudFront API version/origin-access-identity/cloudfront resource. The response includes a CloudFrontOriginAccessIdentityList element with zero or more CloudFrontOriginAccessIdentitySummary child elements. By default, your entire list of origin access identities is returned in one single page. If the list is long, you can paginate it using the MaxItems and Marker parameters.
func (OriginAccessIdentityList) GoString ¶
func (s OriginAccessIdentityList) GoString() string
GoString returns the string representation
func (OriginAccessIdentityList) String ¶
func (s OriginAccessIdentityList) String() string
String returns the string representation
type OriginAccessIdentitySummary ¶
type OriginAccessIdentitySummary struct { // The comment for this origin access identity, as originally specified when // created. // // Comment is a required field Comment *string `type:"string" required:"true"` // The ID for the origin access identity. For example: E74FTE3AJFJ256A. // // Id is a required field Id *string `type:"string" required:"true"` // The Amazon S3 canonical user ID for the origin access identity, which you // use when giving the origin access identity read permission to an object in // Amazon S3. // // S3CanonicalUserId is a required field S3CanonicalUserId *string `type:"string" required:"true"` // contains filtered or unexported fields }
Summary of the information about a CloudFront origin access identity.
func (OriginAccessIdentitySummary) GoString ¶
func (s OriginAccessIdentitySummary) GoString() string
GoString returns the string representation
func (OriginAccessIdentitySummary) String ¶
func (s OriginAccessIdentitySummary) String() string
String returns the string representation
type OriginCustomHeader ¶
type OriginCustomHeader struct { // The name of a header that you want CloudFront to forward to your origin. // For more information, see Forwarding Custom Headers to Your Origin (Web Distributions // Only) (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/forward-custom-headers.html) // in the Amazon Amazon CloudFront Developer Guide. // // HeaderName is a required field HeaderName *string `type:"string" required:"true"` // The value for the header that you specified in the HeaderName field. // // HeaderValue is a required field HeaderValue *string `type:"string" required:"true"` // contains filtered or unexported fields }
A complex type that contains HeaderName and HeaderValue elements, if any, for this distribution.
func (OriginCustomHeader) GoString ¶
func (s OriginCustomHeader) GoString() string
GoString returns the string representation
func (OriginCustomHeader) String ¶
func (s OriginCustomHeader) String() string
String returns the string representation
func (*OriginCustomHeader) Validate ¶
func (s *OriginCustomHeader) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type OriginSslProtocols ¶
type OriginSslProtocols struct { // A list that contains allowed SSL/TLS protocols for this distribution. // // Items is a required field Items []*string `locationNameList:"SslProtocol" type:"list" required:"true"` // The number of SSL/TLS protocols that you want to allow CloudFront to use // when establishing an HTTPS connection with this origin. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that contains information about the SSL/TLS protocols that CloudFront can use when establishing an HTTPS connection with your origin.
func (OriginSslProtocols) GoString ¶
func (s OriginSslProtocols) GoString() string
GoString returns the string representation
func (OriginSslProtocols) String ¶
func (s OriginSslProtocols) String() string
String returns the string representation
func (*OriginSslProtocols) Validate ¶
func (s *OriginSslProtocols) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type Origins ¶
type Origins struct { // A complex type that contains origins for this distribution. Items []*Origin `locationNameList:"Origin" min:"1" type:"list"` // The number of origins for this distribution. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that contains information about origins for this distribution.
type Paths ¶
type Paths struct { // A complex type that contains a list of the paths that you want to invalidate. Items []*string `locationNameList:"Path" type:"list"` // The number of objects that you want to invalidate. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A complex type that contains information about the objects that you want to invalidate. For more information, see Specifying the Objects to Invalidate (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html#invalidation-specifying-objects) in the Amazon CloudFront Developer Guide.
type QueryStringCacheKeys ¶
type QueryStringCacheKeys struct { // (Optional) A list that contains the query string parameters that you want // CloudFront to use as a basis for caching for this cache behavior. If Quantity // is 0, you can omit Items. Items []*string `locationNameList:"Name" type:"list"` // The number of whitelisted query string parameters for this cache behavior. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
func (QueryStringCacheKeys) GoString ¶
func (s QueryStringCacheKeys) GoString() string
GoString returns the string representation
func (QueryStringCacheKeys) String ¶
func (s QueryStringCacheKeys) String() string
String returns the string representation
func (*QueryStringCacheKeys) Validate ¶
func (s *QueryStringCacheKeys) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type Restrictions ¶
type Restrictions struct { // A complex type that controls the countries in which your content is distributed. // CloudFront determines the location of your users using MaxMind GeoIP databases. // // GeoRestriction is a required field GeoRestriction *GeoRestriction `type:"structure" required:"true"` // contains filtered or unexported fields }
A complex type that identifies ways in which you want to restrict distribution of your content.
func (Restrictions) GoString ¶
func (s Restrictions) GoString() string
GoString returns the string representation
func (Restrictions) String ¶
func (s Restrictions) String() string
String returns the string representation
func (*Restrictions) Validate ¶
func (s *Restrictions) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type S3Origin ¶
type S3Origin struct { // The DNS name of the Amazon S3 origin. // // DomainName is a required field DomainName *string `type:"string" required:"true"` // The CloudFront origin access identity to associate with the RTMP distribution. // Use an origin access identity to configure the distribution so that end users // can only access objects in an Amazon S3 bucket through CloudFront. // // If you want end users to be able to access objects using either the CloudFront // URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. // // To delete the origin access identity from an existing distribution, update // the distribution configuration and include an empty OriginAccessIdentity // element. // // To replace the origin access identity, update the distribution configuration // and specify the new origin access identity. // // For more information, see Using an Origin Access Identity to Restrict Access // to Your Amazon S3 Content (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html) // in the Amazon Amazon CloudFront Developer Guide. // // OriginAccessIdentity is a required field OriginAccessIdentity *string `type:"string" required:"true"` // contains filtered or unexported fields }
A complex type that contains information about the Amazon S3 bucket from which you want CloudFront to get your media files for distribution.
type S3OriginConfig ¶
type S3OriginConfig struct { // The CloudFront origin access identity to associate with the origin. Use an // origin access identity to configure the origin so that viewers can only access // objects in an Amazon S3 bucket through CloudFront. The format of the value // is: // // origin-access-identity/CloudFront/ID-of-origin-access-identity // // where ID-of-origin-access-identity is the value that CloudFront returned // in the ID element when you created the origin access identity. // // If you want viewers to be able to access objects using either the CloudFront // URL or the Amazon S3 URL, specify an empty OriginAccessIdentity element. // // To delete the origin access identity from an existing distribution, update // the distribution configuration and include an empty OriginAccessIdentity // element. // // To replace the origin access identity, update the distribution configuration // and specify the new origin access identity. // // For more information about the origin access identity, see Serving Private // Content through CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) // in the Amazon CloudFront Developer Guide. // // OriginAccessIdentity is a required field OriginAccessIdentity *string `type:"string" required:"true"` // contains filtered or unexported fields }
A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin, use the CustomOriginConfig element instead.
func (S3OriginConfig) GoString ¶
func (s S3OriginConfig) GoString() string
GoString returns the string representation
func (S3OriginConfig) String ¶
func (s S3OriginConfig) String() string
String returns the string representation
func (*S3OriginConfig) Validate ¶
func (s *S3OriginConfig) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type Signer ¶
type Signer struct { // An AWS account that is included in the TrustedSigners complex type for this // RTMP distribution. Valid values include: // // * self, which is the AWS account used to create the distribution. // // * An AWS account number. AwsAccountNumber *string `type:"string"` // A complex type that lists the active CloudFront key pairs, if any, that are // associated with AwsAccountNumber. KeyPairIds *KeyPairIds `type:"structure"` // contains filtered or unexported fields }
A complex type that lists the AWS accounts that were included in the TrustedSigners complex type, as well as their active CloudFront key pair IDs, if any.
type StreamingDistribution ¶
type StreamingDistribution struct { // ARN is a required field ARN *string `type:"string" required:"true"` // A complex type that lists the AWS accounts, if any, that you included in // the TrustedSigners complex type for this distribution. These are the accounts // that you want to allow to create signed URLs for private content. // // The Signer complex type lists the AWS account number of the trusted signer // or self if the signer is the AWS account that created the distribution. The // Signer element also includes the IDs of any active CloudFront key pairs that // are associated with the trusted signer's AWS account. If no KeyPairId element // appears for a Signer, that signer can't create signed URLs. // // For more information, see Serving Private Content through CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) // in the Amazon CloudFront Developer Guide. // // ActiveTrustedSigners is a required field ActiveTrustedSigners *ActiveTrustedSigners `type:"structure" required:"true"` // The domain name that corresponds to the streaming distribution. For example: // s5c39gqb8ow64r.cloudfront.net. // // DomainName is a required field DomainName *string `type:"string" required:"true"` // The identifier for the RTMP distribution. For example: EGTXBD79EXAMPLE. // // Id is a required field Id *string `type:"string" required:"true"` // The date and time that the distribution was last modified. LastModifiedTime *time.Time `type:"timestamp" timestampFormat:"iso8601"` // The current status of the RTMP distribution. When the status is Deployed, // the distribution's information is propagated to all CloudFront edge locations. // // Status is a required field Status *string `type:"string" required:"true"` // The current configuration information for the RTMP distribution. // // StreamingDistributionConfig is a required field StreamingDistributionConfig *StreamingDistributionConfig `type:"structure" required:"true"` // contains filtered or unexported fields }
A streaming distribution.
func (StreamingDistribution) GoString ¶
func (s StreamingDistribution) GoString() string
GoString returns the string representation
func (StreamingDistribution) String ¶
func (s StreamingDistribution) String() string
String returns the string representation
type StreamingDistributionConfig ¶
type StreamingDistributionConfig struct { // A complex type that contains information about CNAMEs (alternate domain names), // if any, for this streaming distribution. Aliases *Aliases `type:"structure"` // A unique number that ensures that the request can't be replayed. If the CallerReference // is new (no matter the content of the StreamingDistributionConfig object), // a new streaming distribution is created. If the CallerReference is a value // that you already sent in a previous request to create a streaming distribution, // and the content of the StreamingDistributionConfig is identical to the original // request (ignoring white space), the response includes the same information // returned to the original request. If the CallerReference is a value that // you already sent in a previous request to create a streaming distribution // but the content of the StreamingDistributionConfig is different from the // original request, CloudFront returns a DistributionAlreadyExists error. // // CallerReference is a required field CallerReference *string `type:"string" required:"true"` // Any comments you want to include about the streaming distribution. // // Comment is a required field Comment *string `type:"string" required:"true"` // Whether the streaming distribution is enabled to accept user requests for // content. // // Enabled is a required field Enabled *bool `type:"boolean" required:"true"` // A complex type that controls whether access logs are written for the streaming // distribution. Logging *StreamingLoggingConfig `type:"structure"` // A complex type that contains information about price class for this streaming // distribution. PriceClass *string `type:"string" enum:"PriceClass"` // A complex type that contains information about the Amazon S3 bucket from // which you want CloudFront to get your media files for distribution. // // S3Origin is a required field S3Origin *S3Origin `type:"structure" required:"true"` // A complex type that specifies any AWS accounts that you want to permit to // create signed URLs for private content. If you want the distribution to use // signed URLs, include this element; if you want the distribution to use public // URLs, remove this element. For more information, see Serving Private Content // through CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) // in the Amazon CloudFront Developer Guide. // // TrustedSigners is a required field TrustedSigners *TrustedSigners `type:"structure" required:"true"` // contains filtered or unexported fields }
The RTMP distribution's configuration information.
func (StreamingDistributionConfig) GoString ¶
func (s StreamingDistributionConfig) GoString() string
GoString returns the string representation
func (StreamingDistributionConfig) String ¶
func (s StreamingDistributionConfig) String() string
String returns the string representation
func (*StreamingDistributionConfig) Validate ¶
func (s *StreamingDistributionConfig) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type StreamingDistributionConfigWithTags ¶
type StreamingDistributionConfigWithTags struct { // A streaming distribution Configuration. // // StreamingDistributionConfig is a required field StreamingDistributionConfig *StreamingDistributionConfig `type:"structure" required:"true"` // A complex type that contains zero or more Tag elements. // // Tags is a required field Tags *Tags `type:"structure" required:"true"` // contains filtered or unexported fields }
A streaming distribution Configuration and a list of tags to be associated with the streaming distribution.
func (StreamingDistributionConfigWithTags) GoString ¶
func (s StreamingDistributionConfigWithTags) GoString() string
GoString returns the string representation
func (StreamingDistributionConfigWithTags) String ¶
func (s StreamingDistributionConfigWithTags) String() string
String returns the string representation
func (*StreamingDistributionConfigWithTags) Validate ¶
func (s *StreamingDistributionConfigWithTags) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type StreamingDistributionList ¶
type StreamingDistributionList struct { // A flag that indicates whether more streaming distributions remain to be listed. // If your results were truncated, you can make a follow-up pagination request // using the Marker request parameter to retrieve more distributions in the // list. // // IsTruncated is a required field IsTruncated *bool `type:"boolean" required:"true"` // A complex type that contains one StreamingDistributionSummary element for // each distribution that was created by the current AWS account. Items []*StreamingDistributionSummary `locationNameList:"StreamingDistributionSummary" type:"list"` // The value you provided for the Marker request parameter. // // Marker is a required field Marker *string `type:"string" required:"true"` // The value you provided for the MaxItems request parameter. // // MaxItems is a required field MaxItems *int64 `type:"integer" required:"true"` // If IsTruncated is true, this element is present and contains the value you // can use for the Marker request parameter to continue listing your RTMP distributions // where they left off. NextMarker *string `type:"string"` // The number of streaming distributions that were created by the current AWS // account. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
A streaming distribution list.
func (StreamingDistributionList) GoString ¶
func (s StreamingDistributionList) GoString() string
GoString returns the string representation
func (StreamingDistributionList) String ¶
func (s StreamingDistributionList) String() string
String returns the string representation
type StreamingDistributionSummary ¶
type StreamingDistributionSummary struct { // The ARN (Amazon Resource Name) for the streaming distribution. For example: // arn:aws:cloudfront::123456789012:streaming-distribution/EDFDVBD632BHDS5, // where 123456789012 is your AWS account ID. // // ARN is a required field ARN *string `type:"string" required:"true"` // A complex type that contains information about CNAMEs (alternate domain names), // if any, for this streaming distribution. // // Aliases is a required field Aliases *Aliases `type:"structure" required:"true"` // The comment originally specified when this distribution was created. // // Comment is a required field Comment *string `type:"string" required:"true"` // The domain name corresponding to the distribution. For example: d604721fxaaqy9.cloudfront.net. // // DomainName is a required field DomainName *string `type:"string" required:"true"` // Whether the distribution is enabled to accept end user requests for content. // // Enabled is a required field Enabled *bool `type:"boolean" required:"true"` // The identifier for the distribution. For example: EDFDVBD632BHDS5. // // Id is a required field Id *string `type:"string" required:"true"` // The date and time the distribution was last modified. // // LastModifiedTime is a required field LastModifiedTime *time.Time `type:"timestamp" timestampFormat:"iso8601" required:"true"` // PriceClass is a required field PriceClass *string `type:"string" required:"true" enum:"PriceClass"` // A complex type that contains information about the Amazon S3 bucket from // which you want CloudFront to get your media files for distribution. // // S3Origin is a required field S3Origin *S3Origin `type:"structure" required:"true"` // Indicates the current status of the distribution. When the status is Deployed, // the distribution's information is fully propagated throughout the Amazon // CloudFront system. // // Status is a required field Status *string `type:"string" required:"true"` // 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 PathPattern // for this cache behavior, specify true for Enabled, and specify the applicable // values for Quantity and Items.If you don't want to require signed URLs in // requests for objects that match PathPattern, specify false for Enabled and // 0 for Quantity. Omit Items. To add, change, or remove one or more trusted // signers, change Enabled to true (if it's currently false), change Quantity // as applicable, and specify all of the trusted signers that you want to include // in the updated distribution. // // TrustedSigners is a required field TrustedSigners *TrustedSigners `type:"structure" required:"true"` // contains filtered or unexported fields }
A summary of the information for an Amazon CloudFront streaming distribution.
func (StreamingDistributionSummary) GoString ¶
func (s StreamingDistributionSummary) GoString() string
GoString returns the string representation
func (StreamingDistributionSummary) String ¶
func (s StreamingDistributionSummary) String() string
String returns the string representation
type StreamingLoggingConfig ¶
type StreamingLoggingConfig struct { // The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com. // // Bucket is a required field Bucket *string `type:"string" required:"true"` // Specifies whether you want CloudFront to save access logs to an Amazon S3 // bucket. If you do not want to enable logging when you create a streaming // distribution or if you want to disable logging for an existing streaming // distribution, specify false for Enabled, and specify empty Bucket and Prefix // elements. If you specify false for Enabled but you specify values for Bucket // and Prefix, the values are automatically deleted. // // Enabled is a required field Enabled *bool `type:"boolean" required:"true"` // An optional string that you want CloudFront to prefix to the access log filenames // for this streaming distribution, for example, myprefix/. If you want to enable // logging, but you do not want to specify a prefix, you still must include // an empty Prefix element in the Logging element. // // Prefix is a required field Prefix *string `type:"string" required:"true"` // contains filtered or unexported fields }
A complex type that controls whether access logs are written for this streaming distribution.
func (StreamingLoggingConfig) GoString ¶
func (s StreamingLoggingConfig) GoString() string
GoString returns the string representation
func (StreamingLoggingConfig) String ¶
func (s StreamingLoggingConfig) String() string
String returns the string representation
func (*StreamingLoggingConfig) Validate ¶
func (s *StreamingLoggingConfig) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type Tag ¶
type Tag struct { // A string that contains Tag key. // // The string length should be between 1 and 128 characters. Valid characters // include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @. // // Key is a required field Key *string `min:"1" type:"string" required:"true"` // A string that contains an optional Tag value. // // The string length should be between 0 and 256 characters. Valid characters // include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @. Value *string `type:"string"` // contains filtered or unexported fields }
A complex type that contains Tag key and Tag value.
type TagKeys ¶
type TagKeys struct { // A complex type that contains Tag key elements. Items []*string `locationNameList:"Key" type:"list"` // contains filtered or unexported fields }
A complex type that contains zero or more Tag elements.
type TagResourceInput ¶
type TagResourceInput struct { // An ARN of a CloudFront resource. // // Resource is a required field Resource *string `location:"querystring" locationName:"Resource" type:"string" required:"true"` // A complex type that contains zero or more Tag elements. // // Tags is a required field Tags *Tags `locationName:"Tags" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to add tags to a CloudFront resource.
func (TagResourceInput) GoString ¶
func (s TagResourceInput) GoString() string
GoString returns the string representation
func (TagResourceInput) String ¶
func (s TagResourceInput) String() string
String returns the string representation
func (*TagResourceInput) Validate ¶
func (s *TagResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type TagResourceOutput ¶
type TagResourceOutput struct {
// contains filtered or unexported fields
}
func (TagResourceOutput) GoString ¶
func (s TagResourceOutput) GoString() string
GoString returns the string representation
func (TagResourceOutput) String ¶
func (s TagResourceOutput) String() string
String returns the string representation
type Tags ¶
type Tags struct { // A complex type that contains Tag elements. Items []*Tag `locationNameList:"Tag" type:"list"` // contains filtered or unexported fields }
A complex type that contains zero or more Tag elements.
type TrustedSigners ¶
type TrustedSigners struct { // Specifies whether you want to require viewers to use signed URLs to access // the files specified by PathPattern and TargetOriginId. // // Enabled is a required field Enabled *bool `type:"boolean" required:"true"` // Optional: A complex type that contains trusted signers for this cache behavior. // If Quantity is 0, you can omit Items. Items []*string `locationNameList:"AwsAccountNumber" type:"list"` // The number of trusted signers for this cache behavior. // // Quantity is a required field Quantity *int64 `type:"integer" required:"true"` // contains filtered or unexported fields }
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 PathPattern for this cache behavior, specify true for Enabled, and specify the applicable values for Quantity and Items. For more information, see Serving Private Content through CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) in the Amazon Amazon CloudFront Developer Guide.
If you don't want to require signed URLs in requests for objects that match PathPattern, specify false for Enabled and 0 for Quantity. Omit Items.
To add, change, or remove one or more trusted signers, change Enabled to true (if it's currently false), change Quantity as applicable, and specify all of the trusted signers that you want to include in the updated distribution.
For more information about updating the distribution configuration, see DistributionConfig .
func (TrustedSigners) GoString ¶
func (s TrustedSigners) GoString() string
GoString returns the string representation
func (TrustedSigners) String ¶
func (s TrustedSigners) String() string
String returns the string representation
func (*TrustedSigners) Validate ¶
func (s *TrustedSigners) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UntagResourceInput ¶
type UntagResourceInput struct { // An ARN of a CloudFront resource. // // Resource is a required field Resource *string `location:"querystring" locationName:"Resource" type:"string" required:"true"` // A complex type that contains zero or more Tag key elements. // // TagKeys is a required field TagKeys *TagKeys `locationName:"TagKeys" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to remove tags from a CloudFront resource.
func (UntagResourceInput) GoString ¶
func (s UntagResourceInput) GoString() string
GoString returns the string representation
func (UntagResourceInput) String ¶
func (s UntagResourceInput) String() string
String returns the string representation
func (*UntagResourceInput) Validate ¶
func (s *UntagResourceInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UntagResourceOutput ¶
type UntagResourceOutput struct {
// contains filtered or unexported fields
}
func (UntagResourceOutput) GoString ¶
func (s UntagResourceOutput) GoString() string
GoString returns the string representation
func (UntagResourceOutput) String ¶
func (s UntagResourceOutput) String() string
String returns the string representation
type UpdateCloudFrontOriginAccessIdentityInput ¶
type UpdateCloudFrontOriginAccessIdentityInput struct { // The identity's configuration information. // // CloudFrontOriginAccessIdentityConfig is a required field CloudFrontOriginAccessIdentityConfig *OriginAccessIdentityConfig `locationName:"CloudFrontOriginAccessIdentityConfig" type:"structure" required:"true"` // The identity's id. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // The value of the ETag header that you received when retrieving the identity's // configuration. For example: E2QWRUHAPOMQZL. IfMatch *string `location:"header" locationName:"If-Match" type:"string"` // contains filtered or unexported fields }
The request to update an origin access identity.
func (UpdateCloudFrontOriginAccessIdentityInput) GoString ¶
func (s UpdateCloudFrontOriginAccessIdentityInput) GoString() string
GoString returns the string representation
func (UpdateCloudFrontOriginAccessIdentityInput) String ¶
func (s UpdateCloudFrontOriginAccessIdentityInput) String() string
String returns the string representation
func (*UpdateCloudFrontOriginAccessIdentityInput) Validate ¶
func (s *UpdateCloudFrontOriginAccessIdentityInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateCloudFrontOriginAccessIdentityOutput ¶
type UpdateCloudFrontOriginAccessIdentityOutput struct { // The origin access identity's information. CloudFrontOriginAccessIdentity *OriginAccessIdentity `type:"structure"` // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (UpdateCloudFrontOriginAccessIdentityOutput) GoString ¶
func (s UpdateCloudFrontOriginAccessIdentityOutput) GoString() string
GoString returns the string representation
func (UpdateCloudFrontOriginAccessIdentityOutput) String ¶
func (s UpdateCloudFrontOriginAccessIdentityOutput) String() string
String returns the string representation
type UpdateDistributionInput ¶
type UpdateDistributionInput struct { // The distribution's configuration information. // // DistributionConfig is a required field DistributionConfig *DistributionConfig `locationName:"DistributionConfig" type:"structure" required:"true"` // The distribution's id. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // The value of the ETag header that you received when retrieving the distribution's // configuration. For example: E2QWRUHAPOMQZL. IfMatch *string `location:"header" locationName:"If-Match" type:"string"` // contains filtered or unexported fields }
The request to update a distribution.
func (UpdateDistributionInput) GoString ¶
func (s UpdateDistributionInput) GoString() string
GoString returns the string representation
func (UpdateDistributionInput) String ¶
func (s UpdateDistributionInput) String() string
String returns the string representation
func (*UpdateDistributionInput) Validate ¶
func (s *UpdateDistributionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateDistributionOutput ¶
type UpdateDistributionOutput struct { // The distribution's information. Distribution *Distribution `type:"structure"` // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (UpdateDistributionOutput) GoString ¶
func (s UpdateDistributionOutput) GoString() string
GoString returns the string representation
func (UpdateDistributionOutput) String ¶
func (s UpdateDistributionOutput) String() string
String returns the string representation
type UpdateStreamingDistributionInput ¶
type UpdateStreamingDistributionInput struct { // The streaming distribution's id. // // Id is a required field Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` // The value of the ETag header that you received when retrieving the streaming // distribution's configuration. For example: E2QWRUHAPOMQZL. IfMatch *string `location:"header" locationName:"If-Match" type:"string"` // The streaming distribution's configuration information. // // StreamingDistributionConfig is a required field StreamingDistributionConfig *StreamingDistributionConfig `locationName:"StreamingDistributionConfig" type:"structure" required:"true"` // contains filtered or unexported fields }
The request to update a streaming distribution.
func (UpdateStreamingDistributionInput) GoString ¶
func (s UpdateStreamingDistributionInput) GoString() string
GoString returns the string representation
func (UpdateStreamingDistributionInput) String ¶
func (s UpdateStreamingDistributionInput) String() string
String returns the string representation
func (*UpdateStreamingDistributionInput) Validate ¶
func (s *UpdateStreamingDistributionInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UpdateStreamingDistributionOutput ¶
type UpdateStreamingDistributionOutput struct { // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string `location:"header" locationName:"ETag" type:"string"` // The streaming distribution's information. StreamingDistribution *StreamingDistribution `type:"structure"` // contains filtered or unexported fields }
The returned result of the corresponding request.
func (UpdateStreamingDistributionOutput) GoString ¶
func (s UpdateStreamingDistributionOutput) GoString() string
GoString returns the string representation
func (UpdateStreamingDistributionOutput) String ¶
func (s UpdateStreamingDistributionOutput) String() string
String returns the string representation
type ViewerCertificate ¶
type ViewerCertificate struct { // If you want viewers to use HTTPS to request your objects and you're using // an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), // specify the ACM certificate ARN of the custom viewer certificate for this // distribution. Specify either this value, IAMCertificateId, or CloudFrontDefaultCertificate. ACMCertificateArn *string `type:"string"` // Include one of these values to specify the following: // // * Whether you want viewers to use HTTP or HTTPS to request your objects. // // * If you want viewers to use HTTPS, whether you're using an alternate // domain name such as example.com or the CloudFront domain name for your // distribution, such as d111111abcdef8.cloudfront.net. // // * If you're using an alternate domain name, whether AWS Certificate Manager // (ACM) provided the certificate, or you purchased a certificate from a // third-party certificate authority and imported it into ACM or uploaded // it to the IAM certificate store. // // You must specify one (and only one) of the three values. Do not specify false // for CloudFrontDefaultCertificate. // // If you want viewers to use HTTP to request your objects: Specify the following // value: // // <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate> // // In addition, specify allow-all for ViewerProtocolPolicy for all of your cache // behaviors. // // 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're using an alternate domain name, such as example.com: Specify // one of the following values, depending on whether ACM provided your certificate // or you purchased your certificate from third-party certificate authority: // // <ACMCertificateArn>ARN for ACM SSL/TLS certificate<ACMCertificateArn> where // ARN for ACM SSL/TLS certificate is the ARN for the ACM SSL/TLS certificate // that you want to use for this distribution. // // <IAMCertificateId>IAM certificate ID<IAMCertificateId> where IAM certificate // ID is the ID that IAM returned when you added the certificate to the IAM // certificate store. // // If you specify ACMCertificateArn or IAMCertificateId, you must also specify // a value for SSLSupportMethod. // // If you choose to use an ACM certificate or a certificate in the IAM certificate // store, we recommend that you use only an alternate domain name in your // object URLs (https://example.com/logo.jpg). If you use the domain name // that is associated with your CloudFront distribution (https://d111111abcdef8.cloudfront.net/logo.jpg) // and the viewer supports SNI, then CloudFront behaves normally. However, // if the browser does not support SNI, the user's experience depends on // the value that you choose for SSLSupportMethod: // // vip: The viewer displays a warning because there is a mismatch between the // CloudFront domain name and the domain name in your SSL/TLS certificate. // // sni-only: CloudFront drops the connection with the browser without returning // the object. // // * If you're using the CloudFront domain name for your distribution, such // as d111111abcdef8.cloudfront.net: Specify the following value: // // <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate> // // If you want viewers to use HTTPS, you must also specify one of the following // values in your cache behaviors: // // <ViewerProtocolPolicy>https-only<ViewerProtocolPolicy> // // <ViewerProtocolPolicy>redirect-to-https<ViewerProtocolPolicy> // // 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: // // <OriginProtocolPolicy>https-only<OriginProtocolPolicy> // // <OriginProtocolPolicy>match-viewer<OriginProtocolPolicy> // // For more information, see Using Alternate Domain Names and HTTPS (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html#CNAMEsAndHTTPS) // in the Amazon CloudFront Developer Guide. Certificate *string `deprecated:"true" type:"string"` // This field is deprecated. You can use one of the following: [ACMCertificateArn, // IAMCertificateId, or CloudFrontDefaultCertificate]. CertificateSource *string `deprecated:"true" type:"string" enum:"CertificateSource"` // If you want viewers to use HTTPS to request your objects and you're using // the CloudFront domain name of your distribution in your object URLs (for // example, https://d111111abcdef8.cloudfront.net/logo.jpg), set to true. Omit // this value if you are setting an ACMCertificateArn or IAMCertificateId. CloudFrontDefaultCertificate *bool `type:"boolean"` // If you want viewers to use HTTPS to request your objects and you're using // an alternate domain name in your object URLs (for example, https://example.com/logo.jpg), // specify the IAM certificate identifier of the custom viewer certificate for // this distribution. Specify either this value, ACMCertificateArn, or CloudFrontDefaultCertificate. IAMCertificateId *string `type:"string"` // Specify the minimum version of the SSL/TLS protocol that you want CloudFront // to use for HTTPS connections between viewers and CloudFront: SSLv3 or TLSv1. // CloudFront serves your objects only to viewers that support SSL/TLS version // that you specify and later versions. The TLSv1 protocol is more secure, so // we recommend that you specify SSLv3 only if your users are using browsers // or devices that don't support TLSv1. Note the following: // // * If you specify <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>, // the minimum SSL protocol version is TLSv1 and can't be changed. // // * If you're using a custom certificate (if you specify a value for ACMCertificateArn // or for IAMCertificateId) and if you're using SNI (if you specify sni-only // for SSLSupportMethod), you must specify TLSv1 for MinimumProtocolVersion. MinimumProtocolVersion *string `type:"string" enum:"MinimumProtocolVersion"` // If you specify a value for ACMCertificateArn or for IAMCertificateId, you // must also specify how you want CloudFront to serve HTTPS requests: using // a method that works for all clients or one that works for most clients: // // * vip: CloudFront uses dedicated IP addresses for your content and can // respond to HTTPS requests from any viewer. However, you must request permission // to use this feature, and you incur additional monthly charges. // // * sni-only: CloudFront can respond to HTTPS requests from viewers that // support Server Name Indication (SNI). All modern browsers support SNI, // but some browsers still in use don't support SNI. If some of your users' // browsers don't support SNI, we recommend that you do one of the following: // // Use the vip option (dedicated IP addresses) instead of sni-only. // // Use the CloudFront SSL/TLS certificate instead of a custom certificate. This // requires that you use the CloudFront domain name of your distribution // in the URLs for your objects, for example, https://d111111abcdef8.cloudfront.net/logo.png. // // If you can control which browser your users use, upgrade the browser to one // that supports SNI. // // Use HTTP instead of HTTPS. // // Do not specify a value for SSLSupportMethod if you specified <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>. // // For more information, see Using Alternate Domain Names and HTTPS (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html#CNAMEsAndHTTPS.html) // in the Amazon CloudFront Developer Guide. SSLSupportMethod *string `type:"string" enum:"SSLSupportMethod"` // contains filtered or unexported fields }
A complex type that specifies the following:
Which SSL/TLS certificate to use when viewers request objects using HTTPS
Whether you want CloudFront to use dedicated IP addresses or SNI when you're using alternate domain names in your object names
The minimum protocol version that you want CloudFront to use when communicating with viewers
For more information, see Using an HTTPS Connection to Access Your Objects (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html) in the Amazon Amazon CloudFront Developer Guide.
func (ViewerCertificate) GoString ¶
func (s ViewerCertificate) GoString() string
GoString returns the string representation
func (ViewerCertificate) String ¶
func (s ViewerCertificate) String() string
String returns the string representation
Directories ¶
Path | Synopsis |
---|---|
Package cloudfrontiface provides an interface to enable mocking the Amazon CloudFront service client for testing your code.
|
Package cloudfrontiface provides an interface to enable mocking the Amazon CloudFront service client for testing your code. |
Package sign provides utilities to generate signed URLs for Amazon CloudFront.
|
Package sign provides utilities to generate signed URLs for Amazon CloudFront. |