cloudfront

package
v1.13.19 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 22, 2018 License: Apache-2.0 Imports: 10 Imported by: 441

Documentation

Overview

Package cloudfront provides the client and types for making API requests to Amazon CloudFront.

This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about CloudFront API actions, data types, and errors. For detailed information about CloudFront features, see the Amazon CloudFront Developer Guide.

See https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25 for more information on this service.

See cloudfront package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/cloudfront/

Using the Client

To contact Amazon CloudFront with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the Amazon CloudFront client CloudFront for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/cloudfront/#New

Index

Examples

Constants

View Source
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"
)
View Source
const (
	// EventTypeViewerRequest is a EventType enum value
	EventTypeViewerRequest = "viewer-request"

	// EventTypeViewerResponse is a EventType enum value
	EventTypeViewerResponse = "viewer-response"

	// EventTypeOriginRequest is a EventType enum value
	EventTypeOriginRequest = "origin-request"

	// EventTypeOriginResponse is a EventType enum value
	EventTypeOriginResponse = "origin-response"
)
View Source
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"
)
View Source
const (
	// HttpVersionHttp11 is a HttpVersion enum value
	HttpVersionHttp11 = "http1.1"

	// HttpVersionHttp2 is a HttpVersion enum value
	HttpVersionHttp2 = "http2"
)
View Source
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"
)
View Source
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"
)
View Source
const (
	// MinimumProtocolVersionSslv3 is a MinimumProtocolVersion enum value
	MinimumProtocolVersionSslv3 = "SSLv3"

	// MinimumProtocolVersionTlsv1 is a MinimumProtocolVersion enum value
	MinimumProtocolVersionTlsv1 = "TLSv1"

	// MinimumProtocolVersionTlsv12016 is a MinimumProtocolVersion enum value
	MinimumProtocolVersionTlsv12016 = "TLSv1_2016"

	// MinimumProtocolVersionTlsv112016 is a MinimumProtocolVersion enum value
	MinimumProtocolVersionTlsv112016 = "TLSv1.1_2016"

	// MinimumProtocolVersionTlsv122018 is a MinimumProtocolVersion enum value
	MinimumProtocolVersionTlsv122018 = "TLSv1.2_2018"
)
View Source
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"
)
View Source
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"
)
View Source
const (
	// SSLSupportMethodSniOnly is a SSLSupportMethod enum value
	SSLSupportMethodSniOnly = "sni-only"

	// SSLSupportMethodVip is a SSLSupportMethod enum value
	SSLSupportMethodVip = "vip"
)
View Source
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"
)
View Source
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"
)
View Source
const (

	// ErrCodeAccessDenied for service response error code
	// "AccessDenied".
	//
	// Access denied.
	ErrCodeAccessDenied = "AccessDenied"

	// ErrCodeBatchTooLarge for service response error code
	// "BatchTooLarge".
	ErrCodeBatchTooLarge = "BatchTooLarge"

	// ErrCodeCNAMEAlreadyExists for service response error code
	// "CNAMEAlreadyExists".
	ErrCodeCNAMEAlreadyExists = "CNAMEAlreadyExists"

	// ErrCodeDistributionAlreadyExists for service response error code
	// "DistributionAlreadyExists".
	//
	// The caller reference you attempted to create the distribution with is associated
	// with another distribution.
	ErrCodeDistributionAlreadyExists = "DistributionAlreadyExists"

	// ErrCodeDistributionNotDisabled for service response error code
	// "DistributionNotDisabled".
	ErrCodeDistributionNotDisabled = "DistributionNotDisabled"

	// ErrCodeIllegalUpdate for service response error code
	// "IllegalUpdate".
	//
	// Origin and CallerReference cannot be updated.
	ErrCodeIllegalUpdate = "IllegalUpdate"

	// ErrCodeInconsistentQuantities for service response error code
	// "InconsistentQuantities".
	//
	// The value of Quantity and the size of Items don't match.
	ErrCodeInconsistentQuantities = "InconsistentQuantities"

	// ErrCodeInvalidArgument for service response error code
	// "InvalidArgument".
	//
	// The argument is invalid.
	ErrCodeInvalidArgument = "InvalidArgument"

	// ErrCodeInvalidDefaultRootObject for service response error code
	// "InvalidDefaultRootObject".
	//
	// The default root object file name is too big or contains an invalid character.
	ErrCodeInvalidDefaultRootObject = "InvalidDefaultRootObject"

	// ErrCodeInvalidErrorCode for service response error code
	// "InvalidErrorCode".
	ErrCodeInvalidErrorCode = "InvalidErrorCode"

	// ErrCodeInvalidForwardCookies for service response error code
	// "InvalidForwardCookies".
	//
	// Your request contains forward cookies option which doesn't match with the
	// expectation for the whitelisted list of cookie names. Either list of cookie
	// names has been specified when not allowed or list of cookie names is missing
	// when expected.
	ErrCodeInvalidForwardCookies = "InvalidForwardCookies"

	// ErrCodeInvalidGeoRestrictionParameter for service response error code
	// "InvalidGeoRestrictionParameter".
	ErrCodeInvalidGeoRestrictionParameter = "InvalidGeoRestrictionParameter"

	// ErrCodeInvalidHeadersForS3Origin for service response error code
	// "InvalidHeadersForS3Origin".
	ErrCodeInvalidHeadersForS3Origin = "InvalidHeadersForS3Origin"

	// ErrCodeInvalidIfMatchVersion for service response error code
	// "InvalidIfMatchVersion".
	//
	// The If-Match version is missing or not valid for the distribution.
	ErrCodeInvalidIfMatchVersion = "InvalidIfMatchVersion"

	// ErrCodeInvalidLambdaFunctionAssociation for service response error code
	// "InvalidLambdaFunctionAssociation".
	//
	// The specified Lambda function association is invalid.
	ErrCodeInvalidLambdaFunctionAssociation = "InvalidLambdaFunctionAssociation"

	// ErrCodeInvalidLocationCode for service response error code
	// "InvalidLocationCode".
	ErrCodeInvalidLocationCode = "InvalidLocationCode"

	// ErrCodeInvalidMinimumProtocolVersion for service response error code
	// "InvalidMinimumProtocolVersion".
	ErrCodeInvalidMinimumProtocolVersion = "InvalidMinimumProtocolVersion"

	// ErrCodeInvalidOrigin for service response error code
	// "InvalidOrigin".
	//
	// The Amazon S3 origin server specified does not refer to a valid Amazon S3
	// bucket.
	ErrCodeInvalidOrigin = "InvalidOrigin"

	// ErrCodeInvalidOriginAccessIdentity for service response error code
	// "InvalidOriginAccessIdentity".
	//
	// The origin access identity is not valid or doesn't exist.
	ErrCodeInvalidOriginAccessIdentity = "InvalidOriginAccessIdentity"

	// ErrCodeInvalidOriginKeepaliveTimeout for service response error code
	// "InvalidOriginKeepaliveTimeout".
	ErrCodeInvalidOriginKeepaliveTimeout = "InvalidOriginKeepaliveTimeout"

	// ErrCodeInvalidOriginReadTimeout for service response error code
	// "InvalidOriginReadTimeout".
	ErrCodeInvalidOriginReadTimeout = "InvalidOriginReadTimeout"

	// ErrCodeInvalidProtocolSettings for service response error code
	// "InvalidProtocolSettings".
	//
	// You cannot specify SSLv3 as the minimum protocol version if you only want
	// to support only clients that support Server Name Indication (SNI).
	ErrCodeInvalidProtocolSettings = "InvalidProtocolSettings"

	// ErrCodeInvalidQueryStringParameters for service response error code
	// "InvalidQueryStringParameters".
	ErrCodeInvalidQueryStringParameters = "InvalidQueryStringParameters"

	// ErrCodeInvalidRelativePath for service response error code
	// "InvalidRelativePath".
	//
	// The relative path is too big, is not URL-encoded, or does not begin with
	// a slash (/).
	ErrCodeInvalidRelativePath = "InvalidRelativePath"

	// ErrCodeInvalidRequiredProtocol for service response error code
	// "InvalidRequiredProtocol".
	//
	// This operation requires the HTTPS protocol. Ensure that you specify the HTTPS
	// protocol in your request, or omit the RequiredProtocols element from your
	// distribution configuration.
	ErrCodeInvalidRequiredProtocol = "InvalidRequiredProtocol"

	// ErrCodeInvalidResponseCode for service response error code
	// "InvalidResponseCode".
	ErrCodeInvalidResponseCode = "InvalidResponseCode"

	// ErrCodeInvalidTTLOrder for service response error code
	// "InvalidTTLOrder".
	ErrCodeInvalidTTLOrder = "InvalidTTLOrder"

	// ErrCodeInvalidTagging for service response error code
	// "InvalidTagging".
	ErrCodeInvalidTagging = "InvalidTagging"

	// ErrCodeInvalidViewerCertificate for service response error code
	// "InvalidViewerCertificate".
	ErrCodeInvalidViewerCertificate = "InvalidViewerCertificate"

	// ErrCodeInvalidWebACLId for service response error code
	// "InvalidWebACLId".
	ErrCodeInvalidWebACLId = "InvalidWebACLId"

	// ErrCodeMissingBody for service response error code
	// "MissingBody".
	//
	// This operation requires a body. Ensure that the body is present and the Content-Type
	// header is set.
	ErrCodeMissingBody = "MissingBody"

	// ErrCodeNoSuchCloudFrontOriginAccessIdentity for service response error code
	// "NoSuchCloudFrontOriginAccessIdentity".
	//
	// The specified origin access identity does not exist.
	ErrCodeNoSuchCloudFrontOriginAccessIdentity = "NoSuchCloudFrontOriginAccessIdentity"

	// ErrCodeNoSuchDistribution for service response error code
	// "NoSuchDistribution".
	//
	// The specified distribution does not exist.
	ErrCodeNoSuchDistribution = "NoSuchDistribution"

	// ErrCodeNoSuchInvalidation for service response error code
	// "NoSuchInvalidation".
	//
	// The specified invalidation does not exist.
	ErrCodeNoSuchInvalidation = "NoSuchInvalidation"

	// ErrCodeNoSuchOrigin for service response error code
	// "NoSuchOrigin".
	//
	// No origin exists with the specified Origin Id.
	ErrCodeNoSuchOrigin = "NoSuchOrigin"

	// ErrCodeNoSuchResource for service response error code
	// "NoSuchResource".
	ErrCodeNoSuchResource = "NoSuchResource"

	// ErrCodeNoSuchStreamingDistribution for service response error code
	// "NoSuchStreamingDistribution".
	//
	// The specified streaming distribution does not exist.
	ErrCodeNoSuchStreamingDistribution = "NoSuchStreamingDistribution"

	// ErrCodeOriginAccessIdentityAlreadyExists for service response error code
	// "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.
	ErrCodeOriginAccessIdentityAlreadyExists = "OriginAccessIdentityAlreadyExists"

	// ErrCodeOriginAccessIdentityInUse for service response error code
	// "OriginAccessIdentityInUse".
	ErrCodeOriginAccessIdentityInUse = "OriginAccessIdentityInUse"

	// ErrCodePreconditionFailed for service response error code
	// "PreconditionFailed".
	//
	// The precondition given in one or more of the request-header fields evaluated
	// to false.
	ErrCodePreconditionFailed = "PreconditionFailed"

	// ErrCodeResourceInUse for service response error code
	// "ResourceInUse".
	ErrCodeResourceInUse = "ResourceInUse"

	// ErrCodeStreamingDistributionAlreadyExists for service response error code
	// "StreamingDistributionAlreadyExists".
	ErrCodeStreamingDistributionAlreadyExists = "StreamingDistributionAlreadyExists"

	// ErrCodeStreamingDistributionNotDisabled for service response error code
	// "StreamingDistributionNotDisabled".
	ErrCodeStreamingDistributionNotDisabled = "StreamingDistributionNotDisabled"

	// ErrCodeTooManyCacheBehaviors for service response error code
	// "TooManyCacheBehaviors".
	//
	// You cannot create more cache behaviors for the distribution.
	ErrCodeTooManyCacheBehaviors = "TooManyCacheBehaviors"

	// ErrCodeTooManyCertificates for service response error code
	// "TooManyCertificates".
	//
	// You cannot create anymore custom SSL/TLS certificates.
	ErrCodeTooManyCertificates = "TooManyCertificates"

	// ErrCodeTooManyCloudFrontOriginAccessIdentities for service response error code
	// "TooManyCloudFrontOriginAccessIdentities".
	//
	// Processing your request would cause you to exceed the maximum number of origin
	// access identities allowed.
	ErrCodeTooManyCloudFrontOriginAccessIdentities = "TooManyCloudFrontOriginAccessIdentities"

	// ErrCodeTooManyCookieNamesInWhiteList for service response error code
	// "TooManyCookieNamesInWhiteList".
	//
	// Your request contains more cookie names in the whitelist than are allowed
	// per cache behavior.
	ErrCodeTooManyCookieNamesInWhiteList = "TooManyCookieNamesInWhiteList"

	// ErrCodeTooManyDistributionCNAMEs for service response error code
	// "TooManyDistributionCNAMEs".
	//
	// Your request contains more CNAMEs than are allowed per distribution.
	ErrCodeTooManyDistributionCNAMEs = "TooManyDistributionCNAMEs"

	// ErrCodeTooManyDistributions for service response error code
	// "TooManyDistributions".
	//
	// Processing your request would cause you to exceed the maximum number of distributions
	// allowed.
	ErrCodeTooManyDistributions = "TooManyDistributions"

	// ErrCodeTooManyDistributionsWithLambdaAssociations for service response error code
	// "TooManyDistributionsWithLambdaAssociations".
	//
	// Processing your request would cause the maximum number of distributions with
	// Lambda function associations per owner to be exceeded.
	ErrCodeTooManyDistributionsWithLambdaAssociations = "TooManyDistributionsWithLambdaAssociations"

	// ErrCodeTooManyHeadersInForwardedValues for service response error code
	// "TooManyHeadersInForwardedValues".
	ErrCodeTooManyHeadersInForwardedValues = "TooManyHeadersInForwardedValues"

	// ErrCodeTooManyInvalidationsInProgress for service response error code
	// "TooManyInvalidationsInProgress".
	//
	// You have exceeded the maximum number of allowable InProgress invalidation
	// batch requests, or invalidation objects.
	ErrCodeTooManyInvalidationsInProgress = "TooManyInvalidationsInProgress"

	// ErrCodeTooManyLambdaFunctionAssociations for service response error code
	// "TooManyLambdaFunctionAssociations".
	//
	// Your request contains more Lambda function associations than are allowed
	// per distribution.
	ErrCodeTooManyLambdaFunctionAssociations = "TooManyLambdaFunctionAssociations"

	// ErrCodeTooManyOriginCustomHeaders for service response error code
	// "TooManyOriginCustomHeaders".
	ErrCodeTooManyOriginCustomHeaders = "TooManyOriginCustomHeaders"

	// ErrCodeTooManyOrigins for service response error code
	// "TooManyOrigins".
	//
	// You cannot create more origins for the distribution.
	ErrCodeTooManyOrigins = "TooManyOrigins"

	// ErrCodeTooManyQueryStringParameters for service response error code
	// "TooManyQueryStringParameters".
	ErrCodeTooManyQueryStringParameters = "TooManyQueryStringParameters"

	// ErrCodeTooManyStreamingDistributionCNAMEs for service response error code
	// "TooManyStreamingDistributionCNAMEs".
	ErrCodeTooManyStreamingDistributionCNAMEs = "TooManyStreamingDistributionCNAMEs"

	// ErrCodeTooManyStreamingDistributions for service response error code
	// "TooManyStreamingDistributions".
	//
	// Processing your request would cause you to exceed the maximum number of streaming
	// distributions allowed.
	ErrCodeTooManyStreamingDistributions = "TooManyStreamingDistributions"

	// ErrCodeTooManyTrustedSigners for service response error code
	// "TooManyTrustedSigners".
	//
	// Your request contains more trusted signers than are allowed per distribution.
	ErrCodeTooManyTrustedSigners = "TooManyTrustedSigners"

	// ErrCodeTrustedSignerDoesNotExist for service response error code
	// "TrustedSignerDoesNotExist".
	//
	// One or more of your trusted signers don't exist.
	ErrCodeTrustedSignerDoesNotExist = "TrustedSignerDoesNotExist"
)
View Source
const (
	ServiceName = "cloudfront" // Service endpoint prefix API calls made to.
	EndpointsID = ServiceName  // Service ID for Regions and Endpoints metadata.
)

Service information constants

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 added in v0.6.5

func (s ActiveTrustedSigners) GoString() string

GoString returns the string representation

func (*ActiveTrustedSigners) SetEnabled added in v1.5.0

SetEnabled sets the Enabled field's value.

func (*ActiveTrustedSigners) SetItems added in v1.5.0

SetItems sets the Items field's value.

func (*ActiveTrustedSigners) SetQuantity added in v1.5.0

func (s *ActiveTrustedSigners) SetQuantity(v int64) *ActiveTrustedSigners

SetQuantity sets the Quantity field's value.

func (ActiveTrustedSigners) String added in v0.6.5

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.

func (Aliases) GoString added in v0.6.5

func (s Aliases) GoString() string

GoString returns the string representation

func (*Aliases) SetItems added in v1.5.0

func (s *Aliases) SetItems(v []*string) *Aliases

SetItems sets the Items field's value.

func (*Aliases) SetQuantity added in v1.5.0

func (s *Aliases) SetQuantity(v int64) *Aliases

SetQuantity sets the Quantity field's value.

func (Aliases) String added in v0.6.5

func (s Aliases) String() string

String returns the string representation

func (*Aliases) Validate added in v1.1.21

func (s *Aliases) Validate() error

Validate inspects the fields of the type to determine if they are valid.

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 added in v0.6.5

func (s AllowedMethods) GoString() string

GoString returns the string representation

func (*AllowedMethods) SetCachedMethods added in v1.5.0

func (s *AllowedMethods) SetCachedMethods(v *CachedMethods) *AllowedMethods

SetCachedMethods sets the CachedMethods field's value.

func (*AllowedMethods) SetItems added in v1.5.0

func (s *AllowedMethods) SetItems(v []*string) *AllowedMethods

SetItems sets the Items field's value.

func (*AllowedMethods) SetQuantity added in v1.5.0

func (s *AllowedMethods) SetQuantity(v int64) *AllowedMethods

SetQuantity sets the Quantity field's value.

func (AllowedMethods) String added in v0.6.5

func (s AllowedMethods) String() string

String returns the string representation

func (*AllowedMethods) Validate added in v1.1.21

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"`

	// A complex type that contains zero or more Lambda function associations for
	// a cache behavior.
	LambdaFunctionAssociations *LambdaFunctionAssociations `type:"structure"`

	// 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 added in v0.6.5

func (s CacheBehavior) GoString() string

GoString returns the string representation

func (*CacheBehavior) SetAllowedMethods added in v1.5.0

func (s *CacheBehavior) SetAllowedMethods(v *AllowedMethods) *CacheBehavior

SetAllowedMethods sets the AllowedMethods field's value.

func (*CacheBehavior) SetCompress added in v1.5.0

func (s *CacheBehavior) SetCompress(v bool) *CacheBehavior

SetCompress sets the Compress field's value.

func (*CacheBehavior) SetDefaultTTL added in v1.5.0

func (s *CacheBehavior) SetDefaultTTL(v int64) *CacheBehavior

SetDefaultTTL sets the DefaultTTL field's value.

func (*CacheBehavior) SetForwardedValues added in v1.5.0

func (s *CacheBehavior) SetForwardedValues(v *ForwardedValues) *CacheBehavior

SetForwardedValues sets the ForwardedValues field's value.

func (*CacheBehavior) SetLambdaFunctionAssociations added in v1.6.2

func (s *CacheBehavior) SetLambdaFunctionAssociations(v *LambdaFunctionAssociations) *CacheBehavior

SetLambdaFunctionAssociations sets the LambdaFunctionAssociations field's value.

func (*CacheBehavior) SetMaxTTL added in v1.5.0

func (s *CacheBehavior) SetMaxTTL(v int64) *CacheBehavior

SetMaxTTL sets the MaxTTL field's value.

func (*CacheBehavior) SetMinTTL added in v1.5.0

func (s *CacheBehavior) SetMinTTL(v int64) *CacheBehavior

SetMinTTL sets the MinTTL field's value.

func (*CacheBehavior) SetPathPattern added in v1.5.0

func (s *CacheBehavior) SetPathPattern(v string) *CacheBehavior

SetPathPattern sets the PathPattern field's value.

func (*CacheBehavior) SetSmoothStreaming added in v1.5.0

func (s *CacheBehavior) SetSmoothStreaming(v bool) *CacheBehavior

SetSmoothStreaming sets the SmoothStreaming field's value.

func (*CacheBehavior) SetTargetOriginId added in v1.5.0

func (s *CacheBehavior) SetTargetOriginId(v string) *CacheBehavior

SetTargetOriginId sets the TargetOriginId field's value.

func (*CacheBehavior) SetTrustedSigners added in v1.5.0

func (s *CacheBehavior) SetTrustedSigners(v *TrustedSigners) *CacheBehavior

SetTrustedSigners sets the TrustedSigners field's value.

func (*CacheBehavior) SetViewerProtocolPolicy added in v1.5.0

func (s *CacheBehavior) SetViewerProtocolPolicy(v string) *CacheBehavior

SetViewerProtocolPolicy sets the ViewerProtocolPolicy field's value.

func (CacheBehavior) String added in v0.6.5

func (s CacheBehavior) String() string

String returns the string representation

func (*CacheBehavior) Validate added in v1.1.21

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 added in v0.6.5

func (s CacheBehaviors) GoString() string

GoString returns the string representation

func (*CacheBehaviors) SetItems added in v1.5.0

func (s *CacheBehaviors) SetItems(v []*CacheBehavior) *CacheBehaviors

SetItems sets the Items field's value.

func (*CacheBehaviors) SetQuantity added in v1.5.0

func (s *CacheBehaviors) SetQuantity(v int64) *CacheBehaviors

SetQuantity sets the Quantity field's value.

func (CacheBehaviors) String added in v0.6.5

func (s CacheBehaviors) String() string

String returns the string representation

func (*CacheBehaviors) Validate added in v1.1.21

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 added in v0.6.5

func (s CachedMethods) GoString() string

GoString returns the string representation

func (*CachedMethods) SetItems added in v1.5.0

func (s *CachedMethods) SetItems(v []*string) *CachedMethods

SetItems sets the Items field's value.

func (*CachedMethods) SetQuantity added in v1.5.0

func (s *CachedMethods) SetQuantity(v int64) *CachedMethods

SetQuantity sets the Quantity field's value.

func (CachedMethods) String added in v0.6.5

func (s CachedMethods) String() string

String returns the string representation

func (*CachedMethods) Validate added in v1.1.21

func (s *CachedMethods) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CloudFront

type CloudFront struct {
	*client.Client
}

CloudFront provides the API operation methods for making requests to Amazon CloudFront. See this package's package overview docs for details on the service.

CloudFront methods are safe to use concurrently. It is not safe to modify mutate any of the struct'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

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:

  • ErrCodeOriginAccessIdentityAlreadyExists "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.

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeTooManyCloudFrontOriginAccessIdentities "TooManyCloudFrontOriginAccessIdentities" Processing your request would cause you to exceed the maximum number of origin access identities allowed.

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateCloudFrontOriginAccessIdentity

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.CreateCloudFrontOriginAccessIdentityInput{}

	result, err := svc.CreateCloudFrontOriginAccessIdentity(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeOriginAccessIdentityAlreadyExists:
				fmt.Println(cloudfront.ErrCodeOriginAccessIdentityAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeMissingBody:
				fmt.Println(cloudfront.ErrCodeMissingBody, aerr.Error())
			case cloudfront.ErrCodeTooManyCloudFrontOriginAccessIdentities:
				fmt.Println(cloudfront.ErrCodeTooManyCloudFrontOriginAccessIdentities, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInconsistentQuantities:
				fmt.Println(cloudfront.ErrCodeInconsistentQuantities, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateCloudFrontOriginAccessIdentity for more information on using the CreateCloudFrontOriginAccessIdentity API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateCloudFrontOriginAccessIdentity

func (*CloudFront) CreateCloudFrontOriginAccessIdentityWithContext added in v1.8.0

func (c *CloudFront) CreateCloudFrontOriginAccessIdentityWithContext(ctx aws.Context, input *CreateCloudFrontOriginAccessIdentityInput, opts ...request.Option) (*CreateCloudFrontOriginAccessIdentityOutput, error)

CreateCloudFrontOriginAccessIdentityWithContext is the same as CreateCloudFrontOriginAccessIdentity with the addition of the ability to pass a context and additional request options.

See CreateCloudFrontOriginAccessIdentity for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) CreateDistribution

func (c *CloudFront) CreateDistribution(input *CreateDistributionInput) (*CreateDistributionOutput, error)

CreateDistribution API operation for Amazon CloudFront.

Creates a new web distribution. Send a POST request to the /CloudFront API version/distribution/distribution ID resource.

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 CreateDistribution for usage and error information.

Returned Error Codes:

  • ErrCodeCNAMEAlreadyExists "CNAMEAlreadyExists"

  • ErrCodeDistributionAlreadyExists "DistributionAlreadyExists" The caller reference you attempted to create the distribution with is associated with another distribution.

  • ErrCodeInvalidOrigin "InvalidOrigin" The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

  • ErrCodeInvalidOriginAccessIdentity "InvalidOriginAccessIdentity" The origin access identity is not valid or doesn't exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeTooManyTrustedSigners "TooManyTrustedSigners" Your request contains more trusted signers than are allowed per distribution.

  • ErrCodeTrustedSignerDoesNotExist "TrustedSignerDoesNotExist" One or more of your trusted signers don't exist.

  • ErrCodeInvalidViewerCertificate "InvalidViewerCertificate"

  • ErrCodeInvalidMinimumProtocolVersion "InvalidMinimumProtocolVersion"

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeTooManyDistributionCNAMEs "TooManyDistributionCNAMEs" Your request contains more CNAMEs than are allowed per distribution.

  • ErrCodeTooManyDistributions "TooManyDistributions" Processing your request would cause you to exceed the maximum number of distributions allowed.

  • ErrCodeInvalidDefaultRootObject "InvalidDefaultRootObject" The default root object file name is too big or contains an invalid character.

  • ErrCodeInvalidRelativePath "InvalidRelativePath" The relative path is too big, is not URL-encoded, or does not begin with a slash (/).

  • ErrCodeInvalidErrorCode "InvalidErrorCode"

  • ErrCodeInvalidResponseCode "InvalidResponseCode"

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInvalidRequiredProtocol "InvalidRequiredProtocol" This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.

  • ErrCodeNoSuchOrigin "NoSuchOrigin" No origin exists with the specified Origin Id.

  • ErrCodeTooManyOrigins "TooManyOrigins" You cannot create more origins for the distribution.

  • ErrCodeTooManyCacheBehaviors "TooManyCacheBehaviors" You cannot create more cache behaviors for the distribution.

  • ErrCodeTooManyCookieNamesInWhiteList "TooManyCookieNamesInWhiteList" Your request contains more cookie names in the whitelist than are allowed per cache behavior.

  • ErrCodeInvalidForwardCookies "InvalidForwardCookies" Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.

  • ErrCodeTooManyHeadersInForwardedValues "TooManyHeadersInForwardedValues"

  • ErrCodeInvalidHeadersForS3Origin "InvalidHeadersForS3Origin"

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

  • ErrCodeTooManyCertificates "TooManyCertificates" You cannot create anymore custom SSL/TLS certificates.

  • ErrCodeInvalidLocationCode "InvalidLocationCode"

  • ErrCodeInvalidGeoRestrictionParameter "InvalidGeoRestrictionParameter"

  • ErrCodeInvalidProtocolSettings "InvalidProtocolSettings" You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that support Server Name Indication (SNI).

  • ErrCodeInvalidTTLOrder "InvalidTTLOrder"

  • ErrCodeInvalidWebACLId "InvalidWebACLId"

  • ErrCodeTooManyOriginCustomHeaders "TooManyOriginCustomHeaders"

  • ErrCodeTooManyQueryStringParameters "TooManyQueryStringParameters"

  • ErrCodeInvalidQueryStringParameters "InvalidQueryStringParameters"

  • ErrCodeTooManyDistributionsWithLambdaAssociations "TooManyDistributionsWithLambdaAssociations" Processing your request would cause the maximum number of distributions with Lambda function associations per owner to be exceeded.

  • ErrCodeTooManyLambdaFunctionAssociations "TooManyLambdaFunctionAssociations" Your request contains more Lambda function associations than are allowed per distribution.

  • ErrCodeInvalidLambdaFunctionAssociation "InvalidLambdaFunctionAssociation" The specified Lambda function association is invalid.

  • ErrCodeInvalidOriginReadTimeout "InvalidOriginReadTimeout"

  • ErrCodeInvalidOriginKeepaliveTimeout "InvalidOriginKeepaliveTimeout"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateDistribution

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.CreateDistributionInput{}

	result, err := svc.CreateDistribution(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeCNAMEAlreadyExists:
				fmt.Println(cloudfront.ErrCodeCNAMEAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeDistributionAlreadyExists:
				fmt.Println(cloudfront.ErrCodeDistributionAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeInvalidOrigin:
				fmt.Println(cloudfront.ErrCodeInvalidOrigin, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeInvalidOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeTooManyTrustedSigners:
				fmt.Println(cloudfront.ErrCodeTooManyTrustedSigners, aerr.Error())
			case cloudfront.ErrCodeTrustedSignerDoesNotExist:
				fmt.Println(cloudfront.ErrCodeTrustedSignerDoesNotExist, aerr.Error())
			case cloudfront.ErrCodeInvalidViewerCertificate:
				fmt.Println(cloudfront.ErrCodeInvalidViewerCertificate, aerr.Error())
			case cloudfront.ErrCodeInvalidMinimumProtocolVersion:
				fmt.Println(cloudfront.ErrCodeInvalidMinimumProtocolVersion, aerr.Error())
			case cloudfront.ErrCodeMissingBody:
				fmt.Println(cloudfront.ErrCodeMissingBody, aerr.Error())
			case cloudfront.ErrCodeTooManyDistributionCNAMEs:
				fmt.Println(cloudfront.ErrCodeTooManyDistributionCNAMEs, aerr.Error())
			case cloudfront.ErrCodeTooManyDistributions:
				fmt.Println(cloudfront.ErrCodeTooManyDistributions, aerr.Error())
			case cloudfront.ErrCodeInvalidDefaultRootObject:
				fmt.Println(cloudfront.ErrCodeInvalidDefaultRootObject, aerr.Error())
			case cloudfront.ErrCodeInvalidRelativePath:
				fmt.Println(cloudfront.ErrCodeInvalidRelativePath, aerr.Error())
			case cloudfront.ErrCodeInvalidErrorCode:
				fmt.Println(cloudfront.ErrCodeInvalidErrorCode, aerr.Error())
			case cloudfront.ErrCodeInvalidResponseCode:
				fmt.Println(cloudfront.ErrCodeInvalidResponseCode, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInvalidRequiredProtocol:
				fmt.Println(cloudfront.ErrCodeInvalidRequiredProtocol, aerr.Error())
			case cloudfront.ErrCodeNoSuchOrigin:
				fmt.Println(cloudfront.ErrCodeNoSuchOrigin, aerr.Error())
			case cloudfront.ErrCodeTooManyOrigins:
				fmt.Println(cloudfront.ErrCodeTooManyOrigins, aerr.Error())
			case cloudfront.ErrCodeTooManyCacheBehaviors:
				fmt.Println(cloudfront.ErrCodeTooManyCacheBehaviors, aerr.Error())
			case cloudfront.ErrCodeTooManyCookieNamesInWhiteList:
				fmt.Println(cloudfront.ErrCodeTooManyCookieNamesInWhiteList, aerr.Error())
			case cloudfront.ErrCodeInvalidForwardCookies:
				fmt.Println(cloudfront.ErrCodeInvalidForwardCookies, aerr.Error())
			case cloudfront.ErrCodeTooManyHeadersInForwardedValues:
				fmt.Println(cloudfront.ErrCodeTooManyHeadersInForwardedValues, aerr.Error())
			case cloudfront.ErrCodeInvalidHeadersForS3Origin:
				fmt.Println(cloudfront.ErrCodeInvalidHeadersForS3Origin, aerr.Error())
			case cloudfront.ErrCodeInconsistentQuantities:
				fmt.Println(cloudfront.ErrCodeInconsistentQuantities, aerr.Error())
			case cloudfront.ErrCodeTooManyCertificates:
				fmt.Println(cloudfront.ErrCodeTooManyCertificates, aerr.Error())
			case cloudfront.ErrCodeInvalidLocationCode:
				fmt.Println(cloudfront.ErrCodeInvalidLocationCode, aerr.Error())
			case cloudfront.ErrCodeInvalidGeoRestrictionParameter:
				fmt.Println(cloudfront.ErrCodeInvalidGeoRestrictionParameter, aerr.Error())
			case cloudfront.ErrCodeInvalidProtocolSettings:
				fmt.Println(cloudfront.ErrCodeInvalidProtocolSettings, aerr.Error())
			case cloudfront.ErrCodeInvalidTTLOrder:
				fmt.Println(cloudfront.ErrCodeInvalidTTLOrder, aerr.Error())
			case cloudfront.ErrCodeInvalidWebACLId:
				fmt.Println(cloudfront.ErrCodeInvalidWebACLId, aerr.Error())
			case cloudfront.ErrCodeTooManyOriginCustomHeaders:
				fmt.Println(cloudfront.ErrCodeTooManyOriginCustomHeaders, aerr.Error())
			case cloudfront.ErrCodeTooManyQueryStringParameters:
				fmt.Println(cloudfront.ErrCodeTooManyQueryStringParameters, aerr.Error())
			case cloudfront.ErrCodeInvalidQueryStringParameters:
				fmt.Println(cloudfront.ErrCodeInvalidQueryStringParameters, aerr.Error())
			case cloudfront.ErrCodeTooManyDistributionsWithLambdaAssociations:
				fmt.Println(cloudfront.ErrCodeTooManyDistributionsWithLambdaAssociations, aerr.Error())
			case cloudfront.ErrCodeTooManyLambdaFunctionAssociations:
				fmt.Println(cloudfront.ErrCodeTooManyLambdaFunctionAssociations, aerr.Error())
			case cloudfront.ErrCodeInvalidLambdaFunctionAssociation:
				fmt.Println(cloudfront.ErrCodeInvalidLambdaFunctionAssociation, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginReadTimeout:
				fmt.Println(cloudfront.ErrCodeInvalidOriginReadTimeout, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginKeepaliveTimeout:
				fmt.Println(cloudfront.ErrCodeInvalidOriginKeepaliveTimeout, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateDistribution for more information on using the CreateDistribution API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateDistribution

func (*CloudFront) CreateDistributionWithContext added in v1.8.0

func (c *CloudFront) CreateDistributionWithContext(ctx aws.Context, input *CreateDistributionInput, opts ...request.Option) (*CreateDistributionOutput, error)

CreateDistributionWithContext is the same as CreateDistribution with the addition of the ability to pass a context and additional request options.

See CreateDistribution for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) CreateDistributionWithTags added in v1.4.0

func (c *CloudFront) CreateDistributionWithTags(input *CreateDistributionWithTagsInput) (*CreateDistributionWithTagsOutput, error)

CreateDistributionWithTags API operation for Amazon CloudFront.

Create a new distribution with tags.

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 CreateDistributionWithTags for usage and error information.

Returned Error Codes:

  • ErrCodeCNAMEAlreadyExists "CNAMEAlreadyExists"

  • ErrCodeDistributionAlreadyExists "DistributionAlreadyExists" The caller reference you attempted to create the distribution with is associated with another distribution.

  • ErrCodeInvalidOrigin "InvalidOrigin" The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

  • ErrCodeInvalidOriginAccessIdentity "InvalidOriginAccessIdentity" The origin access identity is not valid or doesn't exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeTooManyTrustedSigners "TooManyTrustedSigners" Your request contains more trusted signers than are allowed per distribution.

  • ErrCodeTrustedSignerDoesNotExist "TrustedSignerDoesNotExist" One or more of your trusted signers don't exist.

  • ErrCodeInvalidViewerCertificate "InvalidViewerCertificate"

  • ErrCodeInvalidMinimumProtocolVersion "InvalidMinimumProtocolVersion"

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeTooManyDistributionCNAMEs "TooManyDistributionCNAMEs" Your request contains more CNAMEs than are allowed per distribution.

  • ErrCodeTooManyDistributions "TooManyDistributions" Processing your request would cause you to exceed the maximum number of distributions allowed.

  • ErrCodeInvalidDefaultRootObject "InvalidDefaultRootObject" The default root object file name is too big or contains an invalid character.

  • ErrCodeInvalidRelativePath "InvalidRelativePath" The relative path is too big, is not URL-encoded, or does not begin with a slash (/).

  • ErrCodeInvalidErrorCode "InvalidErrorCode"

  • ErrCodeInvalidResponseCode "InvalidResponseCode"

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInvalidRequiredProtocol "InvalidRequiredProtocol" This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.

  • ErrCodeNoSuchOrigin "NoSuchOrigin" No origin exists with the specified Origin Id.

  • ErrCodeTooManyOrigins "TooManyOrigins" You cannot create more origins for the distribution.

  • ErrCodeTooManyCacheBehaviors "TooManyCacheBehaviors" You cannot create more cache behaviors for the distribution.

  • ErrCodeTooManyCookieNamesInWhiteList "TooManyCookieNamesInWhiteList" Your request contains more cookie names in the whitelist than are allowed per cache behavior.

  • ErrCodeInvalidForwardCookies "InvalidForwardCookies" Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.

  • ErrCodeTooManyHeadersInForwardedValues "TooManyHeadersInForwardedValues"

  • ErrCodeInvalidHeadersForS3Origin "InvalidHeadersForS3Origin"

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

  • ErrCodeTooManyCertificates "TooManyCertificates" You cannot create anymore custom SSL/TLS certificates.

  • ErrCodeInvalidLocationCode "InvalidLocationCode"

  • ErrCodeInvalidGeoRestrictionParameter "InvalidGeoRestrictionParameter"

  • ErrCodeInvalidProtocolSettings "InvalidProtocolSettings" You cannot specify SSLv3 as the minimum protocol version if you only want to support only clients that support Server Name Indication (SNI).

  • ErrCodeInvalidTTLOrder "InvalidTTLOrder"

  • ErrCodeInvalidWebACLId "InvalidWebACLId"

  • ErrCodeTooManyOriginCustomHeaders "TooManyOriginCustomHeaders"

  • ErrCodeInvalidTagging "InvalidTagging"

  • ErrCodeTooManyQueryStringParameters "TooManyQueryStringParameters"

  • ErrCodeInvalidQueryStringParameters "InvalidQueryStringParameters"

  • ErrCodeTooManyDistributionsWithLambdaAssociations "TooManyDistributionsWithLambdaAssociations" Processing your request would cause the maximum number of distributions with Lambda function associations per owner to be exceeded.

  • ErrCodeTooManyLambdaFunctionAssociations "TooManyLambdaFunctionAssociations" Your request contains more Lambda function associations than are allowed per distribution.

  • ErrCodeInvalidLambdaFunctionAssociation "InvalidLambdaFunctionAssociation" The specified Lambda function association is invalid.

  • ErrCodeInvalidOriginReadTimeout "InvalidOriginReadTimeout"

  • ErrCodeInvalidOriginKeepaliveTimeout "InvalidOriginKeepaliveTimeout"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateDistributionWithTags

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.CreateDistributionWithTagsInput{}

	result, err := svc.CreateDistributionWithTags(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeCNAMEAlreadyExists:
				fmt.Println(cloudfront.ErrCodeCNAMEAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeDistributionAlreadyExists:
				fmt.Println(cloudfront.ErrCodeDistributionAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeInvalidOrigin:
				fmt.Println(cloudfront.ErrCodeInvalidOrigin, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeInvalidOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeTooManyTrustedSigners:
				fmt.Println(cloudfront.ErrCodeTooManyTrustedSigners, aerr.Error())
			case cloudfront.ErrCodeTrustedSignerDoesNotExist:
				fmt.Println(cloudfront.ErrCodeTrustedSignerDoesNotExist, aerr.Error())
			case cloudfront.ErrCodeInvalidViewerCertificate:
				fmt.Println(cloudfront.ErrCodeInvalidViewerCertificate, aerr.Error())
			case cloudfront.ErrCodeInvalidMinimumProtocolVersion:
				fmt.Println(cloudfront.ErrCodeInvalidMinimumProtocolVersion, aerr.Error())
			case cloudfront.ErrCodeMissingBody:
				fmt.Println(cloudfront.ErrCodeMissingBody, aerr.Error())
			case cloudfront.ErrCodeTooManyDistributionCNAMEs:
				fmt.Println(cloudfront.ErrCodeTooManyDistributionCNAMEs, aerr.Error())
			case cloudfront.ErrCodeTooManyDistributions:
				fmt.Println(cloudfront.ErrCodeTooManyDistributions, aerr.Error())
			case cloudfront.ErrCodeInvalidDefaultRootObject:
				fmt.Println(cloudfront.ErrCodeInvalidDefaultRootObject, aerr.Error())
			case cloudfront.ErrCodeInvalidRelativePath:
				fmt.Println(cloudfront.ErrCodeInvalidRelativePath, aerr.Error())
			case cloudfront.ErrCodeInvalidErrorCode:
				fmt.Println(cloudfront.ErrCodeInvalidErrorCode, aerr.Error())
			case cloudfront.ErrCodeInvalidResponseCode:
				fmt.Println(cloudfront.ErrCodeInvalidResponseCode, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInvalidRequiredProtocol:
				fmt.Println(cloudfront.ErrCodeInvalidRequiredProtocol, aerr.Error())
			case cloudfront.ErrCodeNoSuchOrigin:
				fmt.Println(cloudfront.ErrCodeNoSuchOrigin, aerr.Error())
			case cloudfront.ErrCodeTooManyOrigins:
				fmt.Println(cloudfront.ErrCodeTooManyOrigins, aerr.Error())
			case cloudfront.ErrCodeTooManyCacheBehaviors:
				fmt.Println(cloudfront.ErrCodeTooManyCacheBehaviors, aerr.Error())
			case cloudfront.ErrCodeTooManyCookieNamesInWhiteList:
				fmt.Println(cloudfront.ErrCodeTooManyCookieNamesInWhiteList, aerr.Error())
			case cloudfront.ErrCodeInvalidForwardCookies:
				fmt.Println(cloudfront.ErrCodeInvalidForwardCookies, aerr.Error())
			case cloudfront.ErrCodeTooManyHeadersInForwardedValues:
				fmt.Println(cloudfront.ErrCodeTooManyHeadersInForwardedValues, aerr.Error())
			case cloudfront.ErrCodeInvalidHeadersForS3Origin:
				fmt.Println(cloudfront.ErrCodeInvalidHeadersForS3Origin, aerr.Error())
			case cloudfront.ErrCodeInconsistentQuantities:
				fmt.Println(cloudfront.ErrCodeInconsistentQuantities, aerr.Error())
			case cloudfront.ErrCodeTooManyCertificates:
				fmt.Println(cloudfront.ErrCodeTooManyCertificates, aerr.Error())
			case cloudfront.ErrCodeInvalidLocationCode:
				fmt.Println(cloudfront.ErrCodeInvalidLocationCode, aerr.Error())
			case cloudfront.ErrCodeInvalidGeoRestrictionParameter:
				fmt.Println(cloudfront.ErrCodeInvalidGeoRestrictionParameter, aerr.Error())
			case cloudfront.ErrCodeInvalidProtocolSettings:
				fmt.Println(cloudfront.ErrCodeInvalidProtocolSettings, aerr.Error())
			case cloudfront.ErrCodeInvalidTTLOrder:
				fmt.Println(cloudfront.ErrCodeInvalidTTLOrder, aerr.Error())
			case cloudfront.ErrCodeInvalidWebACLId:
				fmt.Println(cloudfront.ErrCodeInvalidWebACLId, aerr.Error())
			case cloudfront.ErrCodeTooManyOriginCustomHeaders:
				fmt.Println(cloudfront.ErrCodeTooManyOriginCustomHeaders, aerr.Error())
			case cloudfront.ErrCodeInvalidTagging:
				fmt.Println(cloudfront.ErrCodeInvalidTagging, aerr.Error())
			case cloudfront.ErrCodeTooManyQueryStringParameters:
				fmt.Println(cloudfront.ErrCodeTooManyQueryStringParameters, aerr.Error())
			case cloudfront.ErrCodeInvalidQueryStringParameters:
				fmt.Println(cloudfront.ErrCodeInvalidQueryStringParameters, aerr.Error())
			case cloudfront.ErrCodeTooManyDistributionsWithLambdaAssociations:
				fmt.Println(cloudfront.ErrCodeTooManyDistributionsWithLambdaAssociations, aerr.Error())
			case cloudfront.ErrCodeTooManyLambdaFunctionAssociations:
				fmt.Println(cloudfront.ErrCodeTooManyLambdaFunctionAssociations, aerr.Error())
			case cloudfront.ErrCodeInvalidLambdaFunctionAssociation:
				fmt.Println(cloudfront.ErrCodeInvalidLambdaFunctionAssociation, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginReadTimeout:
				fmt.Println(cloudfront.ErrCodeInvalidOriginReadTimeout, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginKeepaliveTimeout:
				fmt.Println(cloudfront.ErrCodeInvalidOriginKeepaliveTimeout, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) CreateDistributionWithTagsRequest added in v1.4.0

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateDistributionWithTags for more information on using the CreateDistributionWithTags API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateDistributionWithTags

func (*CloudFront) CreateDistributionWithTagsWithContext added in v1.8.0

func (c *CloudFront) CreateDistributionWithTagsWithContext(ctx aws.Context, input *CreateDistributionWithTagsInput, opts ...request.Option) (*CreateDistributionWithTagsOutput, error)

CreateDistributionWithTagsWithContext is the same as CreateDistributionWithTags with the addition of the ability to pass a context and additional request options.

See CreateDistributionWithTags for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) CreateInvalidation

func (c *CloudFront) CreateInvalidation(input *CreateInvalidationInput) (*CreateInvalidationOutput, error)

CreateInvalidation API operation for Amazon CloudFront.

Create a new 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 CreateInvalidation for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeNoSuchDistribution "NoSuchDistribution" The specified distribution does not exist.

  • ErrCodeBatchTooLarge "BatchTooLarge"

  • ErrCodeTooManyInvalidationsInProgress "TooManyInvalidationsInProgress" You have exceeded the maximum number of allowable InProgress invalidation batch requests, or invalidation objects.

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateInvalidation

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.CreateInvalidationInput{}

	result, err := svc.CreateInvalidation(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeMissingBody:
				fmt.Println(cloudfront.ErrCodeMissingBody, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeNoSuchDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchDistribution, aerr.Error())
			case cloudfront.ErrCodeBatchTooLarge:
				fmt.Println(cloudfront.ErrCodeBatchTooLarge, aerr.Error())
			case cloudfront.ErrCodeTooManyInvalidationsInProgress:
				fmt.Println(cloudfront.ErrCodeTooManyInvalidationsInProgress, aerr.Error())
			case cloudfront.ErrCodeInconsistentQuantities:
				fmt.Println(cloudfront.ErrCodeInconsistentQuantities, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateInvalidation for more information on using the CreateInvalidation API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateInvalidation

func (*CloudFront) CreateInvalidationWithContext added in v1.8.0

func (c *CloudFront) CreateInvalidationWithContext(ctx aws.Context, input *CreateInvalidationInput, opts ...request.Option) (*CreateInvalidationOutput, error)

CreateInvalidationWithContext is the same as CreateInvalidation with the addition of the ability to pass a context and additional request options.

See CreateInvalidation for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) CreateStreamingDistribution

func (c *CloudFront) CreateStreamingDistribution(input *CreateStreamingDistributionInput) (*CreateStreamingDistributionOutput, error)

CreateStreamingDistribution API operation for Amazon CloudFront.

Creates a new RMTP distribution. An RTMP distribution is similar to a web distribution, but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol (RTMP) instead of serving files using HTTP.

To create a new web distribution, submit a POST request to the CloudFront API version/distribution resource. The request body must include a document with a StreamingDistributionConfig element. The response echoes the StreamingDistributionConfig element and returns other information about the RTMP distribution.

To get the status of your request, use the GET StreamingDistribution API action. When the value of Enabled is true and the value of Status is Deployed, your distribution is ready. A distribution usually deploys in less than 15 minutes.

For more information about web distributions, see Working with RTMP Distributions (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-rtmp.html) in the Amazon CloudFront Developer Guide.

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a web distribution or an RTMP distribution, and when you invalidate objects. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values specified.

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 CreateStreamingDistribution for usage and error information.

Returned Error Codes:

  • ErrCodeCNAMEAlreadyExists "CNAMEAlreadyExists"

  • ErrCodeStreamingDistributionAlreadyExists "StreamingDistributionAlreadyExists"

  • ErrCodeInvalidOrigin "InvalidOrigin" The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

  • ErrCodeInvalidOriginAccessIdentity "InvalidOriginAccessIdentity" The origin access identity is not valid or doesn't exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeTooManyTrustedSigners "TooManyTrustedSigners" Your request contains more trusted signers than are allowed per distribution.

  • ErrCodeTrustedSignerDoesNotExist "TrustedSignerDoesNotExist" One or more of your trusted signers don't exist.

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeTooManyStreamingDistributionCNAMEs "TooManyStreamingDistributionCNAMEs"

  • ErrCodeTooManyStreamingDistributions "TooManyStreamingDistributions" Processing your request would cause you to exceed the maximum number of streaming distributions allowed.

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateStreamingDistribution

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.CreateStreamingDistributionInput{}

	result, err := svc.CreateStreamingDistribution(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeCNAMEAlreadyExists:
				fmt.Println(cloudfront.ErrCodeCNAMEAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeStreamingDistributionAlreadyExists:
				fmt.Println(cloudfront.ErrCodeStreamingDistributionAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeInvalidOrigin:
				fmt.Println(cloudfront.ErrCodeInvalidOrigin, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeInvalidOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeTooManyTrustedSigners:
				fmt.Println(cloudfront.ErrCodeTooManyTrustedSigners, aerr.Error())
			case cloudfront.ErrCodeTrustedSignerDoesNotExist:
				fmt.Println(cloudfront.ErrCodeTrustedSignerDoesNotExist, aerr.Error())
			case cloudfront.ErrCodeMissingBody:
				fmt.Println(cloudfront.ErrCodeMissingBody, aerr.Error())
			case cloudfront.ErrCodeTooManyStreamingDistributionCNAMEs:
				fmt.Println(cloudfront.ErrCodeTooManyStreamingDistributionCNAMEs, aerr.Error())
			case cloudfront.ErrCodeTooManyStreamingDistributions:
				fmt.Println(cloudfront.ErrCodeTooManyStreamingDistributions, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInconsistentQuantities:
				fmt.Println(cloudfront.ErrCodeInconsistentQuantities, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateStreamingDistribution for more information on using the CreateStreamingDistribution API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateStreamingDistribution

func (*CloudFront) CreateStreamingDistributionWithContext added in v1.8.0

func (c *CloudFront) CreateStreamingDistributionWithContext(ctx aws.Context, input *CreateStreamingDistributionInput, opts ...request.Option) (*CreateStreamingDistributionOutput, error)

CreateStreamingDistributionWithContext is the same as CreateStreamingDistribution with the addition of the ability to pass a context and additional request options.

See CreateStreamingDistribution for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) CreateStreamingDistributionWithTags added in v1.4.0

CreateStreamingDistributionWithTags API operation for Amazon CloudFront.

Create a new streaming distribution with tags.

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 CreateStreamingDistributionWithTags for usage and error information.

Returned Error Codes:

  • ErrCodeCNAMEAlreadyExists "CNAMEAlreadyExists"

  • ErrCodeStreamingDistributionAlreadyExists "StreamingDistributionAlreadyExists"

  • ErrCodeInvalidOrigin "InvalidOrigin" The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

  • ErrCodeInvalidOriginAccessIdentity "InvalidOriginAccessIdentity" The origin access identity is not valid or doesn't exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeTooManyTrustedSigners "TooManyTrustedSigners" Your request contains more trusted signers than are allowed per distribution.

  • ErrCodeTrustedSignerDoesNotExist "TrustedSignerDoesNotExist" One or more of your trusted signers don't exist.

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeTooManyStreamingDistributionCNAMEs "TooManyStreamingDistributionCNAMEs"

  • ErrCodeTooManyStreamingDistributions "TooManyStreamingDistributions" Processing your request would cause you to exceed the maximum number of streaming distributions allowed.

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

  • ErrCodeInvalidTagging "InvalidTagging"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateStreamingDistributionWithTags

func (*CloudFront) CreateStreamingDistributionWithTagsRequest added in v1.4.0

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateStreamingDistributionWithTags for more information on using the CreateStreamingDistributionWithTags API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/CreateStreamingDistributionWithTags

func (*CloudFront) CreateStreamingDistributionWithTagsWithContext added in v1.8.0

func (c *CloudFront) CreateStreamingDistributionWithTagsWithContext(ctx aws.Context, input *CreateStreamingDistributionWithTagsInput, opts ...request.Option) (*CreateStreamingDistributionWithTagsOutput, error)

CreateStreamingDistributionWithTagsWithContext is the same as CreateStreamingDistributionWithTags with the addition of the ability to pass a context and additional request options.

See CreateStreamingDistributionWithTags for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) DeleteCloudFrontOriginAccessIdentity

DeleteCloudFrontOriginAccessIdentity API operation for Amazon CloudFront.

Delete 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 DeleteCloudFrontOriginAccessIdentity for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeInvalidIfMatchVersion "InvalidIfMatchVersion" The If-Match version is missing or not valid for the distribution.

  • ErrCodeNoSuchCloudFrontOriginAccessIdentity "NoSuchCloudFrontOriginAccessIdentity" The specified origin access identity does not exist.

  • ErrCodePreconditionFailed "PreconditionFailed" The precondition given in one or more of the request-header fields evaluated to false.

  • ErrCodeOriginAccessIdentityInUse "OriginAccessIdentityInUse"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/DeleteCloudFrontOriginAccessIdentity

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.DeleteCloudFrontOriginAccessIdentityInput{}

	result, err := svc.DeleteCloudFrontOriginAccessIdentity(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeInvalidIfMatchVersion:
				fmt.Println(cloudfront.ErrCodeInvalidIfMatchVersion, aerr.Error())
			case cloudfront.ErrCodeNoSuchCloudFrontOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeNoSuchCloudFrontOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodePreconditionFailed:
				fmt.Println(cloudfront.ErrCodePreconditionFailed, aerr.Error())
			case cloudfront.ErrCodeOriginAccessIdentityInUse:
				fmt.Println(cloudfront.ErrCodeOriginAccessIdentityInUse, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteCloudFrontOriginAccessIdentity for more information on using the DeleteCloudFrontOriginAccessIdentity API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/DeleteCloudFrontOriginAccessIdentity

func (*CloudFront) DeleteCloudFrontOriginAccessIdentityWithContext added in v1.8.0

func (c *CloudFront) DeleteCloudFrontOriginAccessIdentityWithContext(ctx aws.Context, input *DeleteCloudFrontOriginAccessIdentityInput, opts ...request.Option) (*DeleteCloudFrontOriginAccessIdentityOutput, error)

DeleteCloudFrontOriginAccessIdentityWithContext is the same as DeleteCloudFrontOriginAccessIdentity with the addition of the ability to pass a context and additional request options.

See DeleteCloudFrontOriginAccessIdentity for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) DeleteDistribution

func (c *CloudFront) DeleteDistribution(input *DeleteDistributionInput) (*DeleteDistributionOutput, error)

DeleteDistribution API operation for Amazon CloudFront.

Delete 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 DeleteDistribution for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeDistributionNotDisabled "DistributionNotDisabled"

  • ErrCodeInvalidIfMatchVersion "InvalidIfMatchVersion" The If-Match version is missing or not valid for the distribution.

  • ErrCodeNoSuchDistribution "NoSuchDistribution" The specified distribution does not exist.

  • ErrCodePreconditionFailed "PreconditionFailed" The precondition given in one or more of the request-header fields evaluated to false.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/DeleteDistribution

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.DeleteDistributionInput{}

	result, err := svc.DeleteDistribution(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeDistributionNotDisabled:
				fmt.Println(cloudfront.ErrCodeDistributionNotDisabled, aerr.Error())
			case cloudfront.ErrCodeInvalidIfMatchVersion:
				fmt.Println(cloudfront.ErrCodeInvalidIfMatchVersion, aerr.Error())
			case cloudfront.ErrCodeNoSuchDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchDistribution, aerr.Error())
			case cloudfront.ErrCodePreconditionFailed:
				fmt.Println(cloudfront.ErrCodePreconditionFailed, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteDistribution for more information on using the DeleteDistribution API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/DeleteDistribution

func (*CloudFront) DeleteDistributionWithContext added in v1.8.0

func (c *CloudFront) DeleteDistributionWithContext(ctx aws.Context, input *DeleteDistributionInput, opts ...request.Option) (*DeleteDistributionOutput, error)

DeleteDistributionWithContext is the same as DeleteDistribution with the addition of the ability to pass a context and additional request options.

See DeleteDistribution for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) DeleteServiceLinkedRole added in v1.12.18

func (c *CloudFront) DeleteServiceLinkedRole(input *DeleteServiceLinkedRoleInput) (*DeleteServiceLinkedRoleOutput, error)

DeleteServiceLinkedRole API operation for Amazon CloudFront.

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 DeleteServiceLinkedRole for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeResourceInUse "ResourceInUse"

  • ErrCodeNoSuchResource "NoSuchResource"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/DeleteServiceLinkedRole

func (*CloudFront) DeleteServiceLinkedRoleRequest added in v1.12.18

func (c *CloudFront) DeleteServiceLinkedRoleRequest(input *DeleteServiceLinkedRoleInput) (req *request.Request, output *DeleteServiceLinkedRoleOutput)

DeleteServiceLinkedRoleRequest generates a "aws/request.Request" representing the client's request for the DeleteServiceLinkedRole operation. The "output" return value will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteServiceLinkedRole for more information on using the DeleteServiceLinkedRole API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteServiceLinkedRoleRequest method.
req, resp := client.DeleteServiceLinkedRoleRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/DeleteServiceLinkedRole

func (*CloudFront) DeleteServiceLinkedRoleWithContext added in v1.12.18

func (c *CloudFront) DeleteServiceLinkedRoleWithContext(ctx aws.Context, input *DeleteServiceLinkedRoleInput, opts ...request.Option) (*DeleteServiceLinkedRoleOutput, error)

DeleteServiceLinkedRoleWithContext is the same as DeleteServiceLinkedRole with the addition of the ability to pass a context and additional request options.

See DeleteServiceLinkedRole for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) DeleteStreamingDistribution

func (c *CloudFront) DeleteStreamingDistribution(input *DeleteStreamingDistributionInput) (*DeleteStreamingDistributionOutput, error)

DeleteStreamingDistribution API operation for Amazon CloudFront.

Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, perform the following steps.

To delete an RTMP distribution using the CloudFront API:

Disable the RTMP distribution.

Submit a GET Streaming 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 Streaming Distribution Config request to change the value of Enabled to false.

Submit a PUT Streaming Distribution Config request to update the configuration for your distribution. In the request body, include the XML document that you updated in Step 3. Then set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GET Streaming Distribution Config request in Step 2.

Review the response to the PUT Streaming Distribution Config request to confirm that the distribution was successfully disabled.

Submit a GET Streaming Distribution Config request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

Submit a DELETE Streaming 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 Streaming Distribution Config request in Step 2.

Review the response to your DELETE Streaming 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.

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 DeleteStreamingDistribution for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeStreamingDistributionNotDisabled "StreamingDistributionNotDisabled"

  • ErrCodeInvalidIfMatchVersion "InvalidIfMatchVersion" The If-Match version is missing or not valid for the distribution.

  • ErrCodeNoSuchStreamingDistribution "NoSuchStreamingDistribution" The specified streaming distribution does not exist.

  • ErrCodePreconditionFailed "PreconditionFailed" The precondition given in one or more of the request-header fields evaluated to false.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/DeleteStreamingDistribution

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.DeleteStreamingDistributionInput{}

	result, err := svc.DeleteStreamingDistribution(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeStreamingDistributionNotDisabled:
				fmt.Println(cloudfront.ErrCodeStreamingDistributionNotDisabled, aerr.Error())
			case cloudfront.ErrCodeInvalidIfMatchVersion:
				fmt.Println(cloudfront.ErrCodeInvalidIfMatchVersion, aerr.Error())
			case cloudfront.ErrCodeNoSuchStreamingDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchStreamingDistribution, aerr.Error())
			case cloudfront.ErrCodePreconditionFailed:
				fmt.Println(cloudfront.ErrCodePreconditionFailed, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteStreamingDistribution for more information on using the DeleteStreamingDistribution API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/DeleteStreamingDistribution

func (*CloudFront) DeleteStreamingDistributionWithContext added in v1.8.0

func (c *CloudFront) DeleteStreamingDistributionWithContext(ctx aws.Context, input *DeleteStreamingDistributionInput, opts ...request.Option) (*DeleteStreamingDistributionOutput, error)

DeleteStreamingDistributionWithContext is the same as DeleteStreamingDistribution with the addition of the ability to pass a context and additional request options.

See DeleteStreamingDistribution for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) GetCloudFrontOriginAccessIdentity

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:

  • ErrCodeNoSuchCloudFrontOriginAccessIdentity "NoSuchCloudFrontOriginAccessIdentity" The specified origin access identity does not exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetCloudFrontOriginAccessIdentity

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.GetCloudFrontOriginAccessIdentityInput{}

	result, err := svc.GetCloudFrontOriginAccessIdentity(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeNoSuchCloudFrontOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeNoSuchCloudFrontOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) GetCloudFrontOriginAccessIdentityConfig

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:

  • ErrCodeNoSuchCloudFrontOriginAccessIdentity "NoSuchCloudFrontOriginAccessIdentity" The specified origin access identity does not exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetCloudFrontOriginAccessIdentityConfig

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.GetCloudFrontOriginAccessIdentityConfigInput{}

	result, err := svc.GetCloudFrontOriginAccessIdentityConfig(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeNoSuchCloudFrontOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeNoSuchCloudFrontOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetCloudFrontOriginAccessIdentityConfig for more information on using the GetCloudFrontOriginAccessIdentityConfig API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetCloudFrontOriginAccessIdentityConfig

func (*CloudFront) GetCloudFrontOriginAccessIdentityConfigWithContext added in v1.8.0

func (c *CloudFront) GetCloudFrontOriginAccessIdentityConfigWithContext(ctx aws.Context, input *GetCloudFrontOriginAccessIdentityConfigInput, opts ...request.Option) (*GetCloudFrontOriginAccessIdentityConfigOutput, error)

GetCloudFrontOriginAccessIdentityConfigWithContext is the same as GetCloudFrontOriginAccessIdentityConfig with the addition of the ability to pass a context and additional request options.

See GetCloudFrontOriginAccessIdentityConfig for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetCloudFrontOriginAccessIdentity for more information on using the GetCloudFrontOriginAccessIdentity API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetCloudFrontOriginAccessIdentity

func (*CloudFront) GetCloudFrontOriginAccessIdentityWithContext added in v1.8.0

func (c *CloudFront) GetCloudFrontOriginAccessIdentityWithContext(ctx aws.Context, input *GetCloudFrontOriginAccessIdentityInput, opts ...request.Option) (*GetCloudFrontOriginAccessIdentityOutput, error)

GetCloudFrontOriginAccessIdentityWithContext is the same as GetCloudFrontOriginAccessIdentity with the addition of the ability to pass a context and additional request options.

See GetCloudFrontOriginAccessIdentity for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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:

  • ErrCodeNoSuchDistribution "NoSuchDistribution" The specified distribution does not exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetDistribution

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.GetDistributionInput{}

	result, err := svc.GetDistribution(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeNoSuchDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchDistribution, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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:

  • ErrCodeNoSuchDistribution "NoSuchDistribution" The specified distribution does not exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetDistributionConfig

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.GetDistributionConfigInput{}

	result, err := svc.GetDistributionConfig(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeNoSuchDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchDistribution, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetDistributionConfig for more information on using the GetDistributionConfig API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetDistributionConfig

func (*CloudFront) GetDistributionConfigWithContext added in v1.8.0

func (c *CloudFront) GetDistributionConfigWithContext(ctx aws.Context, input *GetDistributionConfigInput, opts ...request.Option) (*GetDistributionConfigOutput, error)

GetDistributionConfigWithContext is the same as GetDistributionConfig with the addition of the ability to pass a context and additional request options.

See GetDistributionConfig for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetDistribution for more information on using the GetDistribution API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetDistribution

func (*CloudFront) GetDistributionWithContext added in v1.8.0

func (c *CloudFront) GetDistributionWithContext(ctx aws.Context, input *GetDistributionInput, opts ...request.Option) (*GetDistributionOutput, error)

GetDistributionWithContext is the same as GetDistribution with the addition of the ability to pass a context and additional request options.

See GetDistribution for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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:

  • ErrCodeNoSuchInvalidation "NoSuchInvalidation" The specified invalidation does not exist.

  • ErrCodeNoSuchDistribution "NoSuchDistribution" The specified distribution does not exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetInvalidation

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.GetInvalidationInput{}

	result, err := svc.GetInvalidation(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeNoSuchInvalidation:
				fmt.Println(cloudfront.ErrCodeNoSuchInvalidation, aerr.Error())
			case cloudfront.ErrCodeNoSuchDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchDistribution, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetInvalidation for more information on using the GetInvalidation API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetInvalidation

func (*CloudFront) GetInvalidationWithContext added in v1.8.0

func (c *CloudFront) GetInvalidationWithContext(ctx aws.Context, input *GetInvalidationInput, opts ...request.Option) (*GetInvalidationOutput, error)

GetInvalidationWithContext is the same as GetInvalidation with the addition of the ability to pass a context and additional request options.

See GetInvalidation for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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:

  • ErrCodeNoSuchStreamingDistribution "NoSuchStreamingDistribution" The specified streaming distribution does not exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetStreamingDistribution

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.GetStreamingDistributionInput{}

	result, err := svc.GetStreamingDistribution(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeNoSuchStreamingDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchStreamingDistribution, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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:

  • ErrCodeNoSuchStreamingDistribution "NoSuchStreamingDistribution" The specified streaming distribution does not exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetStreamingDistributionConfig

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.GetStreamingDistributionConfigInput{}

	result, err := svc.GetStreamingDistributionConfig(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeNoSuchStreamingDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchStreamingDistribution, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetStreamingDistributionConfig for more information on using the GetStreamingDistributionConfig API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetStreamingDistributionConfig

func (*CloudFront) GetStreamingDistributionConfigWithContext added in v1.8.0

func (c *CloudFront) GetStreamingDistributionConfigWithContext(ctx aws.Context, input *GetStreamingDistributionConfigInput, opts ...request.Option) (*GetStreamingDistributionConfigOutput, error)

GetStreamingDistributionConfigWithContext is the same as GetStreamingDistributionConfig with the addition of the ability to pass a context and additional request options.

See GetStreamingDistributionConfig for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetStreamingDistribution for more information on using the GetStreamingDistribution API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/GetStreamingDistribution

func (*CloudFront) GetStreamingDistributionWithContext added in v1.8.0

func (c *CloudFront) GetStreamingDistributionWithContext(ctx aws.Context, input *GetStreamingDistributionInput, opts ...request.Option) (*GetStreamingDistributionOutput, error)

GetStreamingDistributionWithContext is the same as GetStreamingDistribution with the addition of the ability to pass a context and additional request options.

See GetStreamingDistribution for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) ListCloudFrontOriginAccessIdentities

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:

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListCloudFrontOriginAccessIdentities

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.ListCloudFrontOriginAccessIdentitiesInput{}

	result, err := svc.ListCloudFrontOriginAccessIdentities(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) ListCloudFrontOriginAccessIdentitiesPages

func (c *CloudFront) ListCloudFrontOriginAccessIdentitiesPages(input *ListCloudFrontOriginAccessIdentitiesInput, fn func(*ListCloudFrontOriginAccessIdentitiesOutput, bool) 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) ListCloudFrontOriginAccessIdentitiesPagesWithContext added in v1.8.0

func (c *CloudFront) ListCloudFrontOriginAccessIdentitiesPagesWithContext(ctx aws.Context, input *ListCloudFrontOriginAccessIdentitiesInput, fn func(*ListCloudFrontOriginAccessIdentitiesOutput, bool) bool, opts ...request.Option) error

ListCloudFrontOriginAccessIdentitiesPagesWithContext same as ListCloudFrontOriginAccessIdentitiesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListCloudFrontOriginAccessIdentities for more information on using the ListCloudFrontOriginAccessIdentities API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListCloudFrontOriginAccessIdentities

func (*CloudFront) ListCloudFrontOriginAccessIdentitiesWithContext added in v1.8.0

func (c *CloudFront) ListCloudFrontOriginAccessIdentitiesWithContext(ctx aws.Context, input *ListCloudFrontOriginAccessIdentitiesInput, opts ...request.Option) (*ListCloudFrontOriginAccessIdentitiesOutput, error)

ListCloudFrontOriginAccessIdentitiesWithContext is the same as ListCloudFrontOriginAccessIdentities with the addition of the ability to pass a context and additional request options.

See ListCloudFrontOriginAccessIdentities for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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:

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListDistributions

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.ListDistributionsInput{}

	result, err := svc.ListDistributions(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) ListDistributionsByWebACLId added in v0.9.12

func (c *CloudFront) ListDistributionsByWebACLId(input *ListDistributionsByWebACLIdInput) (*ListDistributionsByWebACLIdOutput, error)

ListDistributionsByWebACLId API operation for Amazon CloudFront.

List the distributions that are associated with a specified AWS WAF web ACL.

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 ListDistributionsByWebACLId for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInvalidWebACLId "InvalidWebACLId"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListDistributionsByWebACLId

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.ListDistributionsByWebACLIdInput{}

	result, err := svc.ListDistributionsByWebACLId(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInvalidWebACLId:
				fmt.Println(cloudfront.ErrCodeInvalidWebACLId, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) ListDistributionsByWebACLIdRequest added in v0.9.12

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListDistributionsByWebACLId for more information on using the ListDistributionsByWebACLId API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListDistributionsByWebACLId

func (*CloudFront) ListDistributionsByWebACLIdWithContext added in v1.8.0

func (c *CloudFront) ListDistributionsByWebACLIdWithContext(ctx aws.Context, input *ListDistributionsByWebACLIdInput, opts ...request.Option) (*ListDistributionsByWebACLIdOutput, error)

ListDistributionsByWebACLIdWithContext is the same as ListDistributionsByWebACLId with the addition of the ability to pass a context and additional request options.

See ListDistributionsByWebACLId for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) ListDistributionsPages

func (c *CloudFront) ListDistributionsPages(input *ListDistributionsInput, fn func(*ListDistributionsOutput, bool) 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) ListDistributionsPagesWithContext added in v1.8.0

func (c *CloudFront) ListDistributionsPagesWithContext(ctx aws.Context, input *ListDistributionsInput, fn func(*ListDistributionsOutput, bool) bool, opts ...request.Option) error

ListDistributionsPagesWithContext same as ListDistributionsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListDistributions for more information on using the ListDistributions API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListDistributions

func (*CloudFront) ListDistributionsWithContext added in v1.8.0

func (c *CloudFront) ListDistributionsWithContext(ctx aws.Context, input *ListDistributionsInput, opts ...request.Option) (*ListDistributionsOutput, error)

ListDistributionsWithContext is the same as ListDistributions with the addition of the ability to pass a context and additional request options.

See ListDistributions for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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:

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeNoSuchDistribution "NoSuchDistribution" The specified distribution does not exist.

  • ErrCodeAccessDenied "AccessDenied" Access denied.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListInvalidations

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.ListInvalidationsInput{}

	result, err := svc.ListInvalidations(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeNoSuchDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchDistribution, aerr.Error())
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) ListInvalidationsPages

func (c *CloudFront) ListInvalidationsPages(input *ListInvalidationsInput, fn func(*ListInvalidationsOutput, bool) 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) ListInvalidationsPagesWithContext added in v1.8.0

func (c *CloudFront) ListInvalidationsPagesWithContext(ctx aws.Context, input *ListInvalidationsInput, fn func(*ListInvalidationsOutput, bool) bool, opts ...request.Option) error

ListInvalidationsPagesWithContext same as ListInvalidationsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListInvalidations for more information on using the ListInvalidations API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListInvalidations

func (*CloudFront) ListInvalidationsWithContext added in v1.8.0

func (c *CloudFront) ListInvalidationsWithContext(ctx aws.Context, input *ListInvalidationsInput, opts ...request.Option) (*ListInvalidationsOutput, error)

ListInvalidationsWithContext is the same as ListInvalidations with the addition of the ability to pass a context and additional request options.

See ListInvalidations for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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:

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListStreamingDistributions

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.ListStreamingDistributionsInput{}

	result, err := svc.ListStreamingDistributions(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) ListStreamingDistributionsPages

func (c *CloudFront) ListStreamingDistributionsPages(input *ListStreamingDistributionsInput, fn func(*ListStreamingDistributionsOutput, bool) 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) ListStreamingDistributionsPagesWithContext added in v1.8.0

func (c *CloudFront) ListStreamingDistributionsPagesWithContext(ctx aws.Context, input *ListStreamingDistributionsInput, fn func(*ListStreamingDistributionsOutput, bool) bool, opts ...request.Option) error

ListStreamingDistributionsPagesWithContext same as ListStreamingDistributionsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListStreamingDistributions for more information on using the ListStreamingDistributions API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListStreamingDistributions

func (*CloudFront) ListStreamingDistributionsWithContext added in v1.8.0

func (c *CloudFront) ListStreamingDistributionsWithContext(ctx aws.Context, input *ListStreamingDistributionsInput, opts ...request.Option) (*ListStreamingDistributionsOutput, error)

ListStreamingDistributionsWithContext is the same as ListStreamingDistributions with the addition of the ability to pass a context and additional request options.

See ListStreamingDistributions for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) ListTagsForResource added in v1.4.0

func (c *CloudFront) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error)

ListTagsForResource API operation for Amazon CloudFront.

List tags for a CloudFront resource.

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 ListTagsForResource for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInvalidTagging "InvalidTagging"

  • ErrCodeNoSuchResource "NoSuchResource"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListTagsForResource

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.ListTagsForResourceInput{}

	result, err := svc.ListTagsForResource(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInvalidTagging:
				fmt.Println(cloudfront.ErrCodeInvalidTagging, aerr.Error())
			case cloudfront.ErrCodeNoSuchResource:
				fmt.Println(cloudfront.ErrCodeNoSuchResource, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) ListTagsForResourceRequest added in v1.4.0

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTagsForResource for more information on using the ListTagsForResource API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/ListTagsForResource

func (*CloudFront) ListTagsForResourceWithContext added in v1.8.0

func (c *CloudFront) ListTagsForResourceWithContext(ctx aws.Context, input *ListTagsForResourceInput, opts ...request.Option) (*ListTagsForResourceOutput, error)

ListTagsForResourceWithContext is the same as ListTagsForResource with the addition of the ability to pass a context and additional request options.

See ListTagsForResource for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) TagResource added in v1.4.0

func (c *CloudFront) TagResource(input *TagResourceInput) (*TagResourceOutput, error)

TagResource API operation for Amazon CloudFront.

Add tags to a CloudFront resource.

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 TagResource for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInvalidTagging "InvalidTagging"

  • ErrCodeNoSuchResource "NoSuchResource"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/TagResource

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.TagResourceInput{}

	result, err := svc.TagResource(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInvalidTagging:
				fmt.Println(cloudfront.ErrCodeInvalidTagging, aerr.Error())
			case cloudfront.ErrCodeNoSuchResource:
				fmt.Println(cloudfront.ErrCodeNoSuchResource, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) TagResourceRequest added in v1.4.0

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See TagResource for more information on using the TagResource API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/TagResource

func (*CloudFront) TagResourceWithContext added in v1.8.0

func (c *CloudFront) TagResourceWithContext(ctx aws.Context, input *TagResourceInput, opts ...request.Option) (*TagResourceOutput, error)

TagResourceWithContext is the same as TagResource with the addition of the ability to pass a context and additional request options.

See TagResource for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) UntagResource added in v1.4.0

func (c *CloudFront) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error)

UntagResource API operation for Amazon CloudFront.

Remove tags from a CloudFront resource.

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 UntagResource for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInvalidTagging "InvalidTagging"

  • ErrCodeNoSuchResource "NoSuchResource"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/UntagResource

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.UntagResourceInput{}

	result, err := svc.UntagResource(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInvalidTagging:
				fmt.Println(cloudfront.ErrCodeInvalidTagging, aerr.Error())
			case cloudfront.ErrCodeNoSuchResource:
				fmt.Println(cloudfront.ErrCodeNoSuchResource, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*CloudFront) UntagResourceRequest added in v1.4.0

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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UntagResource for more information on using the UntagResource API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/UntagResource

func (*CloudFront) UntagResourceWithContext added in v1.8.0

func (c *CloudFront) UntagResourceWithContext(ctx aws.Context, input *UntagResourceInput, opts ...request.Option) (*UntagResourceOutput, error)

UntagResourceWithContext is the same as UntagResource with the addition of the ability to pass a context and additional request options.

See UntagResource for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) UpdateCloudFrontOriginAccessIdentity

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:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeIllegalUpdate "IllegalUpdate" Origin and CallerReference cannot be updated.

  • ErrCodeInvalidIfMatchVersion "InvalidIfMatchVersion" The If-Match version is missing or not valid for the distribution.

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeNoSuchCloudFrontOriginAccessIdentity "NoSuchCloudFrontOriginAccessIdentity" The specified origin access identity does not exist.

  • ErrCodePreconditionFailed "PreconditionFailed" The precondition given in one or more of the request-header fields evaluated to false.

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/UpdateCloudFrontOriginAccessIdentity

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.UpdateCloudFrontOriginAccessIdentityInput{}

	result, err := svc.UpdateCloudFrontOriginAccessIdentity(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeIllegalUpdate:
				fmt.Println(cloudfront.ErrCodeIllegalUpdate, aerr.Error())
			case cloudfront.ErrCodeInvalidIfMatchVersion:
				fmt.Println(cloudfront.ErrCodeInvalidIfMatchVersion, aerr.Error())
			case cloudfront.ErrCodeMissingBody:
				fmt.Println(cloudfront.ErrCodeMissingBody, aerr.Error())
			case cloudfront.ErrCodeNoSuchCloudFrontOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeNoSuchCloudFrontOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodePreconditionFailed:
				fmt.Println(cloudfront.ErrCodePreconditionFailed, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInconsistentQuantities:
				fmt.Println(cloudfront.ErrCodeInconsistentQuantities, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateCloudFrontOriginAccessIdentity for more information on using the UpdateCloudFrontOriginAccessIdentity API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/UpdateCloudFrontOriginAccessIdentity

func (*CloudFront) UpdateCloudFrontOriginAccessIdentityWithContext added in v1.8.0

func (c *CloudFront) UpdateCloudFrontOriginAccessIdentityWithContext(ctx aws.Context, input *UpdateCloudFrontOriginAccessIdentityInput, opts ...request.Option) (*UpdateCloudFrontOriginAccessIdentityOutput, error)

UpdateCloudFrontOriginAccessIdentityWithContext is the same as UpdateCloudFrontOriginAccessIdentity with the addition of the ability to pass a context and additional request options.

See UpdateCloudFrontOriginAccessIdentity for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) UpdateDistribution

func (c *CloudFront) UpdateDistribution(input *UpdateDistributionInput) (*UpdateDistributionOutput, error)

UpdateDistribution API operation for Amazon CloudFront.

Updates the configuration for a web distribution. Perform the following steps.

For information about updating a distribution using the CloudFront console, see Creating or Updating a Web Distribution Using the CloudFront Console

(http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html)

in the Amazon CloudFront Developer Guide.

To update a web distribution using the CloudFront API

Submit a GetDistributionConfig request to get the current configuration and an Etag header for the distribution.

If you update the distribution again, you need to get a new Etag header.

Update the XML document that was returned in the response to your GetDistributionConfig request to include the desired changes. You can't change the value of CallerReference. If you try to change this value, CloudFront returns an IllegalUpdate error.

The new configuration replaces the existing configuration; the values that you specify in an UpdateDistribution request are not merged into the existing configuration. When you add, delete, or replace values in an element that allows multiple values (for example, CNAME), you must specify all of the values that you want to appear in the updated distribution. In addition, you must update the corresponding Quantity element.

Submit an UpdateDistribution request to update the configuration for your distribution:

In the request body, include the XML document that you updated in Step 2. The request body must include an XML document with a DistributionConfig element.

Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned when you submitted the GetDistributionConfig request in Step 1.

Review the response to the UpdateDistribution request to confirm that the configuration was successfully updated.

Optional: Submit a GetDistribution request to confirm that your changes have propagated. When propagation is complete, the value of Status is Deployed.

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to the format of the XML document that you include in the request body when you create or update a distribution. With previous versions of the API, we discovered that it was too easy to accidentally delete one or more values for an element that accepts multiple values, for example, CNAMEs and trusted signers. Our changes for the 2012-05-05 release are intended to prevent these accidental deletions and to notify you when there's a mismatch between the number of values you say you're specifying in the Quantity element and the number of values you're actually specifying.

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 UpdateDistribution for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeCNAMEAlreadyExists "CNAMEAlreadyExists"

  • ErrCodeIllegalUpdate "IllegalUpdate" Origin and CallerReference cannot be updated.

  • ErrCodeInvalidIfMatchVersion "InvalidIfMatchVersion" The If-Match version is missing or not valid for the distribution.

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeNoSuchDistribution "NoSuchDistribution" The specified distribution does not exist.

  • ErrCodePreconditionFailed "PreconditionFailed" The precondition given in one or more of the request-header fields evaluated to false.

  • ErrCodeTooManyDistributionCNAMEs "TooManyDistributionCNAMEs" Your request contains more CNAMEs than are allowed per distribution.

  • ErrCodeInvalidDefaultRootObject "InvalidDefaultRootObject" The default root object file name is too big or contains an invalid character.

  • ErrCodeInvalidRelativePath "InvalidRelativePath" The relative path is too big, is not URL-encoded, or does not begin with a slash (/).

  • ErrCodeInvalidErrorCode "InvalidErrorCode"

  • ErrCodeInvalidResponseCode "InvalidResponseCode"

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInvalidOriginAccessIdentity "InvalidOriginAccessIdentity" The origin access identity is not valid or doesn't exist.

  • ErrCodeTooManyTrustedSigners "TooManyTrustedSigners" Your request contains more trusted signers than are allowed per distribution.

  • ErrCodeTrustedSignerDoesNotExist "TrustedSignerDoesNotExist" One or more of your trusted signers don't exist.

  • ErrCodeInvalidViewerCertificate "InvalidViewerCertificate"

  • ErrCodeInvalidMinimumProtocolVersion "InvalidMinimumProtocolVersion"

  • ErrCodeInvalidRequiredProtocol "InvalidRequiredProtocol" This operation requires the HTTPS protocol. Ensure that you specify the HTTPS protocol in your request, or omit the RequiredProtocols element from your distribution configuration.

  • ErrCodeNoSuchOrigin "NoSuchOrigin" No origin exists with the specified Origin Id.

  • ErrCodeTooManyOrigins "TooManyOrigins" You cannot create more origins for the distribution.

  • ErrCodeTooManyCacheBehaviors "TooManyCacheBehaviors" You cannot create more cache behaviors for the distribution.

  • ErrCodeTooManyCookieNamesInWhiteList "TooManyCookieNamesInWhiteList" Your request contains more cookie names in the whitelist than are allowed per cache behavior.

  • ErrCodeInvalidForwardCookies "InvalidForwardCookies" Your request contains forward cookies option which doesn't match with the expectation for the whitelisted list of cookie names. Either list of cookie names has been specified when not allowed or list of cookie names is missing when expected.

  • ErrCodeTooManyHeadersInForwardedValues "TooManyHeadersInForwardedValues"

  • ErrCodeInvalidHeadersForS3Origin "InvalidHeadersForS3Origin"

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

  • ErrCodeTooManyCertificates "TooManyCertificates" You cannot create anymore custom SSL/TLS certificates.

  • ErrCodeInvalidLocationCode "InvalidLocationCode"

  • ErrCodeInvalidGeoRestrictionParameter "InvalidGeoRestrictionParameter"

  • ErrCodeInvalidTTLOrder "InvalidTTLOrder"

  • ErrCodeInvalidWebACLId "InvalidWebACLId"

  • ErrCodeTooManyOriginCustomHeaders "TooManyOriginCustomHeaders"

  • ErrCodeTooManyQueryStringParameters "TooManyQueryStringParameters"

  • ErrCodeInvalidQueryStringParameters "InvalidQueryStringParameters"

  • ErrCodeTooManyDistributionsWithLambdaAssociations "TooManyDistributionsWithLambdaAssociations" Processing your request would cause the maximum number of distributions with Lambda function associations per owner to be exceeded.

  • ErrCodeTooManyLambdaFunctionAssociations "TooManyLambdaFunctionAssociations" Your request contains more Lambda function associations than are allowed per distribution.

  • ErrCodeInvalidLambdaFunctionAssociation "InvalidLambdaFunctionAssociation" The specified Lambda function association is invalid.

  • ErrCodeInvalidOriginReadTimeout "InvalidOriginReadTimeout"

  • ErrCodeInvalidOriginKeepaliveTimeout "InvalidOriginKeepaliveTimeout"

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/UpdateDistribution

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.UpdateDistributionInput{}

	result, err := svc.UpdateDistribution(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeCNAMEAlreadyExists:
				fmt.Println(cloudfront.ErrCodeCNAMEAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeIllegalUpdate:
				fmt.Println(cloudfront.ErrCodeIllegalUpdate, aerr.Error())
			case cloudfront.ErrCodeInvalidIfMatchVersion:
				fmt.Println(cloudfront.ErrCodeInvalidIfMatchVersion, aerr.Error())
			case cloudfront.ErrCodeMissingBody:
				fmt.Println(cloudfront.ErrCodeMissingBody, aerr.Error())
			case cloudfront.ErrCodeNoSuchDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchDistribution, aerr.Error())
			case cloudfront.ErrCodePreconditionFailed:
				fmt.Println(cloudfront.ErrCodePreconditionFailed, aerr.Error())
			case cloudfront.ErrCodeTooManyDistributionCNAMEs:
				fmt.Println(cloudfront.ErrCodeTooManyDistributionCNAMEs, aerr.Error())
			case cloudfront.ErrCodeInvalidDefaultRootObject:
				fmt.Println(cloudfront.ErrCodeInvalidDefaultRootObject, aerr.Error())
			case cloudfront.ErrCodeInvalidRelativePath:
				fmt.Println(cloudfront.ErrCodeInvalidRelativePath, aerr.Error())
			case cloudfront.ErrCodeInvalidErrorCode:
				fmt.Println(cloudfront.ErrCodeInvalidErrorCode, aerr.Error())
			case cloudfront.ErrCodeInvalidResponseCode:
				fmt.Println(cloudfront.ErrCodeInvalidResponseCode, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeInvalidOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodeTooManyTrustedSigners:
				fmt.Println(cloudfront.ErrCodeTooManyTrustedSigners, aerr.Error())
			case cloudfront.ErrCodeTrustedSignerDoesNotExist:
				fmt.Println(cloudfront.ErrCodeTrustedSignerDoesNotExist, aerr.Error())
			case cloudfront.ErrCodeInvalidViewerCertificate:
				fmt.Println(cloudfront.ErrCodeInvalidViewerCertificate, aerr.Error())
			case cloudfront.ErrCodeInvalidMinimumProtocolVersion:
				fmt.Println(cloudfront.ErrCodeInvalidMinimumProtocolVersion, aerr.Error())
			case cloudfront.ErrCodeInvalidRequiredProtocol:
				fmt.Println(cloudfront.ErrCodeInvalidRequiredProtocol, aerr.Error())
			case cloudfront.ErrCodeNoSuchOrigin:
				fmt.Println(cloudfront.ErrCodeNoSuchOrigin, aerr.Error())
			case cloudfront.ErrCodeTooManyOrigins:
				fmt.Println(cloudfront.ErrCodeTooManyOrigins, aerr.Error())
			case cloudfront.ErrCodeTooManyCacheBehaviors:
				fmt.Println(cloudfront.ErrCodeTooManyCacheBehaviors, aerr.Error())
			case cloudfront.ErrCodeTooManyCookieNamesInWhiteList:
				fmt.Println(cloudfront.ErrCodeTooManyCookieNamesInWhiteList, aerr.Error())
			case cloudfront.ErrCodeInvalidForwardCookies:
				fmt.Println(cloudfront.ErrCodeInvalidForwardCookies, aerr.Error())
			case cloudfront.ErrCodeTooManyHeadersInForwardedValues:
				fmt.Println(cloudfront.ErrCodeTooManyHeadersInForwardedValues, aerr.Error())
			case cloudfront.ErrCodeInvalidHeadersForS3Origin:
				fmt.Println(cloudfront.ErrCodeInvalidHeadersForS3Origin, aerr.Error())
			case cloudfront.ErrCodeInconsistentQuantities:
				fmt.Println(cloudfront.ErrCodeInconsistentQuantities, aerr.Error())
			case cloudfront.ErrCodeTooManyCertificates:
				fmt.Println(cloudfront.ErrCodeTooManyCertificates, aerr.Error())
			case cloudfront.ErrCodeInvalidLocationCode:
				fmt.Println(cloudfront.ErrCodeInvalidLocationCode, aerr.Error())
			case cloudfront.ErrCodeInvalidGeoRestrictionParameter:
				fmt.Println(cloudfront.ErrCodeInvalidGeoRestrictionParameter, aerr.Error())
			case cloudfront.ErrCodeInvalidTTLOrder:
				fmt.Println(cloudfront.ErrCodeInvalidTTLOrder, aerr.Error())
			case cloudfront.ErrCodeInvalidWebACLId:
				fmt.Println(cloudfront.ErrCodeInvalidWebACLId, aerr.Error())
			case cloudfront.ErrCodeTooManyOriginCustomHeaders:
				fmt.Println(cloudfront.ErrCodeTooManyOriginCustomHeaders, aerr.Error())
			case cloudfront.ErrCodeTooManyQueryStringParameters:
				fmt.Println(cloudfront.ErrCodeTooManyQueryStringParameters, aerr.Error())
			case cloudfront.ErrCodeInvalidQueryStringParameters:
				fmt.Println(cloudfront.ErrCodeInvalidQueryStringParameters, aerr.Error())
			case cloudfront.ErrCodeTooManyDistributionsWithLambdaAssociations:
				fmt.Println(cloudfront.ErrCodeTooManyDistributionsWithLambdaAssociations, aerr.Error())
			case cloudfront.ErrCodeTooManyLambdaFunctionAssociations:
				fmt.Println(cloudfront.ErrCodeTooManyLambdaFunctionAssociations, aerr.Error())
			case cloudfront.ErrCodeInvalidLambdaFunctionAssociation:
				fmt.Println(cloudfront.ErrCodeInvalidLambdaFunctionAssociation, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginReadTimeout:
				fmt.Println(cloudfront.ErrCodeInvalidOriginReadTimeout, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginKeepaliveTimeout:
				fmt.Println(cloudfront.ErrCodeInvalidOriginKeepaliveTimeout, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateDistribution for more information on using the UpdateDistribution API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/UpdateDistribution

func (*CloudFront) UpdateDistributionWithContext added in v1.8.0

func (c *CloudFront) UpdateDistributionWithContext(ctx aws.Context, input *UpdateDistributionInput, opts ...request.Option) (*UpdateDistributionOutput, error)

UpdateDistributionWithContext is the same as UpdateDistribution with the addition of the ability to pass a context and additional request options.

See UpdateDistribution for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) UpdateStreamingDistribution

func (c *CloudFront) UpdateStreamingDistribution(input *UpdateStreamingDistributionInput) (*UpdateStreamingDistributionOutput, error)

UpdateStreamingDistribution API operation for Amazon CloudFront.

Update 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 UpdateStreamingDistribution for usage and error information.

Returned Error Codes:

  • ErrCodeAccessDenied "AccessDenied" Access denied.

  • ErrCodeCNAMEAlreadyExists "CNAMEAlreadyExists"

  • ErrCodeIllegalUpdate "IllegalUpdate" Origin and CallerReference cannot be updated.

  • ErrCodeInvalidIfMatchVersion "InvalidIfMatchVersion" The If-Match version is missing or not valid for the distribution.

  • ErrCodeMissingBody "MissingBody" This operation requires a body. Ensure that the body is present and the Content-Type header is set.

  • ErrCodeNoSuchStreamingDistribution "NoSuchStreamingDistribution" The specified streaming distribution does not exist.

  • ErrCodePreconditionFailed "PreconditionFailed" The precondition given in one or more of the request-header fields evaluated to false.

  • ErrCodeTooManyStreamingDistributionCNAMEs "TooManyStreamingDistributionCNAMEs"

  • ErrCodeInvalidArgument "InvalidArgument" The argument is invalid.

  • ErrCodeInvalidOriginAccessIdentity "InvalidOriginAccessIdentity" The origin access identity is not valid or doesn't exist.

  • ErrCodeTooManyTrustedSigners "TooManyTrustedSigners" Your request contains more trusted signers than are allowed per distribution.

  • ErrCodeTrustedSignerDoesNotExist "TrustedSignerDoesNotExist" One or more of your trusted signers don't exist.

  • ErrCodeInconsistentQuantities "InconsistentQuantities" The value of Quantity and the size of Items don't match.

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/UpdateStreamingDistribution

Example (Shared00)
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/cloudfront"
)

func main() {
	svc := cloudfront.New(session.New())
	input := &cloudfront.UpdateStreamingDistributionInput{}

	result, err := svc.UpdateStreamingDistribution(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case cloudfront.ErrCodeAccessDenied:
				fmt.Println(cloudfront.ErrCodeAccessDenied, aerr.Error())
			case cloudfront.ErrCodeCNAMEAlreadyExists:
				fmt.Println(cloudfront.ErrCodeCNAMEAlreadyExists, aerr.Error())
			case cloudfront.ErrCodeIllegalUpdate:
				fmt.Println(cloudfront.ErrCodeIllegalUpdate, aerr.Error())
			case cloudfront.ErrCodeInvalidIfMatchVersion:
				fmt.Println(cloudfront.ErrCodeInvalidIfMatchVersion, aerr.Error())
			case cloudfront.ErrCodeMissingBody:
				fmt.Println(cloudfront.ErrCodeMissingBody, aerr.Error())
			case cloudfront.ErrCodeNoSuchStreamingDistribution:
				fmt.Println(cloudfront.ErrCodeNoSuchStreamingDistribution, aerr.Error())
			case cloudfront.ErrCodePreconditionFailed:
				fmt.Println(cloudfront.ErrCodePreconditionFailed, aerr.Error())
			case cloudfront.ErrCodeTooManyStreamingDistributionCNAMEs:
				fmt.Println(cloudfront.ErrCodeTooManyStreamingDistributionCNAMEs, aerr.Error())
			case cloudfront.ErrCodeInvalidArgument:
				fmt.Println(cloudfront.ErrCodeInvalidArgument, aerr.Error())
			case cloudfront.ErrCodeInvalidOriginAccessIdentity:
				fmt.Println(cloudfront.ErrCodeInvalidOriginAccessIdentity, aerr.Error())
			case cloudfront.ErrCodeTooManyTrustedSigners:
				fmt.Println(cloudfront.ErrCodeTooManyTrustedSigners, aerr.Error())
			case cloudfront.ErrCodeTrustedSignerDoesNotExist:
				fmt.Println(cloudfront.ErrCodeTrustedSignerDoesNotExist, aerr.Error())
			case cloudfront.ErrCodeInconsistentQuantities:
				fmt.Println(cloudfront.ErrCodeInconsistentQuantities, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
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 will be populated with the request's response once the request complets successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateStreamingDistribution for more information on using the UpdateStreamingDistribution API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// 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)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/cloudfront-2017-03-25/UpdateStreamingDistribution

func (*CloudFront) UpdateStreamingDistributionWithContext added in v1.8.0

func (c *CloudFront) UpdateStreamingDistributionWithContext(ctx aws.Context, input *UpdateStreamingDistributionInput, opts ...request.Option) (*UpdateStreamingDistributionOutput, error)

UpdateStreamingDistributionWithContext is the same as UpdateStreamingDistribution with the addition of the ability to pass a context and additional request options.

See UpdateStreamingDistribution for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) WaitUntilDistributionDeployed added in v0.10.3

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 met within the max attempt window, an error will be returned.

func (*CloudFront) WaitUntilDistributionDeployedWithContext added in v1.8.0

func (c *CloudFront) WaitUntilDistributionDeployedWithContext(ctx aws.Context, input *GetDistributionInput, opts ...request.WaiterOption) error

WaitUntilDistributionDeployedWithContext is an extended version of WaitUntilDistributionDeployed. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) WaitUntilInvalidationCompleted added in v0.10.3

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 met within the max attempt window, an error will be returned.

func (*CloudFront) WaitUntilInvalidationCompletedWithContext added in v1.8.0

func (c *CloudFront) WaitUntilInvalidationCompletedWithContext(ctx aws.Context, input *GetInvalidationInput, opts ...request.WaiterOption) error

WaitUntilInvalidationCompletedWithContext is an extended version of WaitUntilInvalidationCompleted. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*CloudFront) WaitUntilStreamingDistributionDeployed added in v0.10.3

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 met within the max attempt window, an error will be returned.

func (*CloudFront) WaitUntilStreamingDistributionDeployedWithContext added in v1.8.0

func (c *CloudFront) WaitUntilStreamingDistributionDeployedWithContext(ctx aws.Context, input *GetStreamingDistributionInput, opts ...request.WaiterOption) error

WaitUntilStreamingDistributionDeployedWithContext is an extended version of WaitUntilStreamingDistributionDeployed. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

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 added in v0.6.5

func (s CookieNames) GoString() string

GoString returns the string representation

func (*CookieNames) SetItems added in v1.5.0

func (s *CookieNames) SetItems(v []*string) *CookieNames

SetItems sets the Items field's value.

func (*CookieNames) SetQuantity added in v1.5.0

func (s *CookieNames) SetQuantity(v int64) *CookieNames

SetQuantity sets the Quantity field's value.

func (CookieNames) String added in v0.6.5

func (s CookieNames) String() string

String returns the string representation

func (*CookieNames) Validate added in v1.1.21

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 added in v0.6.5

func (s CookiePreference) GoString() string

GoString returns the string representation

func (*CookiePreference) SetForward added in v1.5.0

func (s *CookiePreference) SetForward(v string) *CookiePreference

SetForward sets the Forward field's value.

func (*CookiePreference) SetWhitelistedNames added in v1.5.0

func (s *CookiePreference) SetWhitelistedNames(v *CookieNames) *CookiePreference

SetWhitelistedNames sets the WhitelistedNames field's value.

func (CookiePreference) String added in v0.6.5

func (s CookiePreference) String() string

String returns the string representation

func (*CookiePreference) Validate added in v1.1.21

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 `` /* 141-byte string literal not displayed */
	// contains filtered or unexported fields
}

The request to create a new origin access identity.

func (CreateCloudFrontOriginAccessIdentityInput) GoString added in v0.6.5

GoString returns the string representation

func (*CreateCloudFrontOriginAccessIdentityInput) SetCloudFrontOriginAccessIdentityConfig added in v1.5.0

SetCloudFrontOriginAccessIdentityConfig sets the CloudFrontOriginAccessIdentityConfig field's value.

func (CreateCloudFrontOriginAccessIdentityInput) String added in v0.6.5

String returns the string representation

func (*CreateCloudFrontOriginAccessIdentityInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*CreateCloudFrontOriginAccessIdentityOutput) SetCloudFrontOriginAccessIdentity added in v1.5.0

SetCloudFrontOriginAccessIdentity sets the CloudFrontOriginAccessIdentity field's value.

func (*CreateCloudFrontOriginAccessIdentityOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (*CreateCloudFrontOriginAccessIdentityOutput) SetLocation added in v1.5.0

SetLocation sets the Location field's value.

func (CreateCloudFrontOriginAccessIdentityOutput) String added in v0.6.5

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" xmlURI:"http://cloudfront.amazonaws.com/doc/2017-03-25/"`
	// contains filtered or unexported fields
}

The request to create a new distribution.

func (CreateDistributionInput) GoString added in v0.6.5

func (s CreateDistributionInput) GoString() string

GoString returns the string representation

func (*CreateDistributionInput) SetDistributionConfig added in v1.5.0

SetDistributionConfig sets the DistributionConfig field's value.

func (CreateDistributionInput) String added in v0.6.5

func (s CreateDistributionInput) String() string

String returns the string representation

func (*CreateDistributionInput) Validate added in v1.1.21

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 added in v0.6.5

func (s CreateDistributionOutput) GoString() string

GoString returns the string representation

func (*CreateDistributionOutput) SetDistribution added in v1.5.0

SetDistribution sets the Distribution field's value.

func (*CreateDistributionOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (*CreateDistributionOutput) SetLocation added in v1.5.0

SetLocation sets the Location field's value.

func (CreateDistributionOutput) String added in v0.6.5

func (s CreateDistributionOutput) String() string

String returns the string representation

type CreateDistributionWithTagsInput added in v1.4.0

type CreateDistributionWithTagsInput struct {

	// The distribution's configuration information.
	//
	// DistributionConfigWithTags is a required field
	DistributionConfigWithTags *DistributionConfigWithTags `` /* 131-byte string literal not displayed */
	// contains filtered or unexported fields
}

The request to create a new distribution with tags.

func (CreateDistributionWithTagsInput) GoString added in v1.4.0

GoString returns the string representation

func (*CreateDistributionWithTagsInput) SetDistributionConfigWithTags added in v1.5.0

SetDistributionConfigWithTags sets the DistributionConfigWithTags field's value.

func (CreateDistributionWithTagsInput) String added in v1.4.0

String returns the string representation

func (*CreateDistributionWithTagsInput) Validate added in v1.4.0

func (s *CreateDistributionWithTagsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateDistributionWithTagsOutput added in v1.4.0

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 added in v1.4.0

GoString returns the string representation

func (*CreateDistributionWithTagsOutput) SetDistribution added in v1.5.0

SetDistribution sets the Distribution field's value.

func (*CreateDistributionWithTagsOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (*CreateDistributionWithTagsOutput) SetLocation added in v1.5.0

SetLocation sets the Location field's value.

func (CreateDistributionWithTagsOutput) String added in v1.4.0

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" xmlURI:"http://cloudfront.amazonaws.com/doc/2017-03-25/"`
	// contains filtered or unexported fields
}

The request to create an invalidation.

func (CreateInvalidationInput) GoString added in v0.6.5

func (s CreateInvalidationInput) GoString() string

GoString returns the string representation

func (*CreateInvalidationInput) SetDistributionId added in v1.5.0

func (s *CreateInvalidationInput) SetDistributionId(v string) *CreateInvalidationInput

SetDistributionId sets the DistributionId field's value.

func (*CreateInvalidationInput) SetInvalidationBatch added in v1.5.0

SetInvalidationBatch sets the InvalidationBatch field's value.

func (CreateInvalidationInput) String added in v0.6.5

func (s CreateInvalidationInput) String() string

String returns the string representation

func (*CreateInvalidationInput) Validate added in v1.1.21

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 added in v0.6.5

func (s CreateInvalidationOutput) GoString() string

GoString returns the string representation

func (*CreateInvalidationOutput) SetInvalidation added in v1.5.0

SetInvalidation sets the Invalidation field's value.

func (*CreateInvalidationOutput) SetLocation added in v1.5.0

SetLocation sets the Location field's value.

func (CreateInvalidationOutput) String added in v0.6.5

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 `` /* 132-byte string literal not displayed */
	// contains filtered or unexported fields
}

The request to create a new streaming distribution.

func (CreateStreamingDistributionInput) GoString added in v0.6.5

GoString returns the string representation

func (*CreateStreamingDistributionInput) SetStreamingDistributionConfig added in v1.5.0

SetStreamingDistributionConfig sets the StreamingDistributionConfig field's value.

func (CreateStreamingDistributionInput) String added in v0.6.5

String returns the string representation

func (*CreateStreamingDistributionInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*CreateStreamingDistributionOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (*CreateStreamingDistributionOutput) SetLocation added in v1.5.0

SetLocation sets the Location field's value.

func (*CreateStreamingDistributionOutput) SetStreamingDistribution added in v1.5.0

SetStreamingDistribution sets the StreamingDistribution field's value.

func (CreateStreamingDistributionOutput) String added in v0.6.5

String returns the string representation

type CreateStreamingDistributionWithTagsInput added in v1.4.0

type CreateStreamingDistributionWithTagsInput struct {

	// The streaming distribution's configuration information.
	//
	// StreamingDistributionConfigWithTags is a required field
	StreamingDistributionConfigWithTags *StreamingDistributionConfigWithTags `` /* 140-byte string literal not displayed */
	// contains filtered or unexported fields
}

The request to create a new streaming distribution with tags.

func (CreateStreamingDistributionWithTagsInput) GoString added in v1.4.0

GoString returns the string representation

func (*CreateStreamingDistributionWithTagsInput) SetStreamingDistributionConfigWithTags added in v1.5.0

SetStreamingDistributionConfigWithTags sets the StreamingDistributionConfigWithTags field's value.

func (CreateStreamingDistributionWithTagsInput) String added in v1.4.0

String returns the string representation

func (*CreateStreamingDistributionWithTagsInput) Validate added in v1.4.0

Validate inspects the fields of the type to determine if they are valid.

type CreateStreamingDistributionWithTagsOutput added in v1.4.0

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 added in v1.4.0

GoString returns the string representation

func (*CreateStreamingDistributionWithTagsOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (*CreateStreamingDistributionWithTagsOutput) SetLocation added in v1.5.0

SetLocation sets the Location field's value.

func (*CreateStreamingDistributionWithTagsOutput) SetStreamingDistribution added in v1.5.0

SetStreamingDistribution sets the StreamingDistribution field's value.

func (CreateStreamingDistributionWithTagsOutput) String added in v1.4.0

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 added in v0.6.5

func (s CustomErrorResponse) GoString() string

GoString returns the string representation

func (*CustomErrorResponse) SetErrorCachingMinTTL added in v1.5.0

func (s *CustomErrorResponse) SetErrorCachingMinTTL(v int64) *CustomErrorResponse

SetErrorCachingMinTTL sets the ErrorCachingMinTTL field's value.

func (*CustomErrorResponse) SetErrorCode added in v1.5.0

func (s *CustomErrorResponse) SetErrorCode(v int64) *CustomErrorResponse

SetErrorCode sets the ErrorCode field's value.

func (*CustomErrorResponse) SetResponseCode added in v1.5.0

func (s *CustomErrorResponse) SetResponseCode(v string) *CustomErrorResponse

SetResponseCode sets the ResponseCode field's value.

func (*CustomErrorResponse) SetResponsePagePath added in v1.5.0

func (s *CustomErrorResponse) SetResponsePagePath(v string) *CustomErrorResponse

SetResponsePagePath sets the ResponsePagePath field's value.

func (CustomErrorResponse) String added in v0.6.5

func (s CustomErrorResponse) String() string

String returns the string representation

func (*CustomErrorResponse) Validate added in v1.1.21

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 added in v0.6.5

func (s CustomErrorResponses) GoString() string

GoString returns the string representation

func (*CustomErrorResponses) SetItems added in v1.5.0

SetItems sets the Items field's value.

func (*CustomErrorResponses) SetQuantity added in v1.5.0

func (s *CustomErrorResponses) SetQuantity(v int64) *CustomErrorResponses

SetQuantity sets the Quantity field's value.

func (CustomErrorResponses) String added in v0.6.5

func (s CustomErrorResponses) String() string

String returns the string representation

func (*CustomErrorResponses) Validate added in v1.1.21

func (s *CustomErrorResponses) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CustomHeaders added in v1.0.9

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 added in v1.0.9

func (s CustomHeaders) GoString() string

GoString returns the string representation

func (*CustomHeaders) SetItems added in v1.5.0

func (s *CustomHeaders) SetItems(v []*OriginCustomHeader) *CustomHeaders

SetItems sets the Items field's value.

func (*CustomHeaders) SetQuantity added in v1.5.0

func (s *CustomHeaders) SetQuantity(v int64) *CustomHeaders

SetQuantity sets the Quantity field's value.

func (CustomHeaders) String added in v1.0.9

func (s CustomHeaders) String() string

String returns the string representation

func (*CustomHeaders) Validate added in v1.1.21

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"`

	// You can create a custom keep-alive timeout. All timeout units are in seconds.
	// The default keep-alive timeout is 5 seconds, but you can configure custom
	// timeout lengths using the CloudFront API. The minimum timeout length is 1
	// second; the maximum is 60 seconds.
	//
	// If you need to increase the maximum time limit, contact the AWS Support Center
	// (https://console.aws.amazon.com/support/home#/).
	OriginKeepaliveTimeout *int64 `type:"integer"`

	// The origin protocol policy to apply to your origin.
	//
	// OriginProtocolPolicy is a required field
	OriginProtocolPolicy *string `type:"string" required:"true" enum:"OriginProtocolPolicy"`

	// You can create a custom origin read timeout. All timeout units are in seconds.
	// The default origin read timeout is 30 seconds, but you can configure custom
	// timeout lengths using the CloudFront API. The minimum timeout length is 4
	// seconds; the maximum is 60 seconds.
	//
	// If you need to increase the maximum time limit, contact the AWS Support Center
	// (https://console.aws.amazon.com/support/home#/).
	OriginReadTimeout *int64 `type:"integer"`

	// 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 added in v0.6.5

func (s CustomOriginConfig) GoString() string

GoString returns the string representation

func (*CustomOriginConfig) SetHTTPPort added in v1.5.0

func (s *CustomOriginConfig) SetHTTPPort(v int64) *CustomOriginConfig

SetHTTPPort sets the HTTPPort field's value.

func (*CustomOriginConfig) SetHTTPSPort added in v1.5.0

func (s *CustomOriginConfig) SetHTTPSPort(v int64) *CustomOriginConfig

SetHTTPSPort sets the HTTPSPort field's value.

func (*CustomOriginConfig) SetOriginKeepaliveTimeout added in v1.8.5

func (s *CustomOriginConfig) SetOriginKeepaliveTimeout(v int64) *CustomOriginConfig

SetOriginKeepaliveTimeout sets the OriginKeepaliveTimeout field's value.

func (*CustomOriginConfig) SetOriginProtocolPolicy added in v1.5.0

func (s *CustomOriginConfig) SetOriginProtocolPolicy(v string) *CustomOriginConfig

SetOriginProtocolPolicy sets the OriginProtocolPolicy field's value.

func (*CustomOriginConfig) SetOriginReadTimeout added in v1.8.5

func (s *CustomOriginConfig) SetOriginReadTimeout(v int64) *CustomOriginConfig

SetOriginReadTimeout sets the OriginReadTimeout field's value.

func (*CustomOriginConfig) SetOriginSslProtocols added in v1.5.0

func (s *CustomOriginConfig) SetOriginSslProtocols(v *OriginSslProtocols) *CustomOriginConfig

SetOriginSslProtocols sets the OriginSslProtocols field's value.

func (CustomOriginConfig) String added in v0.6.5

func (s CustomOriginConfig) String() string

String returns the string representation

func (*CustomOriginConfig) Validate added in v1.1.21

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"`

	// A complex type that contains zero or more Lambda function associations for
	// a cache behavior.
	LambdaFunctionAssociations *LambdaFunctionAssociations `type:"structure"`

	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 don't 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 added in v0.6.5

func (s DefaultCacheBehavior) GoString() string

GoString returns the string representation

func (*DefaultCacheBehavior) SetAllowedMethods added in v1.5.0

func (s *DefaultCacheBehavior) SetAllowedMethods(v *AllowedMethods) *DefaultCacheBehavior

SetAllowedMethods sets the AllowedMethods field's value.

func (*DefaultCacheBehavior) SetCompress added in v1.5.0

func (s *DefaultCacheBehavior) SetCompress(v bool) *DefaultCacheBehavior

SetCompress sets the Compress field's value.

func (*DefaultCacheBehavior) SetDefaultTTL added in v1.5.0

func (s *DefaultCacheBehavior) SetDefaultTTL(v int64) *DefaultCacheBehavior

SetDefaultTTL sets the DefaultTTL field's value.

func (*DefaultCacheBehavior) SetForwardedValues added in v1.5.0

func (s *DefaultCacheBehavior) SetForwardedValues(v *ForwardedValues) *DefaultCacheBehavior

SetForwardedValues sets the ForwardedValues field's value.

func (*DefaultCacheBehavior) SetLambdaFunctionAssociations added in v1.6.2

func (s *DefaultCacheBehavior) SetLambdaFunctionAssociations(v *LambdaFunctionAssociations) *DefaultCacheBehavior

SetLambdaFunctionAssociations sets the LambdaFunctionAssociations field's value.

func (*DefaultCacheBehavior) SetMaxTTL added in v1.5.0

SetMaxTTL sets the MaxTTL field's value.

func (*DefaultCacheBehavior) SetMinTTL added in v1.5.0

SetMinTTL sets the MinTTL field's value.

func (*DefaultCacheBehavior) SetSmoothStreaming added in v1.5.0

func (s *DefaultCacheBehavior) SetSmoothStreaming(v bool) *DefaultCacheBehavior

SetSmoothStreaming sets the SmoothStreaming field's value.

func (*DefaultCacheBehavior) SetTargetOriginId added in v1.5.0

func (s *DefaultCacheBehavior) SetTargetOriginId(v string) *DefaultCacheBehavior

SetTargetOriginId sets the TargetOriginId field's value.

func (*DefaultCacheBehavior) SetTrustedSigners added in v1.5.0

func (s *DefaultCacheBehavior) SetTrustedSigners(v *TrustedSigners) *DefaultCacheBehavior

SetTrustedSigners sets the TrustedSigners field's value.

func (*DefaultCacheBehavior) SetViewerProtocolPolicy added in v1.5.0

func (s *DefaultCacheBehavior) SetViewerProtocolPolicy(v string) *DefaultCacheBehavior

SetViewerProtocolPolicy sets the ViewerProtocolPolicy field's value.

func (DefaultCacheBehavior) String added in v0.6.5

func (s DefaultCacheBehavior) String() string

String returns the string representation

func (*DefaultCacheBehavior) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*DeleteCloudFrontOriginAccessIdentityInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (*DeleteCloudFrontOriginAccessIdentityInput) SetIfMatch added in v1.5.0

SetIfMatch sets the IfMatch field's value.

func (DeleteCloudFrontOriginAccessIdentityInput) String added in v0.6.5

String returns the string representation

func (*DeleteCloudFrontOriginAccessIdentityInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (DeleteCloudFrontOriginAccessIdentityOutput) String added in v0.6.5

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 added in v0.6.5

func (s DeleteDistributionInput) GoString() string

GoString returns the string representation

func (*DeleteDistributionInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (*DeleteDistributionInput) SetIfMatch added in v1.5.0

SetIfMatch sets the IfMatch field's value.

func (DeleteDistributionInput) String added in v0.6.5

func (s DeleteDistributionInput) String() string

String returns the string representation

func (*DeleteDistributionInput) Validate added in v1.1.21

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 added in v0.6.5

func (s DeleteDistributionOutput) GoString() string

GoString returns the string representation

func (DeleteDistributionOutput) String added in v0.6.5

func (s DeleteDistributionOutput) String() string

String returns the string representation

type DeleteServiceLinkedRoleInput added in v1.12.18

type DeleteServiceLinkedRoleInput struct {

	// RoleName is a required field
	RoleName *string `location:"uri" locationName:"RoleName" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteServiceLinkedRoleInput) GoString added in v1.12.18

func (s DeleteServiceLinkedRoleInput) GoString() string

GoString returns the string representation

func (*DeleteServiceLinkedRoleInput) SetRoleName added in v1.12.18

SetRoleName sets the RoleName field's value.

func (DeleteServiceLinkedRoleInput) String added in v1.12.18

String returns the string representation

func (*DeleteServiceLinkedRoleInput) Validate added in v1.12.18

func (s *DeleteServiceLinkedRoleInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteServiceLinkedRoleOutput added in v1.12.18

type DeleteServiceLinkedRoleOutput struct {
	// contains filtered or unexported fields
}

func (DeleteServiceLinkedRoleOutput) GoString added in v1.12.18

GoString returns the string representation

func (DeleteServiceLinkedRoleOutput) String added in v1.12.18

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 added in v0.6.5

GoString returns the string representation

func (*DeleteStreamingDistributionInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (*DeleteStreamingDistributionInput) SetIfMatch added in v1.5.0

SetIfMatch sets the IfMatch field's value.

func (DeleteStreamingDistributionInput) String added in v0.6.5

String returns the string representation

func (*DeleteStreamingDistributionInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (DeleteStreamingDistributionOutput) String added in v0.6.5

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, d111111abcdef8.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 added in v0.6.5

func (s Distribution) GoString() string

GoString returns the string representation

func (*Distribution) SetARN added in v1.5.0

func (s *Distribution) SetARN(v string) *Distribution

SetARN sets the ARN field's value.

func (*Distribution) SetActiveTrustedSigners added in v1.5.0

func (s *Distribution) SetActiveTrustedSigners(v *ActiveTrustedSigners) *Distribution

SetActiveTrustedSigners sets the ActiveTrustedSigners field's value.

func (*Distribution) SetDistributionConfig added in v1.5.0

func (s *Distribution) SetDistributionConfig(v *DistributionConfig) *Distribution

SetDistributionConfig sets the DistributionConfig field's value.

func (*Distribution) SetDomainName added in v1.5.0

func (s *Distribution) SetDomainName(v string) *Distribution

SetDomainName sets the DomainName field's value.

func (*Distribution) SetId added in v1.5.0

func (s *Distribution) SetId(v string) *Distribution

SetId sets the Id field's value.

func (*Distribution) SetInProgressInvalidationBatches added in v1.5.0

func (s *Distribution) SetInProgressInvalidationBatches(v int64) *Distribution

SetInProgressInvalidationBatches sets the InProgressInvalidationBatches field's value.

func (*Distribution) SetLastModifiedTime added in v1.5.0

func (s *Distribution) SetLastModifiedTime(v time.Time) *Distribution

SetLastModifiedTime sets the LastModifiedTime field's value.

func (*Distribution) SetStatus added in v1.5.0

func (s *Distribution) SetStatus(v string) *Distribution

SetStatus sets the Status field's value.

func (Distribution) String added in v0.6.5

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 don't 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. Don't 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"`

	// From this field, you can enable or disable the selected distribution.
	//
	// 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, don't 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:
	//
	//    * 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 only one of the following values:
	//
	//    * ViewerCertificate$ACMCertificateArn
	//
	//    * ViewerCertificate$IAMCertificateId
	//
	//    * ViewerCertificate$CloudFrontDefaultCertificate
	//
	// Don't specify false for CloudFrontDefaultCertificate.
	//
	// If you want viewers to use HTTP instead of HTTPS 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 (such as 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.
	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 added in v0.6.5

func (s DistributionConfig) GoString() string

GoString returns the string representation

func (*DistributionConfig) SetAliases added in v1.5.0

func (s *DistributionConfig) SetAliases(v *Aliases) *DistributionConfig

SetAliases sets the Aliases field's value.

func (*DistributionConfig) SetCacheBehaviors added in v1.5.0

func (s *DistributionConfig) SetCacheBehaviors(v *CacheBehaviors) *DistributionConfig

SetCacheBehaviors sets the CacheBehaviors field's value.

func (*DistributionConfig) SetCallerReference added in v1.5.0

func (s *DistributionConfig) SetCallerReference(v string) *DistributionConfig

SetCallerReference sets the CallerReference field's value.

func (*DistributionConfig) SetComment added in v1.5.0

func (s *DistributionConfig) SetComment(v string) *DistributionConfig

SetComment sets the Comment field's value.

func (*DistributionConfig) SetCustomErrorResponses added in v1.5.0

func (s *DistributionConfig) SetCustomErrorResponses(v *CustomErrorResponses) *DistributionConfig

SetCustomErrorResponses sets the CustomErrorResponses field's value.

func (*DistributionConfig) SetDefaultCacheBehavior added in v1.5.0

func (s *DistributionConfig) SetDefaultCacheBehavior(v *DefaultCacheBehavior) *DistributionConfig

SetDefaultCacheBehavior sets the DefaultCacheBehavior field's value.

func (*DistributionConfig) SetDefaultRootObject added in v1.5.0

func (s *DistributionConfig) SetDefaultRootObject(v string) *DistributionConfig

SetDefaultRootObject sets the DefaultRootObject field's value.

func (*DistributionConfig) SetEnabled added in v1.5.0

func (s *DistributionConfig) SetEnabled(v bool) *DistributionConfig

SetEnabled sets the Enabled field's value.

func (*DistributionConfig) SetHttpVersion added in v1.5.0

func (s *DistributionConfig) SetHttpVersion(v string) *DistributionConfig

SetHttpVersion sets the HttpVersion field's value.

func (*DistributionConfig) SetIsIPV6Enabled added in v1.5.0

func (s *DistributionConfig) SetIsIPV6Enabled(v bool) *DistributionConfig

SetIsIPV6Enabled sets the IsIPV6Enabled field's value.

func (*DistributionConfig) SetLogging added in v1.5.0

SetLogging sets the Logging field's value.

func (*DistributionConfig) SetOrigins added in v1.5.0

func (s *DistributionConfig) SetOrigins(v *Origins) *DistributionConfig

SetOrigins sets the Origins field's value.

func (*DistributionConfig) SetPriceClass added in v1.5.0

func (s *DistributionConfig) SetPriceClass(v string) *DistributionConfig

SetPriceClass sets the PriceClass field's value.

func (*DistributionConfig) SetRestrictions added in v1.5.0

func (s *DistributionConfig) SetRestrictions(v *Restrictions) *DistributionConfig

SetRestrictions sets the Restrictions field's value.

func (*DistributionConfig) SetViewerCertificate added in v1.5.0

func (s *DistributionConfig) SetViewerCertificate(v *ViewerCertificate) *DistributionConfig

SetViewerCertificate sets the ViewerCertificate field's value.

func (*DistributionConfig) SetWebACLId added in v1.5.0

func (s *DistributionConfig) SetWebACLId(v string) *DistributionConfig

SetWebACLId sets the WebACLId field's value.

func (DistributionConfig) String added in v0.6.5

func (s DistributionConfig) String() string

String returns the string representation

func (*DistributionConfig) Validate added in v1.1.21

func (s *DistributionConfig) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DistributionConfigWithTags added in v1.4.0

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 added in v1.4.0

func (s DistributionConfigWithTags) GoString() string

GoString returns the string representation

func (*DistributionConfigWithTags) SetDistributionConfig added in v1.5.0

SetDistributionConfig sets the DistributionConfig field's value.

func (*DistributionConfigWithTags) SetTags added in v1.5.0

SetTags sets the Tags field's value.

func (DistributionConfigWithTags) String added in v1.4.0

String returns the string representation

func (*DistributionConfigWithTags) Validate added in v1.4.0

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 added in v0.6.5

func (s DistributionList) GoString() string

GoString returns the string representation

func (*DistributionList) SetIsTruncated added in v1.5.0

func (s *DistributionList) SetIsTruncated(v bool) *DistributionList

SetIsTruncated sets the IsTruncated field's value.

func (*DistributionList) SetItems added in v1.5.0

SetItems sets the Items field's value.

func (*DistributionList) SetMarker added in v1.5.0

func (s *DistributionList) SetMarker(v string) *DistributionList

SetMarker sets the Marker field's value.

func (*DistributionList) SetMaxItems added in v1.5.0

func (s *DistributionList) SetMaxItems(v int64) *DistributionList

SetMaxItems sets the MaxItems field's value.

func (*DistributionList) SetNextMarker added in v1.5.0

func (s *DistributionList) SetNextMarker(v string) *DistributionList

SetNextMarker sets the NextMarker field's value.

func (*DistributionList) SetQuantity added in v1.5.0

func (s *DistributionList) SetQuantity(v int64) *DistributionList

SetQuantity sets the Quantity field's value.

func (DistributionList) String added in v0.6.5

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 don't 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, d111111abcdef8.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:
	//
	//    * 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 only one of the following values:
	//
	//    * ViewerCertificate$ACMCertificateArn
	//
	//    * ViewerCertificate$IAMCertificateId
	//
	//    * ViewerCertificate$CloudFrontDefaultCertificate
	//
	// Don't specify false for CloudFrontDefaultCertificate.
	//
	// If you want viewers to use HTTP instead of HTTPS 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 (such as 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.
	//
	// 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 added in v0.6.5

func (s DistributionSummary) GoString() string

GoString returns the string representation

func (*DistributionSummary) SetARN added in v1.5.0

SetARN sets the ARN field's value.

func (*DistributionSummary) SetAliases added in v1.5.0

func (s *DistributionSummary) SetAliases(v *Aliases) *DistributionSummary

SetAliases sets the Aliases field's value.

func (*DistributionSummary) SetCacheBehaviors added in v1.5.0

func (s *DistributionSummary) SetCacheBehaviors(v *CacheBehaviors) *DistributionSummary

SetCacheBehaviors sets the CacheBehaviors field's value.

func (*DistributionSummary) SetComment added in v1.5.0

SetComment sets the Comment field's value.

func (*DistributionSummary) SetCustomErrorResponses added in v1.5.0

func (s *DistributionSummary) SetCustomErrorResponses(v *CustomErrorResponses) *DistributionSummary

SetCustomErrorResponses sets the CustomErrorResponses field's value.

func (*DistributionSummary) SetDefaultCacheBehavior added in v1.5.0

func (s *DistributionSummary) SetDefaultCacheBehavior(v *DefaultCacheBehavior) *DistributionSummary

SetDefaultCacheBehavior sets the DefaultCacheBehavior field's value.

func (*DistributionSummary) SetDomainName added in v1.5.0

func (s *DistributionSummary) SetDomainName(v string) *DistributionSummary

SetDomainName sets the DomainName field's value.

func (*DistributionSummary) SetEnabled added in v1.5.0

func (s *DistributionSummary) SetEnabled(v bool) *DistributionSummary

SetEnabled sets the Enabled field's value.

func (*DistributionSummary) SetHttpVersion added in v1.5.0

func (s *DistributionSummary) SetHttpVersion(v string) *DistributionSummary

SetHttpVersion sets the HttpVersion field's value.

func (*DistributionSummary) SetId added in v1.5.0

SetId sets the Id field's value.

func (*DistributionSummary) SetIsIPV6Enabled added in v1.5.0

func (s *DistributionSummary) SetIsIPV6Enabled(v bool) *DistributionSummary

SetIsIPV6Enabled sets the IsIPV6Enabled field's value.

func (*DistributionSummary) SetLastModifiedTime added in v1.5.0

func (s *DistributionSummary) SetLastModifiedTime(v time.Time) *DistributionSummary

SetLastModifiedTime sets the LastModifiedTime field's value.

func (*DistributionSummary) SetOrigins added in v1.5.0

func (s *DistributionSummary) SetOrigins(v *Origins) *DistributionSummary

SetOrigins sets the Origins field's value.

func (*DistributionSummary) SetPriceClass added in v1.5.0

func (s *DistributionSummary) SetPriceClass(v string) *DistributionSummary

SetPriceClass sets the PriceClass field's value.

func (*DistributionSummary) SetRestrictions added in v1.5.0

func (s *DistributionSummary) SetRestrictions(v *Restrictions) *DistributionSummary

SetRestrictions sets the Restrictions field's value.

func (*DistributionSummary) SetStatus added in v1.5.0

SetStatus sets the Status field's value.

func (*DistributionSummary) SetViewerCertificate added in v1.5.0

func (s *DistributionSummary) SetViewerCertificate(v *ViewerCertificate) *DistributionSummary

SetViewerCertificate sets the ViewerCertificate field's value.

func (*DistributionSummary) SetWebACLId added in v1.5.0

func (s *DistributionSummary) SetWebACLId(v string) *DistributionSummary

SetWebACLId sets the WebACLId field's value.

func (DistributionSummary) String added in v0.6.5

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 base caching on 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 added in v0.6.5

func (s ForwardedValues) GoString() string

GoString returns the string representation

func (*ForwardedValues) SetCookies added in v1.5.0

SetCookies sets the Cookies field's value.

func (*ForwardedValues) SetHeaders added in v1.5.0

func (s *ForwardedValues) SetHeaders(v *Headers) *ForwardedValues

SetHeaders sets the Headers field's value.

func (*ForwardedValues) SetQueryString added in v1.5.0

func (s *ForwardedValues) SetQueryString(v bool) *ForwardedValues

SetQueryString sets the QueryString field's value.

func (*ForwardedValues) SetQueryStringCacheKeys added in v1.5.0

func (s *ForwardedValues) SetQueryStringCacheKeys(v *QueryStringCacheKeys) *ForwardedValues

SetQueryStringCacheKeys sets the QueryStringCacheKeys field's value.

func (ForwardedValues) String added in v0.6.5

func (s ForwardedValues) String() string

String returns the string representation

func (*ForwardedValues) Validate added in v1.1.21

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 on 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
	//    don't 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 added in v0.6.5

func (s GeoRestriction) GoString() string

GoString returns the string representation

func (*GeoRestriction) SetItems added in v1.5.0

func (s *GeoRestriction) SetItems(v []*string) *GeoRestriction

SetItems sets the Items field's value.

func (*GeoRestriction) SetQuantity added in v1.5.0

func (s *GeoRestriction) SetQuantity(v int64) *GeoRestriction

SetQuantity sets the Quantity field's value.

func (*GeoRestriction) SetRestrictionType added in v1.5.0

func (s *GeoRestriction) SetRestrictionType(v string) *GeoRestriction

SetRestrictionType sets the RestrictionType field's value.

func (GeoRestriction) String added in v0.6.5

func (s GeoRestriction) String() string

String returns the string representation

func (*GeoRestriction) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*GetCloudFrontOriginAccessIdentityConfigInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (GetCloudFrontOriginAccessIdentityConfigInput) String added in v0.6.5

String returns the string representation

func (*GetCloudFrontOriginAccessIdentityConfigInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*GetCloudFrontOriginAccessIdentityConfigOutput) SetCloudFrontOriginAccessIdentityConfig added in v1.5.0

SetCloudFrontOriginAccessIdentityConfig sets the CloudFrontOriginAccessIdentityConfig field's value.

func (*GetCloudFrontOriginAccessIdentityConfigOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (GetCloudFrontOriginAccessIdentityConfigOutput) String added in v0.6.5

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 added in v0.6.5

GoString returns the string representation

func (*GetCloudFrontOriginAccessIdentityInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (GetCloudFrontOriginAccessIdentityInput) String added in v0.6.5

String returns the string representation

func (*GetCloudFrontOriginAccessIdentityInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*GetCloudFrontOriginAccessIdentityOutput) SetCloudFrontOriginAccessIdentity added in v1.5.0

SetCloudFrontOriginAccessIdentity sets the CloudFrontOriginAccessIdentity field's value.

func (*GetCloudFrontOriginAccessIdentityOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (GetCloudFrontOriginAccessIdentityOutput) String added in v0.6.5

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 added in v0.6.5

func (s GetDistributionConfigInput) GoString() string

GoString returns the string representation

func (*GetDistributionConfigInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (GetDistributionConfigInput) String added in v0.6.5

String returns the string representation

func (*GetDistributionConfigInput) Validate added in v1.1.21

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 added in v0.6.5

func (s GetDistributionConfigOutput) GoString() string

GoString returns the string representation

func (*GetDistributionConfigOutput) SetDistributionConfig added in v1.5.0

SetDistributionConfig sets the DistributionConfig field's value.

func (*GetDistributionConfigOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (GetDistributionConfigOutput) String added in v0.6.5

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 added in v0.6.5

func (s GetDistributionInput) GoString() string

GoString returns the string representation

func (*GetDistributionInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (GetDistributionInput) String added in v0.6.5

func (s GetDistributionInput) String() string

String returns the string representation

func (*GetDistributionInput) Validate added in v1.1.21

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 added in v0.6.5

func (s GetDistributionOutput) GoString() string

GoString returns the string representation

func (*GetDistributionOutput) SetDistribution added in v1.5.0

SetDistribution sets the Distribution field's value.

func (*GetDistributionOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (GetDistributionOutput) String added in v0.6.5

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 added in v0.6.5

func (s GetInvalidationInput) GoString() string

GoString returns the string representation

func (*GetInvalidationInput) SetDistributionId added in v1.5.0

func (s *GetInvalidationInput) SetDistributionId(v string) *GetInvalidationInput

SetDistributionId sets the DistributionId field's value.

func (*GetInvalidationInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (GetInvalidationInput) String added in v0.6.5

func (s GetInvalidationInput) String() string

String returns the string representation

func (*GetInvalidationInput) Validate added in v1.1.21

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 added in v0.6.5

func (s GetInvalidationOutput) GoString() string

GoString returns the string representation

func (*GetInvalidationOutput) SetInvalidation added in v1.5.0

SetInvalidation sets the Invalidation field's value.

func (GetInvalidationOutput) String added in v0.6.5

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 added in v0.6.5

GoString returns the string representation

func (*GetStreamingDistributionConfigInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (GetStreamingDistributionConfigInput) String added in v0.6.5

String returns the string representation

func (*GetStreamingDistributionConfigInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*GetStreamingDistributionConfigOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (*GetStreamingDistributionConfigOutput) SetStreamingDistributionConfig added in v1.5.0

SetStreamingDistributionConfig sets the StreamingDistributionConfig field's value.

func (GetStreamingDistributionConfigOutput) String added in v0.6.5

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 added in v0.6.5

GoString returns the string representation

func (*GetStreamingDistributionInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (GetStreamingDistributionInput) String added in v0.6.5

String returns the string representation

func (*GetStreamingDistributionInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*GetStreamingDistributionOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (*GetStreamingDistributionOutput) SetStreamingDistribution added in v1.5.0

SetStreamingDistribution sets the StreamingDistribution field's value.

func (GetStreamingDistributionOutput) String added in v0.6.5

String returns the string representation

type Headers

type Headers struct {

	// A list that contains one Name element for each header that you want CloudFront
	// to use for caching in 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 base caching
	// on 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.
	//
	// CloudFront doesn't cache the objects that are associated with this cache
	//    behavior. Instead, CloudFront sends every request to the origin.
	//
	//    * Forward a whitelist of headers you specify: Specify the number of headers
	//    that you want CloudFront to base caching on. Then specify the header names
	//    in Name elements. CloudFront caches your objects based on the values in
	//    the specified headers.
	//
	//    * 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.
	//
	// Regardless of which option you choose, CloudFront forwards headers to your
	// origin based on whether the origin is an S3 bucket or a custom origin. See
	// the following documentation:
	//
	//    * S3 bucket: See HTTP Request Headers That CloudFront Removes or Updates
	//    (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/RequestAndResponseBehaviorS3Origin.html#request-s3-removed-headers)
	//
	//    * Custom origin: See HTTP Request Headers and CloudFront Behavior (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/RequestAndResponseBehaviorCustomOrigin.html#request-custom-headers-behavior)
	//
	// Quantity is a required field
	Quantity *int64 `type:"integer" required:"true"`
	// contains filtered or unexported fields
}

A complex type that specifies the request headers, if any, that you want CloudFront to base caching on for this cache behavior.

For the headers that you specify, CloudFront caches separate versions of a specified object based on the header values in viewer requests. For example, suppose viewer requests for 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.

func (Headers) GoString added in v0.6.5

func (s Headers) GoString() string

GoString returns the string representation

func (*Headers) SetItems added in v1.5.0

func (s *Headers) SetItems(v []*string) *Headers

SetItems sets the Items field's value.

func (*Headers) SetQuantity added in v1.5.0

func (s *Headers) SetQuantity(v int64) *Headers

SetQuantity sets the Quantity field's value.

func (Headers) String added in v0.6.5

func (s Headers) String() string

String returns the string representation

func (*Headers) Validate added in v1.1.21

func (s *Headers) Validate() error

Validate inspects the fields of the type to determine if they are valid.

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 added in v0.6.5

func (s Invalidation) GoString() string

GoString returns the string representation

func (*Invalidation) SetCreateTime added in v1.5.0

func (s *Invalidation) SetCreateTime(v time.Time) *Invalidation

SetCreateTime sets the CreateTime field's value.

func (*Invalidation) SetId added in v1.5.0

func (s *Invalidation) SetId(v string) *Invalidation

SetId sets the Id field's value.

func (*Invalidation) SetInvalidationBatch added in v1.5.0

func (s *Invalidation) SetInvalidationBatch(v *InvalidationBatch) *Invalidation

SetInvalidationBatch sets the InvalidationBatch field's value.

func (*Invalidation) SetStatus added in v1.5.0

func (s *Invalidation) SetStatus(v string) *Invalidation

SetStatus sets the Status field's value.

func (Invalidation) String added in v0.6.5

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 added in v0.6.5

func (s InvalidationBatch) GoString() string

GoString returns the string representation

func (*InvalidationBatch) SetCallerReference added in v1.5.0

func (s *InvalidationBatch) SetCallerReference(v string) *InvalidationBatch

SetCallerReference sets the CallerReference field's value.

func (*InvalidationBatch) SetPaths added in v1.5.0

func (s *InvalidationBatch) SetPaths(v *Paths) *InvalidationBatch

SetPaths sets the Paths field's value.

func (InvalidationBatch) String added in v0.6.5

func (s InvalidationBatch) String() string

String returns the string representation

func (*InvalidationBatch) Validate added in v1.1.21

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 added in v0.6.5

func (s InvalidationList) GoString() string

GoString returns the string representation

func (*InvalidationList) SetIsTruncated added in v1.5.0

func (s *InvalidationList) SetIsTruncated(v bool) *InvalidationList

SetIsTruncated sets the IsTruncated field's value.

func (*InvalidationList) SetItems added in v1.5.0

SetItems sets the Items field's value.

func (*InvalidationList) SetMarker added in v1.5.0

func (s *InvalidationList) SetMarker(v string) *InvalidationList

SetMarker sets the Marker field's value.

func (*InvalidationList) SetMaxItems added in v1.5.0

func (s *InvalidationList) SetMaxItems(v int64) *InvalidationList

SetMaxItems sets the MaxItems field's value.

func (*InvalidationList) SetNextMarker added in v1.5.0

func (s *InvalidationList) SetNextMarker(v string) *InvalidationList

SetNextMarker sets the NextMarker field's value.

func (*InvalidationList) SetQuantity added in v1.5.0

func (s *InvalidationList) SetQuantity(v int64) *InvalidationList

SetQuantity sets the Quantity field's value.

func (InvalidationList) String added in v0.6.5

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 added in v0.6.5

func (s InvalidationSummary) GoString() string

GoString returns the string representation

func (*InvalidationSummary) SetCreateTime added in v1.5.0

func (s *InvalidationSummary) SetCreateTime(v time.Time) *InvalidationSummary

SetCreateTime sets the CreateTime field's value.

func (*InvalidationSummary) SetId added in v1.5.0

SetId sets the Id field's value.

func (*InvalidationSummary) SetStatus added in v1.5.0

SetStatus sets the Status field's value.

func (InvalidationSummary) String added in v0.6.5

func (s InvalidationSummary) String() string

String returns the string representation

type KeyPairIds added in v0.9.5

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 added in v0.9.5

func (s KeyPairIds) GoString() string

GoString returns the string representation

func (*KeyPairIds) SetItems added in v1.5.0

func (s *KeyPairIds) SetItems(v []*string) *KeyPairIds

SetItems sets the Items field's value.

func (*KeyPairIds) SetQuantity added in v1.5.0

func (s *KeyPairIds) SetQuantity(v int64) *KeyPairIds

SetQuantity sets the Quantity field's value.

func (KeyPairIds) String added in v0.9.5

func (s KeyPairIds) String() string

String returns the string representation

type LambdaFunctionAssociation added in v1.6.2

type LambdaFunctionAssociation struct {

	// Specifies the event type that triggers a Lambda function invocation. You
	// can specify the following values:
	//
	//    * viewer-request: The function executes when CloudFront receives a request
	//    from a viewer and before it checks to see whether the requested object
	//    is in the edge cache.
	//
	//    * origin-request: The function executes only when CloudFront forwards
	//    a request to your origin. When the requested object is in the edge cache,
	//    the function doesn't execute.
	//
	//    * origin-response: The function executes after CloudFront receives a response
	//    from the origin and before it caches the object in the response. When
	//    the requested object is in the edge cache, the function doesn't execute.
	//
	// If the origin returns an HTTP status code other than HTTP 200 (OK), the function
	//    doesn't execute.
	//
	//    * viewer-response: The function executes before CloudFront returns the
	//    requested object to the viewer. The function executes regardless of whether
	//    the object was already in the edge cache.
	//
	// If the origin returns an HTTP status code other than HTTP 200 (OK), the function
	//    doesn't execute.
	EventType *string `type:"string" enum:"EventType"`

	// The ARN of the Lambda function. You must specify the ARN of a function version;
	// you can't specify a Lambda alias or $LATEST.
	LambdaFunctionARN *string `type:"string"`
	// contains filtered or unexported fields
}

A complex type that contains a Lambda function association.

func (LambdaFunctionAssociation) GoString added in v1.6.2

func (s LambdaFunctionAssociation) GoString() string

GoString returns the string representation

func (*LambdaFunctionAssociation) SetEventType added in v1.6.2

SetEventType sets the EventType field's value.

func (*LambdaFunctionAssociation) SetLambdaFunctionARN added in v1.6.2

func (s *LambdaFunctionAssociation) SetLambdaFunctionARN(v string) *LambdaFunctionAssociation

SetLambdaFunctionARN sets the LambdaFunctionARN field's value.

func (LambdaFunctionAssociation) String added in v1.6.2

func (s LambdaFunctionAssociation) String() string

String returns the string representation

type LambdaFunctionAssociations added in v1.6.2

type LambdaFunctionAssociations struct {

	// Optional: A complex type that contains LambdaFunctionAssociation items for
	// this cache behavior. If Quantity is 0, you can omit Items.
	Items []*LambdaFunctionAssociation `locationNameList:"LambdaFunctionAssociation" type:"list"`

	// The number of Lambda function associations 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 a list of Lambda functions associations for a cache behavior.

If you want to invoke one or more Lambda functions triggered by requests that match the PathPattern of the cache behavior, specify the applicable values for Quantity and Items. Note that there can be up to 4 LambdaFunctionAssociation items in this list (one for each possible value of EventType) and each EventType can be associated with the Lambda function only once.

If you don't want to invoke any Lambda functions for the requests that match PathPattern, specify 0 for Quantity and omit Items.

func (LambdaFunctionAssociations) GoString added in v1.6.2

func (s LambdaFunctionAssociations) GoString() string

GoString returns the string representation

func (*LambdaFunctionAssociations) SetItems added in v1.6.2

SetItems sets the Items field's value.

func (*LambdaFunctionAssociations) SetQuantity added in v1.6.2

SetQuantity sets the Quantity field's value.

func (LambdaFunctionAssociations) String added in v1.6.2

String returns the string representation

func (*LambdaFunctionAssociations) Validate added in v1.6.2

func (s *LambdaFunctionAssociations) Validate() error

Validate inspects the fields of the type to determine if they are valid.

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 added in v0.6.5

GoString returns the string representation

func (*ListCloudFrontOriginAccessIdentitiesInput) SetMarker added in v1.5.0

SetMarker sets the Marker field's value.

func (*ListCloudFrontOriginAccessIdentitiesInput) SetMaxItems added in v1.5.0

SetMaxItems sets the MaxItems field's value.

func (ListCloudFrontOriginAccessIdentitiesInput) String added in v0.6.5

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 added in v0.6.5

GoString returns the string representation

func (*ListCloudFrontOriginAccessIdentitiesOutput) SetCloudFrontOriginAccessIdentityList added in v1.5.0

SetCloudFrontOriginAccessIdentityList sets the CloudFrontOriginAccessIdentityList field's value.

func (ListCloudFrontOriginAccessIdentitiesOutput) String added in v0.6.5

String returns the string representation

type ListDistributionsByWebACLIdInput added in v0.9.12

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 added in v0.9.12

GoString returns the string representation

func (*ListDistributionsByWebACLIdInput) SetMarker added in v1.5.0

SetMarker sets the Marker field's value.

func (*ListDistributionsByWebACLIdInput) SetMaxItems added in v1.5.0

SetMaxItems sets the MaxItems field's value.

func (*ListDistributionsByWebACLIdInput) SetWebACLId added in v1.5.0

SetWebACLId sets the WebACLId field's value.

func (ListDistributionsByWebACLIdInput) String added in v0.9.12

String returns the string representation

func (*ListDistributionsByWebACLIdInput) Validate added in v1.1.21

Validate inspects the fields of the type to determine if they are valid.

type ListDistributionsByWebACLIdOutput added in v0.9.12

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 added in v0.9.12

GoString returns the string representation

func (*ListDistributionsByWebACLIdOutput) SetDistributionList added in v1.5.0

SetDistributionList sets the DistributionList field's value.

func (ListDistributionsByWebACLIdOutput) String added in v0.9.12

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 added in v0.6.5

func (s ListDistributionsInput) GoString() string

GoString returns the string representation

func (*ListDistributionsInput) SetMarker added in v1.5.0

SetMarker sets the Marker field's value.

func (*ListDistributionsInput) SetMaxItems added in v1.5.0

SetMaxItems sets the MaxItems field's value.

func (ListDistributionsInput) String added in v0.6.5

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 added in v0.6.5

func (s ListDistributionsOutput) GoString() string

GoString returns the string representation

func (*ListDistributionsOutput) SetDistributionList added in v1.5.0

SetDistributionList sets the DistributionList field's value.

func (ListDistributionsOutput) String added in v0.6.5

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 added in v0.6.5

func (s ListInvalidationsInput) GoString() string

GoString returns the string representation

func (*ListInvalidationsInput) SetDistributionId added in v1.5.0

func (s *ListInvalidationsInput) SetDistributionId(v string) *ListInvalidationsInput

SetDistributionId sets the DistributionId field's value.

func (*ListInvalidationsInput) SetMarker added in v1.5.0

SetMarker sets the Marker field's value.

func (*ListInvalidationsInput) SetMaxItems added in v1.5.0

SetMaxItems sets the MaxItems field's value.

func (ListInvalidationsInput) String added in v0.6.5

func (s ListInvalidationsInput) String() string

String returns the string representation

func (*ListInvalidationsInput) Validate added in v1.1.21

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 added in v0.6.5

func (s ListInvalidationsOutput) GoString() string

GoString returns the string representation

func (*ListInvalidationsOutput) SetInvalidationList added in v1.5.0

SetInvalidationList sets the InvalidationList field's value.

func (ListInvalidationsOutput) String added in v0.6.5

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 added in v0.6.5

GoString returns the string representation

func (*ListStreamingDistributionsInput) SetMarker added in v1.5.0

SetMarker sets the Marker field's value.

func (*ListStreamingDistributionsInput) SetMaxItems added in v1.5.0

SetMaxItems sets the MaxItems field's value.

func (ListStreamingDistributionsInput) String added in v0.6.5

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 added in v0.6.5

GoString returns the string representation

func (*ListStreamingDistributionsOutput) SetStreamingDistributionList added in v1.5.0

SetStreamingDistributionList sets the StreamingDistributionList field's value.

func (ListStreamingDistributionsOutput) String added in v0.6.5

String returns the string representation

type ListTagsForResourceInput added in v1.4.0

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 added in v1.4.0

func (s ListTagsForResourceInput) GoString() string

GoString returns the string representation

func (*ListTagsForResourceInput) SetResource added in v1.5.0

SetResource sets the Resource field's value.

func (ListTagsForResourceInput) String added in v1.4.0

func (s ListTagsForResourceInput) String() string

String returns the string representation

func (*ListTagsForResourceInput) Validate added in v1.4.0

func (s *ListTagsForResourceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListTagsForResourceOutput added in v1.4.0

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 added in v1.4.0

func (s ListTagsForResourceOutput) GoString() string

GoString returns the string representation

func (*ListTagsForResourceOutput) SetTags added in v1.5.0

SetTags sets the Tags field's value.

func (ListTagsForResourceOutput) String added in v1.4.0

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 don't 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 don't 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 don't 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 added in v0.6.5

func (s LoggingConfig) GoString() string

GoString returns the string representation

func (*LoggingConfig) SetBucket added in v1.5.0

func (s *LoggingConfig) SetBucket(v string) *LoggingConfig

SetBucket sets the Bucket field's value.

func (*LoggingConfig) SetEnabled added in v1.5.0

func (s *LoggingConfig) SetEnabled(v bool) *LoggingConfig

SetEnabled sets the Enabled field's value.

func (*LoggingConfig) SetIncludeCookies added in v1.5.0

func (s *LoggingConfig) SetIncludeCookies(v bool) *LoggingConfig

SetIncludeCookies sets the IncludeCookies field's value.

func (*LoggingConfig) SetPrefix added in v1.5.0

func (s *LoggingConfig) SetPrefix(v string) *LoggingConfig

SetPrefix sets the Prefix field's value.

func (LoggingConfig) String added in v0.6.5

func (s LoggingConfig) String() string

String returns the string representation

func (*LoggingConfig) Validate added in v1.1.21

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, don't
	//    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.

func (Origin) GoString added in v0.6.5

func (s Origin) GoString() string

GoString returns the string representation

func (*Origin) SetCustomHeaders added in v1.5.0

func (s *Origin) SetCustomHeaders(v *CustomHeaders) *Origin

SetCustomHeaders sets the CustomHeaders field's value.

func (*Origin) SetCustomOriginConfig added in v1.5.0

func (s *Origin) SetCustomOriginConfig(v *CustomOriginConfig) *Origin

SetCustomOriginConfig sets the CustomOriginConfig field's value.

func (*Origin) SetDomainName added in v1.5.0

func (s *Origin) SetDomainName(v string) *Origin

SetDomainName sets the DomainName field's value.

func (*Origin) SetId added in v1.5.0

func (s *Origin) SetId(v string) *Origin

SetId sets the Id field's value.

func (*Origin) SetOriginPath added in v1.5.0

func (s *Origin) SetOriginPath(v string) *Origin

SetOriginPath sets the OriginPath field's value.

func (*Origin) SetS3OriginConfig added in v1.5.0

func (s *Origin) SetS3OriginConfig(v *S3OriginConfig) *Origin

SetS3OriginConfig sets the S3OriginConfig field's value.

func (Origin) String added in v0.6.5

func (s Origin) String() string

String returns the string representation

func (*Origin) Validate added in v1.1.21

func (s *Origin) Validate() error

Validate inspects the fields of the type to determine if they are valid.

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 added in v0.6.5

func (s OriginAccessIdentity) GoString() string

GoString returns the string representation

func (*OriginAccessIdentity) SetCloudFrontOriginAccessIdentityConfig added in v1.5.0

func (s *OriginAccessIdentity) SetCloudFrontOriginAccessIdentityConfig(v *OriginAccessIdentityConfig) *OriginAccessIdentity

SetCloudFrontOriginAccessIdentityConfig sets the CloudFrontOriginAccessIdentityConfig field's value.

func (*OriginAccessIdentity) SetId added in v1.5.0

SetId sets the Id field's value.

func (*OriginAccessIdentity) SetS3CanonicalUserId added in v1.5.0

func (s *OriginAccessIdentity) SetS3CanonicalUserId(v string) *OriginAccessIdentity

SetS3CanonicalUserId sets the S3CanonicalUserId field's value.

func (OriginAccessIdentity) String added in v0.6.5

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 added in v0.6.5

func (s OriginAccessIdentityConfig) GoString() string

GoString returns the string representation

func (*OriginAccessIdentityConfig) SetCallerReference added in v1.5.0

SetCallerReference sets the CallerReference field's value.

func (*OriginAccessIdentityConfig) SetComment added in v1.5.0

SetComment sets the Comment field's value.

func (OriginAccessIdentityConfig) String added in v0.6.5

String returns the string representation

func (*OriginAccessIdentityConfig) Validate added in v1.1.21

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 added in v0.6.5

func (s OriginAccessIdentityList) GoString() string

GoString returns the string representation

func (*OriginAccessIdentityList) SetIsTruncated added in v1.5.0

SetIsTruncated sets the IsTruncated field's value.

func (*OriginAccessIdentityList) SetItems added in v1.5.0

SetItems sets the Items field's value.

func (*OriginAccessIdentityList) SetMarker added in v1.5.0

SetMarker sets the Marker field's value.

func (*OriginAccessIdentityList) SetMaxItems added in v1.5.0

SetMaxItems sets the MaxItems field's value.

func (*OriginAccessIdentityList) SetNextMarker added in v1.5.0

SetNextMarker sets the NextMarker field's value.

func (*OriginAccessIdentityList) SetQuantity added in v1.5.0

SetQuantity sets the Quantity field's value.

func (OriginAccessIdentityList) String added in v0.6.5

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 added in v0.6.5

func (s OriginAccessIdentitySummary) GoString() string

GoString returns the string representation

func (*OriginAccessIdentitySummary) SetComment added in v1.5.0

SetComment sets the Comment field's value.

func (*OriginAccessIdentitySummary) SetId added in v1.5.0

SetId sets the Id field's value.

func (*OriginAccessIdentitySummary) SetS3CanonicalUserId added in v1.5.0

SetS3CanonicalUserId sets the S3CanonicalUserId field's value.

func (OriginAccessIdentitySummary) String added in v0.6.5

String returns the string representation

type OriginCustomHeader added in v1.0.9

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 added in v1.0.9

func (s OriginCustomHeader) GoString() string

GoString returns the string representation

func (*OriginCustomHeader) SetHeaderName added in v1.5.0

func (s *OriginCustomHeader) SetHeaderName(v string) *OriginCustomHeader

SetHeaderName sets the HeaderName field's value.

func (*OriginCustomHeader) SetHeaderValue added in v1.5.0

func (s *OriginCustomHeader) SetHeaderValue(v string) *OriginCustomHeader

SetHeaderValue sets the HeaderValue field's value.

func (OriginCustomHeader) String added in v1.0.9

func (s OriginCustomHeader) String() string

String returns the string representation

func (*OriginCustomHeader) Validate added in v1.1.21

func (s *OriginCustomHeader) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type OriginSslProtocols added in v1.0.9

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 added in v1.0.9

func (s OriginSslProtocols) GoString() string

GoString returns the string representation

func (*OriginSslProtocols) SetItems added in v1.5.0

func (s *OriginSslProtocols) SetItems(v []*string) *OriginSslProtocols

SetItems sets the Items field's value.

func (*OriginSslProtocols) SetQuantity added in v1.5.0

func (s *OriginSslProtocols) SetQuantity(v int64) *OriginSslProtocols

SetQuantity sets the Quantity field's value.

func (OriginSslProtocols) String added in v1.0.9

func (s OriginSslProtocols) String() string

String returns the string representation

func (*OriginSslProtocols) Validate added in v1.1.21

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.

func (Origins) GoString added in v0.6.5

func (s Origins) GoString() string

GoString returns the string representation

func (*Origins) SetItems added in v1.5.0

func (s *Origins) SetItems(v []*Origin) *Origins

SetItems sets the Items field's value.

func (*Origins) SetQuantity added in v1.5.0

func (s *Origins) SetQuantity(v int64) *Origins

SetQuantity sets the Quantity field's value.

func (Origins) String added in v0.6.5

func (s Origins) String() string

String returns the string representation

func (*Origins) Validate added in v1.1.21

func (s *Origins) Validate() error

Validate inspects the fields of the type to determine if they are valid.

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.

func (Paths) GoString added in v0.6.5

func (s Paths) GoString() string

GoString returns the string representation

func (*Paths) SetItems added in v1.5.0

func (s *Paths) SetItems(v []*string) *Paths

SetItems sets the Items field's value.

func (*Paths) SetQuantity added in v1.5.0

func (s *Paths) SetQuantity(v int64) *Paths

SetQuantity sets the Quantity field's value.

func (Paths) String added in v0.6.5

func (s Paths) String() string

String returns the string representation

func (*Paths) Validate added in v1.1.21

func (s *Paths) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type QueryStringCacheKeys added in v1.4.5

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 added in v1.4.5

func (s QueryStringCacheKeys) GoString() string

GoString returns the string representation

func (*QueryStringCacheKeys) SetItems added in v1.5.0

SetItems sets the Items field's value.

func (*QueryStringCacheKeys) SetQuantity added in v1.5.0

func (s *QueryStringCacheKeys) SetQuantity(v int64) *QueryStringCacheKeys

SetQuantity sets the Quantity field's value.

func (QueryStringCacheKeys) String added in v1.4.5

func (s QueryStringCacheKeys) String() string

String returns the string representation

func (*QueryStringCacheKeys) Validate added in v1.4.5

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 added in v0.6.5

func (s Restrictions) GoString() string

GoString returns the string representation

func (*Restrictions) SetGeoRestriction added in v1.5.0

func (s *Restrictions) SetGeoRestriction(v *GeoRestriction) *Restrictions

SetGeoRestriction sets the GeoRestriction field's value.

func (Restrictions) String added in v0.6.5

func (s Restrictions) String() string

String returns the string representation

func (*Restrictions) Validate added in v1.1.21

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.

func (S3Origin) GoString added in v0.6.5

func (s S3Origin) GoString() string

GoString returns the string representation

func (*S3Origin) SetDomainName added in v1.5.0

func (s *S3Origin) SetDomainName(v string) *S3Origin

SetDomainName sets the DomainName field's value.

func (*S3Origin) SetOriginAccessIdentity added in v1.5.0

func (s *S3Origin) SetOriginAccessIdentity(v string) *S3Origin

SetOriginAccessIdentity sets the OriginAccessIdentity field's value.

func (S3Origin) String added in v0.6.5

func (s S3Origin) String() string

String returns the string representation

func (*S3Origin) Validate added in v1.1.21

func (s *S3Origin) Validate() error

Validate inspects the fields of the type to determine if they are valid.

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 added in v0.6.5

func (s S3OriginConfig) GoString() string

GoString returns the string representation

func (*S3OriginConfig) SetOriginAccessIdentity added in v1.5.0

func (s *S3OriginConfig) SetOriginAccessIdentity(v string) *S3OriginConfig

SetOriginAccessIdentity sets the OriginAccessIdentity field's value.

func (S3OriginConfig) String added in v0.6.5

func (s S3OriginConfig) String() string

String returns the string representation

func (*S3OriginConfig) Validate added in v1.1.21

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.

func (Signer) GoString added in v0.6.5

func (s Signer) GoString() string

GoString returns the string representation

func (*Signer) SetAwsAccountNumber added in v1.5.0

func (s *Signer) SetAwsAccountNumber(v string) *Signer

SetAwsAccountNumber sets the AwsAccountNumber field's value.

func (*Signer) SetKeyPairIds added in v1.5.0

func (s *Signer) SetKeyPairIds(v *KeyPairIds) *Signer

SetKeyPairIds sets the KeyPairIds field's value.

func (Signer) String added in v0.6.5

func (s Signer) String() string

String returns the string representation

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 added in v0.6.5

func (s StreamingDistribution) GoString() string

GoString returns the string representation

func (*StreamingDistribution) SetARN added in v1.5.0

SetARN sets the ARN field's value.

func (*StreamingDistribution) SetActiveTrustedSigners added in v1.5.0

func (s *StreamingDistribution) SetActiveTrustedSigners(v *ActiveTrustedSigners) *StreamingDistribution

SetActiveTrustedSigners sets the ActiveTrustedSigners field's value.

func (*StreamingDistribution) SetDomainName added in v1.5.0

func (s *StreamingDistribution) SetDomainName(v string) *StreamingDistribution

SetDomainName sets the DomainName field's value.

func (*StreamingDistribution) SetId added in v1.5.0

SetId sets the Id field's value.

func (*StreamingDistribution) SetLastModifiedTime added in v1.5.0

func (s *StreamingDistribution) SetLastModifiedTime(v time.Time) *StreamingDistribution

SetLastModifiedTime sets the LastModifiedTime field's value.

func (*StreamingDistribution) SetStatus added in v1.5.0

SetStatus sets the Status field's value.

func (*StreamingDistribution) SetStreamingDistributionConfig added in v1.5.0

func (s *StreamingDistribution) SetStreamingDistributionConfig(v *StreamingDistributionConfig) *StreamingDistribution

SetStreamingDistributionConfig sets the StreamingDistributionConfig field's value.

func (StreamingDistribution) String added in v0.6.5

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 added in v0.6.5

func (s StreamingDistributionConfig) GoString() string

GoString returns the string representation

func (*StreamingDistributionConfig) SetAliases added in v1.5.0

SetAliases sets the Aliases field's value.

func (*StreamingDistributionConfig) SetCallerReference added in v1.5.0

SetCallerReference sets the CallerReference field's value.

func (*StreamingDistributionConfig) SetComment added in v1.5.0

SetComment sets the Comment field's value.

func (*StreamingDistributionConfig) SetEnabled added in v1.5.0

SetEnabled sets the Enabled field's value.

func (*StreamingDistributionConfig) SetLogging added in v1.5.0

SetLogging sets the Logging field's value.

func (*StreamingDistributionConfig) SetPriceClass added in v1.5.0

SetPriceClass sets the PriceClass field's value.

func (*StreamingDistributionConfig) SetS3Origin added in v1.5.0

SetS3Origin sets the S3Origin field's value.

func (*StreamingDistributionConfig) SetTrustedSigners added in v1.5.0

SetTrustedSigners sets the TrustedSigners field's value.

func (StreamingDistributionConfig) String added in v0.6.5

String returns the string representation

func (*StreamingDistributionConfig) Validate added in v1.1.21

func (s *StreamingDistributionConfig) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type StreamingDistributionConfigWithTags added in v1.4.0

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 added in v1.4.0

GoString returns the string representation

func (*StreamingDistributionConfigWithTags) SetStreamingDistributionConfig added in v1.5.0

SetStreamingDistributionConfig sets the StreamingDistributionConfig field's value.

func (*StreamingDistributionConfigWithTags) SetTags added in v1.5.0

SetTags sets the Tags field's value.

func (StreamingDistributionConfigWithTags) String added in v1.4.0

String returns the string representation

func (*StreamingDistributionConfigWithTags) Validate added in v1.4.0

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 added in v0.6.5

func (s StreamingDistributionList) GoString() string

GoString returns the string representation

func (*StreamingDistributionList) SetIsTruncated added in v1.5.0

SetIsTruncated sets the IsTruncated field's value.

func (*StreamingDistributionList) SetItems added in v1.5.0

SetItems sets the Items field's value.

func (*StreamingDistributionList) SetMarker added in v1.5.0

SetMarker sets the Marker field's value.

func (*StreamingDistributionList) SetMaxItems added in v1.5.0

SetMaxItems sets the MaxItems field's value.

func (*StreamingDistributionList) SetNextMarker added in v1.5.0

SetNextMarker sets the NextMarker field's value.

func (*StreamingDistributionList) SetQuantity added in v1.5.0

SetQuantity sets the Quantity field's value.

func (StreamingDistributionList) String added in v0.6.5

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, d111111abcdef8.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 added in v0.6.5

func (s StreamingDistributionSummary) GoString() string

GoString returns the string representation

func (*StreamingDistributionSummary) SetARN added in v1.5.0

SetARN sets the ARN field's value.

func (*StreamingDistributionSummary) SetAliases added in v1.5.0

SetAliases sets the Aliases field's value.

func (*StreamingDistributionSummary) SetComment added in v1.5.0

SetComment sets the Comment field's value.

func (*StreamingDistributionSummary) SetDomainName added in v1.5.0

SetDomainName sets the DomainName field's value.

func (*StreamingDistributionSummary) SetEnabled added in v1.5.0

SetEnabled sets the Enabled field's value.

func (*StreamingDistributionSummary) SetId added in v1.5.0

SetId sets the Id field's value.

func (*StreamingDistributionSummary) SetLastModifiedTime added in v1.5.0

SetLastModifiedTime sets the LastModifiedTime field's value.

func (*StreamingDistributionSummary) SetPriceClass added in v1.5.0

SetPriceClass sets the PriceClass field's value.

func (*StreamingDistributionSummary) SetS3Origin added in v1.5.0

SetS3Origin sets the S3Origin field's value.

func (*StreamingDistributionSummary) SetStatus added in v1.5.0

SetStatus sets the Status field's value.

func (*StreamingDistributionSummary) SetTrustedSigners added in v1.5.0

SetTrustedSigners sets the TrustedSigners field's value.

func (StreamingDistributionSummary) String added in v0.6.5

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 don't 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 don't 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 added in v0.6.5

func (s StreamingLoggingConfig) GoString() string

GoString returns the string representation

func (*StreamingLoggingConfig) SetBucket added in v1.5.0

SetBucket sets the Bucket field's value.

func (*StreamingLoggingConfig) SetEnabled added in v1.5.0

SetEnabled sets the Enabled field's value.

func (*StreamingLoggingConfig) SetPrefix added in v1.5.0

SetPrefix sets the Prefix field's value.

func (StreamingLoggingConfig) String added in v0.6.5

func (s StreamingLoggingConfig) String() string

String returns the string representation

func (*StreamingLoggingConfig) Validate added in v1.1.21

func (s *StreamingLoggingConfig) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Tag added in v1.4.0

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.

func (Tag) GoString added in v1.4.0

func (s Tag) GoString() string

GoString returns the string representation

func (*Tag) SetKey added in v1.5.0

func (s *Tag) SetKey(v string) *Tag

SetKey sets the Key field's value.

func (*Tag) SetValue added in v1.5.0

func (s *Tag) SetValue(v string) *Tag

SetValue sets the Value field's value.

func (Tag) String added in v1.4.0

func (s Tag) String() string

String returns the string representation

func (*Tag) Validate added in v1.4.0

func (s *Tag) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TagKeys added in v1.4.0

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.

func (TagKeys) GoString added in v1.4.0

func (s TagKeys) GoString() string

GoString returns the string representation

func (*TagKeys) SetItems added in v1.5.0

func (s *TagKeys) SetItems(v []*string) *TagKeys

SetItems sets the Items field's value.

func (TagKeys) String added in v1.4.0

func (s TagKeys) String() string

String returns the string representation

type TagResourceInput added in v1.4.0

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" xmlURI:"http://cloudfront.amazonaws.com/doc/2017-03-25/"`
	// contains filtered or unexported fields
}

The request to add tags to a CloudFront resource.

func (TagResourceInput) GoString added in v1.4.0

func (s TagResourceInput) GoString() string

GoString returns the string representation

func (*TagResourceInput) SetResource added in v1.5.0

func (s *TagResourceInput) SetResource(v string) *TagResourceInput

SetResource sets the Resource field's value.

func (*TagResourceInput) SetTags added in v1.5.0

func (s *TagResourceInput) SetTags(v *Tags) *TagResourceInput

SetTags sets the Tags field's value.

func (TagResourceInput) String added in v1.4.0

func (s TagResourceInput) String() string

String returns the string representation

func (*TagResourceInput) Validate added in v1.4.0

func (s *TagResourceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TagResourceOutput added in v1.4.0

type TagResourceOutput struct {
	// contains filtered or unexported fields
}

func (TagResourceOutput) GoString added in v1.4.0

func (s TagResourceOutput) GoString() string

GoString returns the string representation

func (TagResourceOutput) String added in v1.4.0

func (s TagResourceOutput) String() string

String returns the string representation

type Tags added in v1.4.0

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.

func (Tags) GoString added in v1.4.0

func (s Tags) GoString() string

GoString returns the string representation

func (*Tags) SetItems added in v1.5.0

func (s *Tags) SetItems(v []*Tag) *Tags

SetItems sets the Items field's value.

func (Tags) String added in v1.4.0

func (s Tags) String() string

String returns the string representation

func (*Tags) Validate added in v1.4.0

func (s *Tags) Validate() error

Validate inspects the fields of the type to determine if they are valid.

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 added in v0.6.5

func (s TrustedSigners) GoString() string

GoString returns the string representation

func (*TrustedSigners) SetEnabled added in v1.5.0

func (s *TrustedSigners) SetEnabled(v bool) *TrustedSigners

SetEnabled sets the Enabled field's value.

func (*TrustedSigners) SetItems added in v1.5.0

func (s *TrustedSigners) SetItems(v []*string) *TrustedSigners

SetItems sets the Items field's value.

func (*TrustedSigners) SetQuantity added in v1.5.0

func (s *TrustedSigners) SetQuantity(v int64) *TrustedSigners

SetQuantity sets the Quantity field's value.

func (TrustedSigners) String added in v0.6.5

func (s TrustedSigners) String() string

String returns the string representation

func (*TrustedSigners) Validate added in v1.1.21

func (s *TrustedSigners) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UntagResourceInput added in v1.4.0

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" xmlURI:"http://cloudfront.amazonaws.com/doc/2017-03-25/"`
	// contains filtered or unexported fields
}

The request to remove tags from a CloudFront resource.

func (UntagResourceInput) GoString added in v1.4.0

func (s UntagResourceInput) GoString() string

GoString returns the string representation

func (*UntagResourceInput) SetResource added in v1.5.0

func (s *UntagResourceInput) SetResource(v string) *UntagResourceInput

SetResource sets the Resource field's value.

func (*UntagResourceInput) SetTagKeys added in v1.5.0

func (s *UntagResourceInput) SetTagKeys(v *TagKeys) *UntagResourceInput

SetTagKeys sets the TagKeys field's value.

func (UntagResourceInput) String added in v1.4.0

func (s UntagResourceInput) String() string

String returns the string representation

func (*UntagResourceInput) Validate added in v1.4.0

func (s *UntagResourceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UntagResourceOutput added in v1.4.0

type UntagResourceOutput struct {
	// contains filtered or unexported fields
}

func (UntagResourceOutput) GoString added in v1.4.0

func (s UntagResourceOutput) GoString() string

GoString returns the string representation

func (UntagResourceOutput) String added in v1.4.0

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 `` /* 141-byte string literal not displayed */

	// 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 added in v0.6.5

GoString returns the string representation

func (*UpdateCloudFrontOriginAccessIdentityInput) SetCloudFrontOriginAccessIdentityConfig added in v1.5.0

SetCloudFrontOriginAccessIdentityConfig sets the CloudFrontOriginAccessIdentityConfig field's value.

func (*UpdateCloudFrontOriginAccessIdentityInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (*UpdateCloudFrontOriginAccessIdentityInput) SetIfMatch added in v1.5.0

SetIfMatch sets the IfMatch field's value.

func (UpdateCloudFrontOriginAccessIdentityInput) String added in v0.6.5

String returns the string representation

func (*UpdateCloudFrontOriginAccessIdentityInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*UpdateCloudFrontOriginAccessIdentityOutput) SetCloudFrontOriginAccessIdentity added in v1.5.0

SetCloudFrontOriginAccessIdentity sets the CloudFrontOriginAccessIdentity field's value.

func (*UpdateCloudFrontOriginAccessIdentityOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (UpdateCloudFrontOriginAccessIdentityOutput) String added in v0.6.5

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" xmlURI:"http://cloudfront.amazonaws.com/doc/2017-03-25/"`

	// 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 added in v0.6.5

func (s UpdateDistributionInput) GoString() string

GoString returns the string representation

func (*UpdateDistributionInput) SetDistributionConfig added in v1.5.0

SetDistributionConfig sets the DistributionConfig field's value.

func (*UpdateDistributionInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (*UpdateDistributionInput) SetIfMatch added in v1.5.0

SetIfMatch sets the IfMatch field's value.

func (UpdateDistributionInput) String added in v0.6.5

func (s UpdateDistributionInput) String() string

String returns the string representation

func (*UpdateDistributionInput) Validate added in v1.1.21

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 added in v0.6.5

func (s UpdateDistributionOutput) GoString() string

GoString returns the string representation

func (*UpdateDistributionOutput) SetDistribution added in v1.5.0

SetDistribution sets the Distribution field's value.

func (*UpdateDistributionOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (UpdateDistributionOutput) String added in v0.6.5

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 `` /* 132-byte string literal not displayed */
	// contains filtered or unexported fields
}

The request to update a streaming distribution.

func (UpdateStreamingDistributionInput) GoString added in v0.6.5

GoString returns the string representation

func (*UpdateStreamingDistributionInput) SetId added in v1.5.0

SetId sets the Id field's value.

func (*UpdateStreamingDistributionInput) SetIfMatch added in v1.5.0

SetIfMatch sets the IfMatch field's value.

func (*UpdateStreamingDistributionInput) SetStreamingDistributionConfig added in v1.5.0

SetStreamingDistributionConfig sets the StreamingDistributionConfig field's value.

func (UpdateStreamingDistributionInput) String added in v0.6.5

String returns the string representation

func (*UpdateStreamingDistributionInput) Validate added in v1.1.21

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 added in v0.6.5

GoString returns the string representation

func (*UpdateStreamingDistributionOutput) SetETag added in v1.5.0

SetETag sets the ETag field's value.

func (*UpdateStreamingDistributionOutput) SetStreamingDistribution added in v1.5.0

SetStreamingDistribution sets the StreamingDistribution field's value.

func (UpdateStreamingDistributionOutput) String added in v0.6.5

String returns the string representation

type ViewerCertificate

type ViewerCertificate struct {

	// For information about how and when to use ACMCertificateArn, see ViewerCertificate.
	ACMCertificateArn *string `type:"string"`

	// This field has been deprecated. Use one of the following fields instead:
	//
	//    * ViewerCertificate$ACMCertificateArn
	//
	//    * ViewerCertificate$IAMCertificateId
	//
	//    * ViewerCertificate$CloudFrontDefaultCertificate
	Certificate *string `deprecated:"true" type:"string"`

	// This field has been deprecated. Use one of the following fields instead:
	//
	//    * ViewerCertificate$ACMCertificateArn
	//
	//    * ViewerCertificate$IAMCertificateId
	//
	//    * ViewerCertificate$CloudFrontDefaultCertificate
	CertificateSource *string `deprecated:"true" type:"string" enum:"CertificateSource"`

	// For information about how and when to use CloudFrontDefaultCertificate, see
	// ViewerCertificate.
	CloudFrontDefaultCertificate *bool `type:"boolean"`

	// For information about how and when to use IAMCertificateId, see ViewerCertificate.
	IAMCertificateId *string `type:"string"`

	// Specify the security policy that you want CloudFront to use for HTTPS connections.
	// A security policy determines two settings:
	//
	//    * The minimum SSL/TLS protocol that CloudFront uses to communicate with
	//    viewers
	//
	//    * The cipher that CloudFront uses to encrypt the content that it returns
	//    to viewers
	//
	// On the CloudFront console, this setting is called Security policy.
	//
	// We recommend that you specify TLSv1.1_2016 unless your users are using browsers
	// or devices that do not support TLSv1.1 or later.
	//
	// When both of the following are true, you must specify TLSv1 or later for
	// the security policy:
	//
	//    * You're using a custom certificate: you specified a value for ACMCertificateArn
	//    or for IAMCertificateId
	//
	//    * You're using SNI: you specified sni-only for SSLSupportMethod
	//
	// If you specify true for CloudFrontDefaultCertificate, CloudFront automatically
	// sets the security policy to TLSv1 regardless of the value that you specify
	// for MinimumProtocolVersion.
	//
	// For information about the relationship between the security policy that you
	// choose and the protocols and ciphers that CloudFront uses to communicate
	// with viewers, see  Supported SSL/TLS Protocols and Ciphers for Communication
	// Between Viewers and CloudFront (http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/secure-connections-supported-viewer-protocols-ciphers.html#secure-connections-supported-ciphers)
	// in the Amazon CloudFront Developer Guide.
	MinimumProtocolVersion *string `type:"string" enum:"MinimumProtocolVersion"`

	// If you specify a value for ViewerCertificate$ACMCertificateArn or for ViewerCertificate$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 will 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.
	//
	// Don't 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:

  • 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 only one of the following values:

  • ViewerCertificate$ACMCertificateArn

  • ViewerCertificate$IAMCertificateId

  • ViewerCertificate$CloudFrontDefaultCertificate

Don't specify false for CloudFrontDefaultCertificate.

If you want viewers to use HTTP instead of HTTPS 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 (such as 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.

func (ViewerCertificate) GoString added in v0.6.5

func (s ViewerCertificate) GoString() string

GoString returns the string representation

func (*ViewerCertificate) SetACMCertificateArn added in v1.5.0

func (s *ViewerCertificate) SetACMCertificateArn(v string) *ViewerCertificate

SetACMCertificateArn sets the ACMCertificateArn field's value.

func (*ViewerCertificate) SetCertificate added in v1.5.0

func (s *ViewerCertificate) SetCertificate(v string) *ViewerCertificate

SetCertificate sets the Certificate field's value.

func (*ViewerCertificate) SetCertificateSource added in v1.5.0

func (s *ViewerCertificate) SetCertificateSource(v string) *ViewerCertificate

SetCertificateSource sets the CertificateSource field's value.

func (*ViewerCertificate) SetCloudFrontDefaultCertificate added in v1.5.0

func (s *ViewerCertificate) SetCloudFrontDefaultCertificate(v bool) *ViewerCertificate

SetCloudFrontDefaultCertificate sets the CloudFrontDefaultCertificate field's value.

func (*ViewerCertificate) SetIAMCertificateId added in v1.5.0

func (s *ViewerCertificate) SetIAMCertificateId(v string) *ViewerCertificate

SetIAMCertificateId sets the IAMCertificateId field's value.

func (*ViewerCertificate) SetMinimumProtocolVersion added in v1.5.0

func (s *ViewerCertificate) SetMinimumProtocolVersion(v string) *ViewerCertificate

SetMinimumProtocolVersion sets the MinimumProtocolVersion field's value.

func (*ViewerCertificate) SetSSLSupportMethod added in v1.5.0

func (s *ViewerCertificate) SetSSLSupportMethod(v string) *ViewerCertificate

SetSSLSupportMethod sets the SSLSupportMethod field's value.

func (ViewerCertificate) String added in v0.6.5

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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL