package cloudfront
import "github.com/aws/aws-sdk-go-v2/service/cloudfront"
Package cloudfront provides the API client, operations, and parameter types for Amazon CloudFront.
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.
Index ¶
- Constants
- func NewDefaultEndpointResolver() *internalendpoints.Resolver
- type Client
- func New(options Options, optFns ...func(*Options)) *Client
- func NewFromConfig(cfg aws.Config, optFns ...func(*Options)) *Client
- func (c *Client) CreateCachePolicy(ctx context.Context, params *CreateCachePolicyInput, optFns ...func(*Options)) (*CreateCachePolicyOutput, error)
- func (c *Client) CreateCloudFrontOriginAccessIdentity(ctx context.Context, params *CreateCloudFrontOriginAccessIdentityInput, optFns ...func(*Options)) (*CreateCloudFrontOriginAccessIdentityOutput, error)
- func (c *Client) CreateDistribution(ctx context.Context, params *CreateDistributionInput, optFns ...func(*Options)) (*CreateDistributionOutput, error)
- func (c *Client) CreateDistributionWithTags(ctx context.Context, params *CreateDistributionWithTagsInput, optFns ...func(*Options)) (*CreateDistributionWithTagsOutput, error)
- func (c *Client) CreateFieldLevelEncryptionConfig(ctx context.Context, params *CreateFieldLevelEncryptionConfigInput, optFns ...func(*Options)) (*CreateFieldLevelEncryptionConfigOutput, error)
- func (c *Client) CreateFieldLevelEncryptionProfile(ctx context.Context, params *CreateFieldLevelEncryptionProfileInput, optFns ...func(*Options)) (*CreateFieldLevelEncryptionProfileOutput, error)
- func (c *Client) CreateInvalidation(ctx context.Context, params *CreateInvalidationInput, optFns ...func(*Options)) (*CreateInvalidationOutput, error)
- func (c *Client) CreateOriginRequestPolicy(ctx context.Context, params *CreateOriginRequestPolicyInput, optFns ...func(*Options)) (*CreateOriginRequestPolicyOutput, error)
- func (c *Client) CreatePublicKey(ctx context.Context, params *CreatePublicKeyInput, optFns ...func(*Options)) (*CreatePublicKeyOutput, error)
- func (c *Client) CreateStreamingDistribution(ctx context.Context, params *CreateStreamingDistributionInput, optFns ...func(*Options)) (*CreateStreamingDistributionOutput, error)
- func (c *Client) CreateStreamingDistributionWithTags(ctx context.Context, params *CreateStreamingDistributionWithTagsInput, optFns ...func(*Options)) (*CreateStreamingDistributionWithTagsOutput, error)
- func (c *Client) DeleteCachePolicy(ctx context.Context, params *DeleteCachePolicyInput, optFns ...func(*Options)) (*DeleteCachePolicyOutput, error)
- func (c *Client) DeleteCloudFrontOriginAccessIdentity(ctx context.Context, params *DeleteCloudFrontOriginAccessIdentityInput, optFns ...func(*Options)) (*DeleteCloudFrontOriginAccessIdentityOutput, error)
- func (c *Client) DeleteDistribution(ctx context.Context, params *DeleteDistributionInput, optFns ...func(*Options)) (*DeleteDistributionOutput, error)
- func (c *Client) DeleteFieldLevelEncryptionConfig(ctx context.Context, params *DeleteFieldLevelEncryptionConfigInput, optFns ...func(*Options)) (*DeleteFieldLevelEncryptionConfigOutput, error)
- func (c *Client) DeleteFieldLevelEncryptionProfile(ctx context.Context, params *DeleteFieldLevelEncryptionProfileInput, optFns ...func(*Options)) (*DeleteFieldLevelEncryptionProfileOutput, error)
- func (c *Client) DeleteOriginRequestPolicy(ctx context.Context, params *DeleteOriginRequestPolicyInput, optFns ...func(*Options)) (*DeleteOriginRequestPolicyOutput, error)
- func (c *Client) DeletePublicKey(ctx context.Context, params *DeletePublicKeyInput, optFns ...func(*Options)) (*DeletePublicKeyOutput, error)
- func (c *Client) DeleteStreamingDistribution(ctx context.Context, params *DeleteStreamingDistributionInput, optFns ...func(*Options)) (*DeleteStreamingDistributionOutput, error)
- func (c *Client) GetCachePolicy(ctx context.Context, params *GetCachePolicyInput, optFns ...func(*Options)) (*GetCachePolicyOutput, error)
- func (c *Client) GetCachePolicyConfig(ctx context.Context, params *GetCachePolicyConfigInput, optFns ...func(*Options)) (*GetCachePolicyConfigOutput, error)
- func (c *Client) GetCloudFrontOriginAccessIdentity(ctx context.Context, params *GetCloudFrontOriginAccessIdentityInput, optFns ...func(*Options)) (*GetCloudFrontOriginAccessIdentityOutput, error)
- func (c *Client) GetCloudFrontOriginAccessIdentityConfig(ctx context.Context, params *GetCloudFrontOriginAccessIdentityConfigInput, optFns ...func(*Options)) (*GetCloudFrontOriginAccessIdentityConfigOutput, error)
- func (c *Client) GetDistribution(ctx context.Context, params *GetDistributionInput, optFns ...func(*Options)) (*GetDistributionOutput, error)
- func (c *Client) GetDistributionConfig(ctx context.Context, params *GetDistributionConfigInput, optFns ...func(*Options)) (*GetDistributionConfigOutput, error)
- func (c *Client) GetFieldLevelEncryption(ctx context.Context, params *GetFieldLevelEncryptionInput, optFns ...func(*Options)) (*GetFieldLevelEncryptionOutput, error)
- func (c *Client) GetFieldLevelEncryptionConfig(ctx context.Context, params *GetFieldLevelEncryptionConfigInput, optFns ...func(*Options)) (*GetFieldLevelEncryptionConfigOutput, error)
- func (c *Client) GetFieldLevelEncryptionProfile(ctx context.Context, params *GetFieldLevelEncryptionProfileInput, optFns ...func(*Options)) (*GetFieldLevelEncryptionProfileOutput, error)
- func (c *Client) GetFieldLevelEncryptionProfileConfig(ctx context.Context, params *GetFieldLevelEncryptionProfileConfigInput, optFns ...func(*Options)) (*GetFieldLevelEncryptionProfileConfigOutput, error)
- func (c *Client) GetInvalidation(ctx context.Context, params *GetInvalidationInput, optFns ...func(*Options)) (*GetInvalidationOutput, error)
- func (c *Client) GetOriginRequestPolicy(ctx context.Context, params *GetOriginRequestPolicyInput, optFns ...func(*Options)) (*GetOriginRequestPolicyOutput, error)
- func (c *Client) GetOriginRequestPolicyConfig(ctx context.Context, params *GetOriginRequestPolicyConfigInput, optFns ...func(*Options)) (*GetOriginRequestPolicyConfigOutput, error)
- func (c *Client) GetPublicKey(ctx context.Context, params *GetPublicKeyInput, optFns ...func(*Options)) (*GetPublicKeyOutput, error)
- func (c *Client) GetPublicKeyConfig(ctx context.Context, params *GetPublicKeyConfigInput, optFns ...func(*Options)) (*GetPublicKeyConfigOutput, error)
- func (c *Client) GetStreamingDistribution(ctx context.Context, params *GetStreamingDistributionInput, optFns ...func(*Options)) (*GetStreamingDistributionOutput, error)
- func (c *Client) GetStreamingDistributionConfig(ctx context.Context, params *GetStreamingDistributionConfigInput, optFns ...func(*Options)) (*GetStreamingDistributionConfigOutput, error)
- func (c *Client) ListCachePolicies(ctx context.Context, params *ListCachePoliciesInput, optFns ...func(*Options)) (*ListCachePoliciesOutput, error)
- func (c *Client) ListCloudFrontOriginAccessIdentities(ctx context.Context, params *ListCloudFrontOriginAccessIdentitiesInput, optFns ...func(*Options)) (*ListCloudFrontOriginAccessIdentitiesOutput, error)
- func (c *Client) ListDistributions(ctx context.Context, params *ListDistributionsInput, optFns ...func(*Options)) (*ListDistributionsOutput, error)
- func (c *Client) ListDistributionsByCachePolicyId(ctx context.Context, params *ListDistributionsByCachePolicyIdInput, optFns ...func(*Options)) (*ListDistributionsByCachePolicyIdOutput, error)
- func (c *Client) ListDistributionsByOriginRequestPolicyId(ctx context.Context, params *ListDistributionsByOriginRequestPolicyIdInput, optFns ...func(*Options)) (*ListDistributionsByOriginRequestPolicyIdOutput, error)
- func (c *Client) ListDistributionsByWebACLId(ctx context.Context, params *ListDistributionsByWebACLIdInput, optFns ...func(*Options)) (*ListDistributionsByWebACLIdOutput, error)
- func (c *Client) ListFieldLevelEncryptionConfigs(ctx context.Context, params *ListFieldLevelEncryptionConfigsInput, optFns ...func(*Options)) (*ListFieldLevelEncryptionConfigsOutput, error)
- func (c *Client) ListFieldLevelEncryptionProfiles(ctx context.Context, params *ListFieldLevelEncryptionProfilesInput, optFns ...func(*Options)) (*ListFieldLevelEncryptionProfilesOutput, error)
- func (c *Client) ListInvalidations(ctx context.Context, params *ListInvalidationsInput, optFns ...func(*Options)) (*ListInvalidationsOutput, error)
- func (c *Client) ListOriginRequestPolicies(ctx context.Context, params *ListOriginRequestPoliciesInput, optFns ...func(*Options)) (*ListOriginRequestPoliciesOutput, error)
- func (c *Client) ListPublicKeys(ctx context.Context, params *ListPublicKeysInput, optFns ...func(*Options)) (*ListPublicKeysOutput, error)
- func (c *Client) ListStreamingDistributions(ctx context.Context, params *ListStreamingDistributionsInput, optFns ...func(*Options)) (*ListStreamingDistributionsOutput, error)
- func (c *Client) ListTagsForResource(ctx context.Context, params *ListTagsForResourceInput, optFns ...func(*Options)) (*ListTagsForResourceOutput, error)
- func (c *Client) TagResource(ctx context.Context, params *TagResourceInput, optFns ...func(*Options)) (*TagResourceOutput, error)
- func (c *Client) UntagResource(ctx context.Context, params *UntagResourceInput, optFns ...func(*Options)) (*UntagResourceOutput, error)
- func (c *Client) UpdateCachePolicy(ctx context.Context, params *UpdateCachePolicyInput, optFns ...func(*Options)) (*UpdateCachePolicyOutput, error)
- func (c *Client) UpdateCloudFrontOriginAccessIdentity(ctx context.Context, params *UpdateCloudFrontOriginAccessIdentityInput, optFns ...func(*Options)) (*UpdateCloudFrontOriginAccessIdentityOutput, error)
- func (c *Client) UpdateDistribution(ctx context.Context, params *UpdateDistributionInput, optFns ...func(*Options)) (*UpdateDistributionOutput, error)
- func (c *Client) UpdateFieldLevelEncryptionConfig(ctx context.Context, params *UpdateFieldLevelEncryptionConfigInput, optFns ...func(*Options)) (*UpdateFieldLevelEncryptionConfigOutput, error)
- func (c *Client) UpdateFieldLevelEncryptionProfile(ctx context.Context, params *UpdateFieldLevelEncryptionProfileInput, optFns ...func(*Options)) (*UpdateFieldLevelEncryptionProfileOutput, error)
- func (c *Client) UpdateOriginRequestPolicy(ctx context.Context, params *UpdateOriginRequestPolicyInput, optFns ...func(*Options)) (*UpdateOriginRequestPolicyOutput, error)
- func (c *Client) UpdatePublicKey(ctx context.Context, params *UpdatePublicKeyInput, optFns ...func(*Options)) (*UpdatePublicKeyOutput, error)
- func (c *Client) UpdateStreamingDistribution(ctx context.Context, params *UpdateStreamingDistributionInput, optFns ...func(*Options)) (*UpdateStreamingDistributionOutput, error)
- type CreateCachePolicyInput
- type CreateCachePolicyOutput
- type CreateCloudFrontOriginAccessIdentityInput
- type CreateCloudFrontOriginAccessIdentityOutput
- type CreateDistributionInput
- type CreateDistributionOutput
- type CreateDistributionWithTagsInput
- type CreateDistributionWithTagsOutput
- type CreateFieldLevelEncryptionConfigInput
- type CreateFieldLevelEncryptionConfigOutput
- type CreateFieldLevelEncryptionProfileInput
- type CreateFieldLevelEncryptionProfileOutput
- type CreateInvalidationInput
- type CreateInvalidationOutput
- type CreateOriginRequestPolicyInput
- type CreateOriginRequestPolicyOutput
- type CreatePublicKeyInput
- type CreatePublicKeyOutput
- type CreateStreamingDistributionInput
- type CreateStreamingDistributionOutput
- type CreateStreamingDistributionWithTagsInput
- type CreateStreamingDistributionWithTagsOutput
- type DeleteCachePolicyInput
- type DeleteCachePolicyOutput
- type DeleteCloudFrontOriginAccessIdentityInput
- type DeleteCloudFrontOriginAccessIdentityOutput
- type DeleteDistributionInput
- type DeleteDistributionOutput
- type DeleteFieldLevelEncryptionConfigInput
- type DeleteFieldLevelEncryptionConfigOutput
- type DeleteFieldLevelEncryptionProfileInput
- type DeleteFieldLevelEncryptionProfileOutput
- type DeleteOriginRequestPolicyInput
- type DeleteOriginRequestPolicyOutput
- type DeletePublicKeyInput
- type DeletePublicKeyOutput
- type DeleteStreamingDistributionInput
- type DeleteStreamingDistributionOutput
- type EndpointResolver
- type EndpointResolverFunc
- type GetCachePolicyConfigInput
- type GetCachePolicyConfigOutput
- type GetCachePolicyInput
- type GetCachePolicyOutput
- type GetCloudFrontOriginAccessIdentityConfigInput
- type GetCloudFrontOriginAccessIdentityConfigOutput
- type GetCloudFrontOriginAccessIdentityInput
- type GetCloudFrontOriginAccessIdentityOutput
- type GetDistributionConfigInput
- type GetDistributionConfigOutput
- type GetDistributionInput
- type GetDistributionOutput
- type GetFieldLevelEncryptionConfigInput
- type GetFieldLevelEncryptionConfigOutput
- type GetFieldLevelEncryptionInput
- type GetFieldLevelEncryptionOutput
- type GetFieldLevelEncryptionProfileConfigInput
- type GetFieldLevelEncryptionProfileConfigOutput
- type GetFieldLevelEncryptionProfileInput
- type GetFieldLevelEncryptionProfileOutput
- type GetInvalidationInput
- type GetInvalidationOutput
- type GetOriginRequestPolicyConfigInput
- type GetOriginRequestPolicyConfigOutput
- type GetOriginRequestPolicyInput
- type GetOriginRequestPolicyOutput
- type GetPublicKeyConfigInput
- type GetPublicKeyConfigOutput
- type GetPublicKeyInput
- type GetPublicKeyOutput
- type GetStreamingDistributionConfigInput
- type GetStreamingDistributionConfigOutput
- type GetStreamingDistributionInput
- type GetStreamingDistributionOutput
- type HTTPClient
- type HTTPSignerV4
- type ListCachePoliciesInput
- type ListCachePoliciesOutput
- type ListCloudFrontOriginAccessIdentitiesInput
- type ListCloudFrontOriginAccessIdentitiesOutput
- type ListDistributionsByCachePolicyIdInput
- type ListDistributionsByCachePolicyIdOutput
- type ListDistributionsByOriginRequestPolicyIdInput
- type ListDistributionsByOriginRequestPolicyIdOutput
- type ListDistributionsByWebACLIdInput
- type ListDistributionsByWebACLIdOutput
- type ListDistributionsInput
- type ListDistributionsOutput
- type ListFieldLevelEncryptionConfigsInput
- type ListFieldLevelEncryptionConfigsOutput
- type ListFieldLevelEncryptionProfilesInput
- type ListFieldLevelEncryptionProfilesOutput
- type ListInvalidationsInput
- type ListInvalidationsOutput
- type ListOriginRequestPoliciesInput
- type ListOriginRequestPoliciesOutput
- type ListPublicKeysInput
- type ListPublicKeysOutput
- type ListStreamingDistributionsInput
- type ListStreamingDistributionsOutput
- type ListTagsForResourceInput
- type ListTagsForResourceOutput
- type Options
- type ResolveEndpoint
- func (m *ResolveEndpoint) HandleSerialize(ctx context.Context, in middleware.SerializeInput, next middleware.SerializeHandler) ( out middleware.SerializeOutput, metadata middleware.Metadata, err error, )
- func (*ResolveEndpoint) ID() string
- type ResolverOptions
- type TagResourceInput
- type TagResourceOutput
- type UntagResourceInput
- type UntagResourceOutput
- type UpdateCachePolicyInput
- type UpdateCachePolicyOutput
- type UpdateCloudFrontOriginAccessIdentityInput
- type UpdateCloudFrontOriginAccessIdentityOutput
- type UpdateDistributionInput
- type UpdateDistributionOutput
- type UpdateFieldLevelEncryptionConfigInput
- type UpdateFieldLevelEncryptionConfigOutput
- type UpdateFieldLevelEncryptionProfileInput
- type UpdateFieldLevelEncryptionProfileOutput
- type UpdateOriginRequestPolicyInput
- type UpdateOriginRequestPolicyOutput
- type UpdatePublicKeyInput
- type UpdatePublicKeyOutput
- type UpdateStreamingDistributionInput
- type UpdateStreamingDistributionOutput
Constants ¶
const ServiceAPIVersion = "2020-05-31"
const ServiceID = "CloudFront"
Functions ¶
func NewDefaultEndpointResolver ¶
func NewDefaultEndpointResolver() *internalendpoints.Resolver
NewDefaultEndpointResolver constructs a new service endpoint resolver
Types ¶
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
Client provides the API client to make operations call for Amazon CloudFront.
func New ¶
New returns an initialized Client based on the functional options. Provide additional functional options to further configure the behavior of the client, such as changing the client's endpoint or adding custom middleware behavior.
func NewFromConfig ¶
NewFromConfig returns a new client from the provided config.
func (*Client) CreateCachePolicy ¶
func (c *Client) CreateCachePolicy(ctx context.Context, params *CreateCachePolicyInput, optFns ...func(*Options)) (*CreateCachePolicyOutput, error)
Creates a cache policy. After you create a cache policy, you can attach it to one or more cache behaviors. When it’s attached to a cache behavior, the cache policy determines the following:
- The values that CloudFront includes in
the cache key. These values can include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to find an object in its cache that it can return to the viewer.
- The default, minimum, and maximum time to live
(TTL) values that you want objects to stay in the CloudFront cache.
The headers, cookies, and query strings that are included in the cache key are automatically included in requests that CloudFront sends to the origin. CloudFront sends a request when it can’t find an object in its cache that matches the request’s cache key. If you want to send values to the origin but not include them in the cache key, use CreateOriginRequestPolicy. For more information about cache policies, see Controlling the cache key (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html) in the Amazon CloudFront Developer Guide.
func (*Client) CreateCloudFrontOriginAccessIdentity ¶
func (c *Client) CreateCloudFrontOriginAccessIdentity(ctx context.Context, params *CreateCloudFrontOriginAccessIdentityInput, optFns ...func(*Options)) (*CreateCloudFrontOriginAccessIdentityOutput, error)
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 (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html) in the Amazon CloudFront Developer Guide.
func (*Client) CreateDistribution ¶
func (c *Client) CreateDistribution(ctx context.Context, params *CreateDistributionInput, optFns ...func(*Options)) (*CreateDistributionOutput, error)
Creates a new web distribution. You create a CloudFront distribution to tell CloudFront where you want content to be delivered from, and the details about how to track and manage content delivery. Send a POST request to the /CloudFront API version/distribution/distribution ID resource. When you update a distribution, there are more required fields than when you create a distribution. When you update your distribution by using UpdateDistribution (https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html), follow the steps included in the documentation to get the current configuration and then make your updates. This helps to make sure that you include all of the required fields. To view a summary, see Required Fields for Create Distribution and Update Distribution (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-overview-required-fields.html) in the Amazon CloudFront Developer Guide.
func (*Client) CreateDistributionWithTags ¶
func (c *Client) CreateDistributionWithTags(ctx context.Context, params *CreateDistributionWithTagsInput, optFns ...func(*Options)) (*CreateDistributionWithTagsOutput, error)
Create a new distribution with tags.
func (*Client) CreateFieldLevelEncryptionConfig ¶
func (c *Client) CreateFieldLevelEncryptionConfig(ctx context.Context, params *CreateFieldLevelEncryptionConfigInput, optFns ...func(*Options)) (*CreateFieldLevelEncryptionConfigOutput, error)
Create a new field-level encryption configuration.
func (*Client) CreateFieldLevelEncryptionProfile ¶
func (c *Client) CreateFieldLevelEncryptionProfile(ctx context.Context, params *CreateFieldLevelEncryptionProfileInput, optFns ...func(*Options)) (*CreateFieldLevelEncryptionProfileOutput, error)
Create a field-level encryption profile.
func (*Client) CreateInvalidation ¶
func (c *Client) CreateInvalidation(ctx context.Context, params *CreateInvalidationInput, optFns ...func(*Options)) (*CreateInvalidationOutput, error)
Create a new invalidation.
func (*Client) CreateOriginRequestPolicy ¶
func (c *Client) CreateOriginRequestPolicy(ctx context.Context, params *CreateOriginRequestPolicyInput, optFns ...func(*Options)) (*CreateOriginRequestPolicyOutput, error)
Creates an origin request policy. After you create an origin request policy, you can attach it to one or more cache behaviors. When it’s attached to a cache behavior, the origin request policy determines the values that CloudFront includes in requests that it sends to the origin. Each request that CloudFront sends to the origin includes the following:
- The request body and the URL
path (without the domain name) from the viewer request.
- The headers that
CloudFront automatically includes in every origin request, including Host, User-Agent, and X-Amz-Cf-Id.
- All HTTP headers, cookies, and URL query
strings that are specified in the cache policy or the origin request policy. These can include items from the viewer request and, in the case of headers, additional ones that are added by CloudFront.
CloudFront sends a request when it can’t find a valid object in its cache that matches the request. If you want to send values to the origin and also include them in the cache key, use CreateCachePolicy. For more information about origin request policies, see Controlling origin requests (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-origin-requests.html) in the Amazon CloudFront Developer Guide.
func (*Client) CreatePublicKey ¶
func (c *Client) CreatePublicKey(ctx context.Context, params *CreatePublicKeyInput, optFns ...func(*Options)) (*CreatePublicKeyOutput, error)
Add a new public key to CloudFront to use, for example, for field-level encryption. You can add a maximum of 10 public keys with one AWS account.
func (*Client) CreateStreamingDistribution ¶
func (c *Client) CreateStreamingDistribution(ctx context.Context, params *CreateStreamingDistributionInput, optFns ...func(*Options)) (*CreateStreamingDistributionOutput, error)
Creates a new RTMP 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 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 (https://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.
func (*Client) CreateStreamingDistributionWithTags ¶
func (c *Client) CreateStreamingDistributionWithTags(ctx context.Context, params *CreateStreamingDistributionWithTagsInput, optFns ...func(*Options)) (*CreateStreamingDistributionWithTagsOutput, error)
Create a new streaming distribution with tags.
func (*Client) DeleteCachePolicy ¶
func (c *Client) DeleteCachePolicy(ctx context.Context, params *DeleteCachePolicyInput, optFns ...func(*Options)) (*DeleteCachePolicyOutput, error)
Deletes a cache policy. You cannot delete a cache policy if it’s attached to a cache behavior. First update your distributions to remove the cache policy from all cache behaviors, then delete the cache policy. To delete a cache policy, you must provide the policy’s identifier and version. To get these values, you can use ListCachePolicies or GetCachePolicy.
func (*Client) DeleteCloudFrontOriginAccessIdentity ¶
func (c *Client) DeleteCloudFrontOriginAccessIdentity(ctx context.Context, params *DeleteCloudFrontOriginAccessIdentityInput, optFns ...func(*Options)) (*DeleteCloudFrontOriginAccessIdentityOutput, error)
Delete an origin access identity.
func (*Client) DeleteDistribution ¶
func (c *Client) DeleteDistribution(ctx context.Context, params *DeleteDistributionInput, optFns ...func(*Options)) (*DeleteDistributionOutput, error)
Delete a distribution.
func (*Client) DeleteFieldLevelEncryptionConfig ¶
func (c *Client) DeleteFieldLevelEncryptionConfig(ctx context.Context, params *DeleteFieldLevelEncryptionConfigInput, optFns ...func(*Options)) (*DeleteFieldLevelEncryptionConfigOutput, error)
Remove a field-level encryption configuration.
func (*Client) DeleteFieldLevelEncryptionProfile ¶
func (c *Client) DeleteFieldLevelEncryptionProfile(ctx context.Context, params *DeleteFieldLevelEncryptionProfileInput, optFns ...func(*Options)) (*DeleteFieldLevelEncryptionProfileOutput, error)
Remove a field-level encryption profile.
func (*Client) DeleteOriginRequestPolicy ¶
func (c *Client) DeleteOriginRequestPolicy(ctx context.Context, params *DeleteOriginRequestPolicyInput, optFns ...func(*Options)) (*DeleteOriginRequestPolicyOutput, error)
Deletes an origin request policy. You cannot delete an origin request policy if it’s attached to any cache behaviors. First update your distributions to remove the origin request policy from all cache behaviors, then delete the origin request policy. To delete an origin request policy, you must provide the policy’s identifier and version. To get the identifier, you can use ListOriginRequestPolicies or GetOriginRequestPolicy.
func (*Client) DeletePublicKey ¶
func (c *Client) DeletePublicKey(ctx context.Context, params *DeletePublicKeyInput, optFns ...func(*Options)) (*DeletePublicKeyOutput, error)
Remove a public key you previously added to CloudFront.
func (*Client) DeleteStreamingDistribution ¶
func (c *Client) DeleteStreamingDistribution(ctx context.Context, params *DeleteStreamingDistributionInput, optFns ...func(*Options)) (*DeleteStreamingDistributionOutput, error)
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 (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/HowToDeleteDistribution.html) in the Amazon CloudFront Developer Guide.
func (*Client) GetCachePolicy ¶
func (c *Client) GetCachePolicy(ctx context.Context, params *GetCachePolicyInput, optFns ...func(*Options)) (*GetCachePolicyOutput, error)
Gets a cache policy, including the following metadata:
- The policy’s
identifier.
- The date and time when the policy was last modified.
To get a cache policy, you must provide the policy’s identifier. If the cache policy is attached to a distribution’s cache behavior, you can get the policy’s identifier using ListDistributions or GetDistribution. If the cache policy is not attached to a cache behavior, you can get the identifier using ListCachePolicies.
func (*Client) GetCachePolicyConfig ¶
func (c *Client) GetCachePolicyConfig(ctx context.Context, params *GetCachePolicyConfigInput, optFns ...func(*Options)) (*GetCachePolicyConfigOutput, error)
Gets a cache policy configuration. To get a cache policy configuration, you must provide the policy’s identifier. If the cache policy is attached to a distribution’s cache behavior, you can get the policy’s identifier using ListDistributions or GetDistribution. If the cache policy is not attached to a cache behavior, you can get the identifier using ListCachePolicies.
func (*Client) GetCloudFrontOriginAccessIdentity ¶
func (c *Client) GetCloudFrontOriginAccessIdentity(ctx context.Context, params *GetCloudFrontOriginAccessIdentityInput, optFns ...func(*Options)) (*GetCloudFrontOriginAccessIdentityOutput, error)
Get the information about an origin access identity.
func (*Client) GetCloudFrontOriginAccessIdentityConfig ¶
func (c *Client) GetCloudFrontOriginAccessIdentityConfig(ctx context.Context, params *GetCloudFrontOriginAccessIdentityConfigInput, optFns ...func(*Options)) (*GetCloudFrontOriginAccessIdentityConfigOutput, error)
Get the configuration information about an origin access identity.
func (*Client) GetDistribution ¶
func (c *Client) GetDistribution(ctx context.Context, params *GetDistributionInput, optFns ...func(*Options)) (*GetDistributionOutput, error)
Get the information about a distribution.
func (*Client) GetDistributionConfig ¶
func (c *Client) GetDistributionConfig(ctx context.Context, params *GetDistributionConfigInput, optFns ...func(*Options)) (*GetDistributionConfigOutput, error)
Get the configuration information about a distribution.
func (*Client) GetFieldLevelEncryption ¶
func (c *Client) GetFieldLevelEncryption(ctx context.Context, params *GetFieldLevelEncryptionInput, optFns ...func(*Options)) (*GetFieldLevelEncryptionOutput, error)
Get the field-level encryption configuration information.
func (*Client) GetFieldLevelEncryptionConfig ¶
func (c *Client) GetFieldLevelEncryptionConfig(ctx context.Context, params *GetFieldLevelEncryptionConfigInput, optFns ...func(*Options)) (*GetFieldLevelEncryptionConfigOutput, error)
Get the field-level encryption configuration information.
func (*Client) GetFieldLevelEncryptionProfile ¶
func (c *Client) GetFieldLevelEncryptionProfile(ctx context.Context, params *GetFieldLevelEncryptionProfileInput, optFns ...func(*Options)) (*GetFieldLevelEncryptionProfileOutput, error)
Get the field-level encryption profile information.
func (*Client) GetFieldLevelEncryptionProfileConfig ¶
func (c *Client) GetFieldLevelEncryptionProfileConfig(ctx context.Context, params *GetFieldLevelEncryptionProfileConfigInput, optFns ...func(*Options)) (*GetFieldLevelEncryptionProfileConfigOutput, error)
Get the field-level encryption profile configuration information.
func (*Client) GetInvalidation ¶
func (c *Client) GetInvalidation(ctx context.Context, params *GetInvalidationInput, optFns ...func(*Options)) (*GetInvalidationOutput, error)
Get the information about an invalidation.
func (*Client) GetOriginRequestPolicy ¶
func (c *Client) GetOriginRequestPolicy(ctx context.Context, params *GetOriginRequestPolicyInput, optFns ...func(*Options)) (*GetOriginRequestPolicyOutput, error)
Gets an origin request policy, including the following metadata:
- The
policy’s identifier.
- The date and time when the policy was last
modified.
To get an origin request policy, you must provide the policy’s identifier. If the origin request policy is attached to a distribution’s cache behavior, you can get the policy’s identifier using ListDistributions or GetDistribution. If the origin request policy is not attached to a cache behavior, you can get the identifier using ListOriginRequestPolicies.
func (*Client) GetOriginRequestPolicyConfig ¶
func (c *Client) GetOriginRequestPolicyConfig(ctx context.Context, params *GetOriginRequestPolicyConfigInput, optFns ...func(*Options)) (*GetOriginRequestPolicyConfigOutput, error)
Gets an origin request policy configuration. To get an origin request policy configuration, you must provide the policy’s identifier. If the origin request policy is attached to a distribution’s cache behavior, you can get the policy’s identifier using ListDistributions or GetDistribution. If the origin request policy is not attached to a cache behavior, you can get the identifier using ListOriginRequestPolicies.
func (*Client) GetPublicKey ¶
func (c *Client) GetPublicKey(ctx context.Context, params *GetPublicKeyInput, optFns ...func(*Options)) (*GetPublicKeyOutput, error)
Get the public key information.
func (*Client) GetPublicKeyConfig ¶
func (c *Client) GetPublicKeyConfig(ctx context.Context, params *GetPublicKeyConfigInput, optFns ...func(*Options)) (*GetPublicKeyConfigOutput, error)
Return public key configuration informaation
func (*Client) GetStreamingDistribution ¶
func (c *Client) GetStreamingDistribution(ctx context.Context, params *GetStreamingDistributionInput, optFns ...func(*Options)) (*GetStreamingDistributionOutput, error)
Gets information about a specified RTMP distribution, including the distribution configuration.
func (*Client) GetStreamingDistributionConfig ¶
func (c *Client) GetStreamingDistributionConfig(ctx context.Context, params *GetStreamingDistributionConfigInput, optFns ...func(*Options)) (*GetStreamingDistributionConfigOutput, error)
Get the configuration information about a streaming distribution.
func (*Client) ListCachePolicies ¶
func (c *Client) ListCachePolicies(ctx context.Context, params *ListCachePoliciesInput, optFns ...func(*Options)) (*ListCachePoliciesOutput, error)
Gets a list of cache policies. You can optionally apply a filter to return only the managed policies created by AWS, or only the custom policies created in your AWS account. You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.
func (*Client) ListCloudFrontOriginAccessIdentities ¶
func (c *Client) ListCloudFrontOriginAccessIdentities(ctx context.Context, params *ListCloudFrontOriginAccessIdentitiesInput, optFns ...func(*Options)) (*ListCloudFrontOriginAccessIdentitiesOutput, error)
Lists origin access identities.
func (*Client) ListDistributions ¶
func (c *Client) ListDistributions(ctx context.Context, params *ListDistributionsInput, optFns ...func(*Options)) (*ListDistributionsOutput, error)
List CloudFront distributions.
func (*Client) ListDistributionsByCachePolicyId ¶
func (c *Client) ListDistributionsByCachePolicyId(ctx context.Context, params *ListDistributionsByCachePolicyIdInput, optFns ...func(*Options)) (*ListDistributionsByCachePolicyIdOutput, error)
Gets a list of distribution IDs for distributions that have a cache behavior that’s associated with the specified cache policy. You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.
func (*Client) ListDistributionsByOriginRequestPolicyId ¶
func (c *Client) ListDistributionsByOriginRequestPolicyId(ctx context.Context, params *ListDistributionsByOriginRequestPolicyIdInput, optFns ...func(*Options)) (*ListDistributionsByOriginRequestPolicyIdOutput, error)
Gets a list of distribution IDs for distributions that have a cache behavior that’s associated with the specified origin request policy. You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.
func (*Client) ListDistributionsByWebACLId ¶
func (c *Client) ListDistributionsByWebACLId(ctx context.Context, params *ListDistributionsByWebACLIdInput, optFns ...func(*Options)) (*ListDistributionsByWebACLIdOutput, error)
List the distributions that are associated with a specified AWS WAF web ACL.
func (*Client) ListFieldLevelEncryptionConfigs ¶
func (c *Client) ListFieldLevelEncryptionConfigs(ctx context.Context, params *ListFieldLevelEncryptionConfigsInput, optFns ...func(*Options)) (*ListFieldLevelEncryptionConfigsOutput, error)
List all field-level encryption configurations that have been created in CloudFront for this account.
func (*Client) ListFieldLevelEncryptionProfiles ¶
func (c *Client) ListFieldLevelEncryptionProfiles(ctx context.Context, params *ListFieldLevelEncryptionProfilesInput, optFns ...func(*Options)) (*ListFieldLevelEncryptionProfilesOutput, error)
Request a list of field-level encryption profiles that have been created in CloudFront for this account.
func (*Client) ListInvalidations ¶
func (c *Client) ListInvalidations(ctx context.Context, params *ListInvalidationsInput, optFns ...func(*Options)) (*ListInvalidationsOutput, error)
Lists invalidation batches.
func (*Client) ListOriginRequestPolicies ¶
func (c *Client) ListOriginRequestPolicies(ctx context.Context, params *ListOriginRequestPoliciesInput, optFns ...func(*Options)) (*ListOriginRequestPoliciesOutput, error)
Gets a list of origin request policies. You can optionally apply a filter to return only the managed policies created by AWS, or only the custom policies created in your AWS account. You can optionally specify the maximum number of items to receive in the response. If the total number of items in the list exceeds the maximum that you specify, or the default maximum, the response is paginated. To get the next page of items, send a subsequent request that specifies the NextMarker value from the current response as the Marker value in the subsequent request.
func (*Client) ListPublicKeys ¶
func (c *Client) ListPublicKeys(ctx context.Context, params *ListPublicKeysInput, optFns ...func(*Options)) (*ListPublicKeysOutput, error)
List all public keys that have been added to CloudFront for this account.
func (*Client) ListStreamingDistributions ¶
func (c *Client) ListStreamingDistributions(ctx context.Context, params *ListStreamingDistributionsInput, optFns ...func(*Options)) (*ListStreamingDistributionsOutput, error)
List streaming distributions.
func (*Client) ListTagsForResource ¶
func (c *Client) ListTagsForResource(ctx context.Context, params *ListTagsForResourceInput, optFns ...func(*Options)) (*ListTagsForResourceOutput, error)
List tags for a CloudFront resource.
func (*Client) TagResource ¶
func (c *Client) TagResource(ctx context.Context, params *TagResourceInput, optFns ...func(*Options)) (*TagResourceOutput, error)
Add tags to a CloudFront resource.
func (*Client) UntagResource ¶
func (c *Client) UntagResource(ctx context.Context, params *UntagResourceInput, optFns ...func(*Options)) (*UntagResourceOutput, error)
Remove tags from a CloudFront resource.
func (*Client) UpdateCachePolicy ¶
func (c *Client) UpdateCachePolicy(ctx context.Context, params *UpdateCachePolicyInput, optFns ...func(*Options)) (*UpdateCachePolicyOutput, error)
Updates a cache policy configuration. When you update a cache policy configuration, all the fields are updated with the values provided in the request. You cannot update some fields independent of others. To update a cache policy configuration:
- Use GetCachePolicyConfig to get the current
configuration.
- Locally modify the fields in the cache policy
configuration that you want to update.
- Call UpdateCachePolicy by
providing the entire cache policy configuration, including the fields that you modified and those that you didn’t.
func (*Client) UpdateCloudFrontOriginAccessIdentity ¶
func (c *Client) UpdateCloudFrontOriginAccessIdentity(ctx context.Context, params *UpdateCloudFrontOriginAccessIdentityInput, optFns ...func(*Options)) (*UpdateCloudFrontOriginAccessIdentityOutput, error)
Update an origin access identity.
func (*Client) UpdateDistribution ¶
func (c *Client) UpdateDistribution(ctx context.Context, params *UpdateDistributionInput, optFns ...func(*Options)) (*UpdateDistributionOutput, error)
Updates the configuration for a web distribution. When you update a distribution, there are more required fields than when you create a distribution. When you update your distribution by using this API action, follow the steps here to get the current configuration and then make your updates, to make sure that you include all of the required fields. To view a summary, see Required Fields for Create Distribution and Update Distribution (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-overview-required-fields.html) in the Amazon CloudFront Developer Guide. The update process includes getting the current distribution configuration, updating the XML document that is returned to make your changes, and then submitting an UpdateDistribution request to make the updates. For information about updating a distribution using the CloudFront console instead, see Creating a Distribution (https://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
(https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetDistributionConfig.html) request to get the current configuration and an Etag header
for the
distribution. If you update the distribution again, you must get a new Etag header.
- Update the XML document that was returned in the response to your
GetDistributionConfig request to include your changes. When you edit the XML file, be aware of the following:
- You must strip out the ETag
parameter that is returned.
- Additional fields are required when you
update a distribution. There may be fields included in the XML file for features that you haven't configured for your distribution. This is expected and required to successfully update the distribution.
- 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 your 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
(https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetDistribution.html) request to confirm that your changes have propagated.
When propagation is
complete, the value of Status is Deployed.
func (*Client) UpdateFieldLevelEncryptionConfig ¶
func (c *Client) UpdateFieldLevelEncryptionConfig(ctx context.Context, params *UpdateFieldLevelEncryptionConfigInput, optFns ...func(*Options)) (*UpdateFieldLevelEncryptionConfigOutput, error)
Update a field-level encryption configuration.
func (*Client) UpdateFieldLevelEncryptionProfile ¶
func (c *Client) UpdateFieldLevelEncryptionProfile(ctx context.Context, params *UpdateFieldLevelEncryptionProfileInput, optFns ...func(*Options)) (*UpdateFieldLevelEncryptionProfileOutput, error)
Update a field-level encryption profile.
func (*Client) UpdateOriginRequestPolicy ¶
func (c *Client) UpdateOriginRequestPolicy(ctx context.Context, params *UpdateOriginRequestPolicyInput, optFns ...func(*Options)) (*UpdateOriginRequestPolicyOutput, error)
Updates an origin request policy configuration. When you update an origin request policy configuration, all the fields are updated with the values provided in the request. You cannot update some fields independent of others. To update an origin request policy configuration:
- Use
GetOriginRequestPolicyConfig to get the current configuration.
- Locally
modify the fields in the origin request policy configuration that you want to update.
- Call UpdateOriginRequestPolicy by providing the entire origin
request policy configuration, including the fields that you modified and those that you didn’t.
func (*Client) UpdatePublicKey ¶
func (c *Client) UpdatePublicKey(ctx context.Context, params *UpdatePublicKeyInput, optFns ...func(*Options)) (*UpdatePublicKeyOutput, error)
Update public key information. Note that the only value you can change is the comment.
func (*Client) UpdateStreamingDistribution ¶
func (c *Client) UpdateStreamingDistribution(ctx context.Context, params *UpdateStreamingDistributionInput, optFns ...func(*Options)) (*UpdateStreamingDistributionOutput, error)
Update a streaming distribution.
type CreateCachePolicyInput ¶
type CreateCachePolicyInput struct { // A cache policy configuration. // // This member is required. CachePolicyConfig *types.CachePolicyConfig }
type CreateCachePolicyOutput ¶
type CreateCachePolicyOutput struct { // A cache policy. CachePolicy *types.CachePolicy // The current version of the cache policy. ETag *string // The fully qualified URI of the cache policy just created. Location *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type CreateCloudFrontOriginAccessIdentityInput ¶
type CreateCloudFrontOriginAccessIdentityInput struct { // The current configuration information for the identity. // // This member is required. CloudFrontOriginAccessIdentityConfig *types.CloudFrontOriginAccessIdentityConfig }
The request to create a new origin access identity (OAI). An origin access identity is a special CloudFront user that you can associate with Amazon S3 origins, so that you can secure all or just some of your Amazon S3 content. For more information, see Restricting Access to Amazon S3 Content by Using an Origin Access Identity (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html) in the Amazon CloudFront Developer Guide.
type CreateCloudFrontOriginAccessIdentityOutput ¶
type CreateCloudFrontOriginAccessIdentityOutput struct { // The origin access identity's information. CloudFrontOriginAccessIdentity *types.CloudFrontOriginAccessIdentity // The current version of the origin access identity created. ETag *string // The fully qualified URI of the new origin access identity just created. Location *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type CreateDistributionInput ¶
type CreateDistributionInput struct { // The distribution's configuration information. // // This member is required. DistributionConfig *types.DistributionConfig }
The request to create a new distribution.
type CreateDistributionOutput ¶
type CreateDistributionOutput struct { // The distribution's information. Distribution *types.Distribution // The current version of the distribution created. ETag *string // The fully qualified URI of the new distribution resource just created. Location *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type CreateDistributionWithTagsInput ¶
type CreateDistributionWithTagsInput struct { // The distribution's configuration information. // // This member is required. DistributionConfigWithTags *types.DistributionConfigWithTags }
The request to create a new distribution with tags.
type CreateDistributionWithTagsOutput ¶
type CreateDistributionWithTagsOutput struct { // The distribution's information. Distribution *types.Distribution // The current version of the distribution created. ETag *string // The fully qualified URI of the new distribution resource just created. Location *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type CreateFieldLevelEncryptionConfigInput ¶
type CreateFieldLevelEncryptionConfigInput struct { // The request to create a new field-level encryption configuration. // // This member is required. FieldLevelEncryptionConfig *types.FieldLevelEncryptionConfig }
type CreateFieldLevelEncryptionConfigOutput ¶
type CreateFieldLevelEncryptionConfigOutput struct { // The current version of the field level encryption configuration. For example: // E2QWRUHAPOMQZL. ETag *string // Returned when you create a new field-level encryption configuration. FieldLevelEncryption *types.FieldLevelEncryption // The fully qualified URI of the new configuration resource just created. Location *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type CreateFieldLevelEncryptionProfileInput ¶
type CreateFieldLevelEncryptionProfileInput struct { // The request to create a field-level encryption profile. // // This member is required. FieldLevelEncryptionProfileConfig *types.FieldLevelEncryptionProfileConfig }
type CreateFieldLevelEncryptionProfileOutput ¶
type CreateFieldLevelEncryptionProfileOutput struct { // The current version of the field level encryption profile. For example: // E2QWRUHAPOMQZL. ETag *string // Returned when you create a new field-level encryption profile. FieldLevelEncryptionProfile *types.FieldLevelEncryptionProfile // The fully qualified URI of the new profile resource just created. Location *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type CreateInvalidationInput ¶
type CreateInvalidationInput struct { // The distribution's id. // // This member is required. DistributionId *string // The batch information for the invalidation. // // This member is required. InvalidationBatch *types.InvalidationBatch }
The request to create an invalidation.
type CreateInvalidationOutput ¶
type CreateInvalidationOutput struct { // The invalidation's information. Invalidation *types.Invalidation // The fully qualified URI of the distribution and invalidation batch request, // including the Invalidation ID. Location *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type CreateOriginRequestPolicyInput ¶
type CreateOriginRequestPolicyInput struct { // An origin request policy configuration. // // This member is required. OriginRequestPolicyConfig *types.OriginRequestPolicyConfig }
type CreateOriginRequestPolicyOutput ¶
type CreateOriginRequestPolicyOutput struct { // The current version of the origin request policy. ETag *string // The fully qualified URI of the origin request policy just created. Location *string // An origin request policy. OriginRequestPolicy *types.OriginRequestPolicy // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type CreatePublicKeyInput ¶
type CreatePublicKeyInput struct { // The request to add a public key to CloudFront. // // This member is required. PublicKeyConfig *types.PublicKeyConfig }
type CreatePublicKeyOutput ¶
type CreatePublicKeyOutput struct { // The current version of the public key. For example: E2QWRUHAPOMQZL. ETag *string // The fully qualified URI of the new public key resource just created. Location *string // Returned when you add a public key. PublicKey *types.PublicKey // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type CreateStreamingDistributionInput ¶
type CreateStreamingDistributionInput struct { // The streaming distribution's configuration information. // // This member is required. StreamingDistributionConfig *types.StreamingDistributionConfig }
The request to create a new streaming distribution.
type CreateStreamingDistributionOutput ¶
type CreateStreamingDistributionOutput struct { // The current version of the streaming distribution created. ETag *string // The fully qualified URI of the new streaming distribution resource just created. Location *string // The streaming distribution's information. StreamingDistribution *types.StreamingDistribution // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type CreateStreamingDistributionWithTagsInput ¶
type CreateStreamingDistributionWithTagsInput struct { // The streaming distribution's configuration information. // // This member is required. StreamingDistributionConfigWithTags *types.StreamingDistributionConfigWithTags }
The request to create a new streaming distribution with tags.
type CreateStreamingDistributionWithTagsOutput ¶
type CreateStreamingDistributionWithTagsOutput struct { // The current version of the distribution created. ETag *string // The fully qualified URI of the new streaming distribution resource just created. Location *string // The streaming distribution's information. StreamingDistribution *types.StreamingDistribution // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type DeleteCachePolicyInput ¶
type DeleteCachePolicyInput struct { // The unique identifier for the cache policy that you are deleting. To get the // identifier, you can use ListCachePolicies. // // This member is required. Id *string // The version of the cache policy that you are deleting. The version is the cache // policy’s ETag value, which you can get using ListCachePolicies, GetCachePolicy, // or GetCachePolicyConfig. IfMatch *string }
type DeleteCachePolicyOutput ¶
type DeleteCachePolicyOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeleteCloudFrontOriginAccessIdentityInput ¶
type DeleteCloudFrontOriginAccessIdentityInput struct { // The origin access identity's ID. // // This member is required. Id *string // The value of the ETag header you received from a previous GET or PUT request. // For example: E2QWRUHAPOMQZL. IfMatch *string }
Deletes a origin access identity.
type DeleteCloudFrontOriginAccessIdentityOutput ¶
type DeleteCloudFrontOriginAccessIdentityOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeleteDistributionInput ¶
type DeleteDistributionInput struct { // The distribution ID. // // This member is required. Id *string // The value of the ETag header that you received when you disabled the // distribution. For example: E2QWRUHAPOMQZL. IfMatch *string }
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 (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/HowToDeleteDistribution.html) in the Amazon CloudFront Developer Guide.
type DeleteDistributionOutput ¶
type DeleteDistributionOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeleteFieldLevelEncryptionConfigInput ¶
type DeleteFieldLevelEncryptionConfigInput struct { // The ID of the configuration you want to delete from CloudFront. // // This member is required. Id *string // The value of the ETag header that you received when retrieving the configuration // identity to delete. For example: E2QWRUHAPOMQZL. IfMatch *string }
type DeleteFieldLevelEncryptionConfigOutput ¶
type DeleteFieldLevelEncryptionConfigOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeleteFieldLevelEncryptionProfileInput ¶
type DeleteFieldLevelEncryptionProfileInput struct { // Request the ID of the profile you want to delete from CloudFront. // // This member is required. Id *string // The value of the ETag header that you received when retrieving the profile to // delete. For example: E2QWRUHAPOMQZL. IfMatch *string }
type DeleteFieldLevelEncryptionProfileOutput ¶
type DeleteFieldLevelEncryptionProfileOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeleteOriginRequestPolicyInput ¶
type DeleteOriginRequestPolicyInput struct { // The unique identifier for the origin request policy that you are deleting. To // get the identifier, you can use ListOriginRequestPolicies. // // This member is required. Id *string // The version of the origin request policy that you are deleting. The version is // the origin request policy’s ETag value, which you can get using // ListOriginRequestPolicies, GetOriginRequestPolicy, or // GetOriginRequestPolicyConfig. IfMatch *string }
type DeleteOriginRequestPolicyOutput ¶
type DeleteOriginRequestPolicyOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeletePublicKeyInput ¶
type DeletePublicKeyInput struct { // The ID of the public key you want to remove from CloudFront. // // This member is required. Id *string // The value of the ETag header that you received when retrieving the public key // identity to delete. For example: E2QWRUHAPOMQZL. IfMatch *string }
type DeletePublicKeyOutput ¶
type DeletePublicKeyOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type DeleteStreamingDistributionInput ¶
type DeleteStreamingDistributionInput struct { // The distribution ID. // // This member is required. Id *string // The value of the ETag header that you received when you disabled the streaming // distribution. For example: E2QWRUHAPOMQZL. IfMatch *string }
The request to delete a streaming distribution.
type DeleteStreamingDistributionOutput ¶
type DeleteStreamingDistributionOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type EndpointResolver ¶
type EndpointResolver interface { ResolveEndpoint(region string, options ResolverOptions) (aws.Endpoint, error) }
EndpointResolver interface for resolving service endpoints.
func WithEndpointResolver ¶
func WithEndpointResolver(awsResolver aws.EndpointResolver, fallbackResolver EndpointResolver) EndpointResolver
WithEndpointResolver returns an EndpointResolver that first delegates endpoint resolution to the awsResolver. If awsResolver returns aws.EndpointNotFoundError error, the resolver will use the the provided fallbackResolver for resolution. awsResolver and fallbackResolver must not be nil
type EndpointResolverFunc ¶
type EndpointResolverFunc func(region string, options ResolverOptions) (aws.Endpoint, error)
EndpointResolverFunc is a helper utility that wraps a function so it satisfies the EndpointResolver interface. This is useful when you want to add additional endpoint resolving logic, or stub out specific endpoints with custom values.
func (EndpointResolverFunc) ResolveEndpoint ¶
func (fn EndpointResolverFunc) ResolveEndpoint(region string, options ResolverOptions) (endpoint aws.Endpoint, err error)
type GetCachePolicyConfigInput ¶
type GetCachePolicyConfigInput struct { // The unique identifier for the cache policy. If the cache policy is attached to a // distribution’s cache behavior, you can get the policy’s identifier using // ListDistributions or GetDistribution. If the cache policy is not attached to a // cache behavior, you can get the identifier using ListCachePolicies. // // This member is required. Id *string }
type GetCachePolicyConfigOutput ¶
type GetCachePolicyConfigOutput struct { // The cache policy configuration. CachePolicyConfig *types.CachePolicyConfig // The current version of the cache policy. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetCachePolicyInput ¶
type GetCachePolicyInput struct { // The unique identifier for the cache policy. If the cache policy is attached to a // distribution’s cache behavior, you can get the policy’s identifier using // ListDistributions or GetDistribution. If the cache policy is not attached to a // cache behavior, you can get the identifier using ListCachePolicies. // // This member is required. Id *string }
type GetCachePolicyOutput ¶
type GetCachePolicyOutput struct { // The cache policy. CachePolicy *types.CachePolicy // The current version of the cache policy. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetCloudFrontOriginAccessIdentityConfigInput ¶
type GetCloudFrontOriginAccessIdentityConfigInput struct { // The identity's ID. // // This member is required. Id *string }
The origin access identity's configuration information. For more information, see CloudFrontOriginAccessIdentityConfig (https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CloudFrontOriginAccessIdentityConfig.html).
type GetCloudFrontOriginAccessIdentityConfigOutput ¶
type GetCloudFrontOriginAccessIdentityConfigOutput struct { // The origin access identity's configuration information. CloudFrontOriginAccessIdentityConfig *types.CloudFrontOriginAccessIdentityConfig // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type GetCloudFrontOriginAccessIdentityInput ¶
type GetCloudFrontOriginAccessIdentityInput struct { // The identity's ID. // // This member is required. Id *string }
The request to get an origin access identity's information.
type GetCloudFrontOriginAccessIdentityOutput ¶
type GetCloudFrontOriginAccessIdentityOutput struct { // The origin access identity's information. CloudFrontOriginAccessIdentity *types.CloudFrontOriginAccessIdentity // The current version of the origin access identity's information. For example: // E2QWRUHAPOMQZL. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type GetDistributionConfigInput ¶
type GetDistributionConfigInput struct { // The distribution's ID. If the ID is empty, an empty distribution configuration // is returned. // // This member is required. Id *string }
The request to get a distribution configuration.
type GetDistributionConfigOutput ¶
type GetDistributionConfigOutput struct { // The distribution's configuration information. DistributionConfig *types.DistributionConfig // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type GetDistributionInput ¶
type GetDistributionInput struct { // The distribution's ID. If the ID is empty, an empty distribution configuration // is returned. // // This member is required. Id *string }
The request to get a distribution's information.
type GetDistributionOutput ¶
type GetDistributionOutput struct { // The distribution's information. Distribution *types.Distribution // The current version of the distribution's information. For example: // E2QWRUHAPOMQZL. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type GetFieldLevelEncryptionConfigInput ¶
type GetFieldLevelEncryptionConfigInput struct { // Request the ID for the field-level encryption configuration information. // // This member is required. Id *string }
type GetFieldLevelEncryptionConfigOutput ¶
type GetFieldLevelEncryptionConfigOutput struct { // The current version of the field level encryption configuration. For example: // E2QWRUHAPOMQZL. ETag *string // Return the field-level encryption configuration information. FieldLevelEncryptionConfig *types.FieldLevelEncryptionConfig // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetFieldLevelEncryptionInput ¶
type GetFieldLevelEncryptionInput struct { // Request the ID for the field-level encryption configuration information. // // This member is required. Id *string }
type GetFieldLevelEncryptionOutput ¶
type GetFieldLevelEncryptionOutput struct { // The current version of the field level encryption configuration. For example: // E2QWRUHAPOMQZL. ETag *string // Return the field-level encryption configuration information. FieldLevelEncryption *types.FieldLevelEncryption // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetFieldLevelEncryptionProfileConfigInput ¶
type GetFieldLevelEncryptionProfileConfigInput struct { // Get the ID for the field-level encryption profile configuration information. // // This member is required. Id *string }
type GetFieldLevelEncryptionProfileConfigOutput ¶
type GetFieldLevelEncryptionProfileConfigOutput struct { // The current version of the field-level encryption profile configuration result. // For example: E2QWRUHAPOMQZL. ETag *string // Return the field-level encryption profile configuration information. FieldLevelEncryptionProfileConfig *types.FieldLevelEncryptionProfileConfig // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetFieldLevelEncryptionProfileInput ¶
type GetFieldLevelEncryptionProfileInput struct { // Get the ID for the field-level encryption profile information. // // This member is required. Id *string }
type GetFieldLevelEncryptionProfileOutput ¶
type GetFieldLevelEncryptionProfileOutput struct { // The current version of the field level encryption profile. For example: // E2QWRUHAPOMQZL. ETag *string // Return the field-level encryption profile information. FieldLevelEncryptionProfile *types.FieldLevelEncryptionProfile // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetInvalidationInput ¶
type GetInvalidationInput struct { // The distribution's ID. // // This member is required. DistributionId *string // The identifier for the invalidation request, for example, IDFDVBD632BHDS5. // // This member is required. Id *string }
The request to get an invalidation's information.
type GetInvalidationOutput ¶
type GetInvalidationOutput struct { // The invalidation's information. For more information, see Invalidation Complex // Type // (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/InvalidationDatatype.html). Invalidation *types.Invalidation // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type GetOriginRequestPolicyConfigInput ¶
type GetOriginRequestPolicyConfigInput struct { // The unique identifier for the origin request policy. If the origin request // policy is attached to a distribution’s cache behavior, you can get the policy’s // identifier using ListDistributions or GetDistribution. If the origin request // policy is not attached to a cache behavior, you can get the identifier using // ListOriginRequestPolicies. // // This member is required. Id *string }
type GetOriginRequestPolicyConfigOutput ¶
type GetOriginRequestPolicyConfigOutput struct { // The current version of the origin request policy. ETag *string // The origin request policy configuration. OriginRequestPolicyConfig *types.OriginRequestPolicyConfig // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetOriginRequestPolicyInput ¶
type GetOriginRequestPolicyInput struct { // The unique identifier for the origin request policy. If the origin request // policy is attached to a distribution’s cache behavior, you can get the policy’s // identifier using ListDistributions or GetDistribution. If the origin request // policy is not attached to a cache behavior, you can get the identifier using // ListOriginRequestPolicies. // // This member is required. Id *string }
type GetOriginRequestPolicyOutput ¶
type GetOriginRequestPolicyOutput struct { // The current version of the origin request policy. ETag *string // The origin request policy. OriginRequestPolicy *types.OriginRequestPolicy // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetPublicKeyConfigInput ¶
type GetPublicKeyConfigInput struct { // Request the ID for the public key configuration. // // This member is required. Id *string }
type GetPublicKeyConfigOutput ¶
type GetPublicKeyConfigOutput struct { // The current version of the public key configuration. For example: // E2QWRUHAPOMQZL. ETag *string // Return the result for the public key configuration. PublicKeyConfig *types.PublicKeyConfig // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetPublicKeyInput ¶
type GetPublicKeyInput struct { // Request the ID for the public key. // // This member is required. Id *string }
type GetPublicKeyOutput ¶
type GetPublicKeyOutput struct { // The current version of the public key. For example: E2QWRUHAPOMQZL. ETag *string // Return the public key. PublicKey *types.PublicKey // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type GetStreamingDistributionConfigInput ¶
type GetStreamingDistributionConfigInput struct { // The streaming distribution's ID. // // This member is required. Id *string }
To request to get a streaming distribution configuration.
type GetStreamingDistributionConfigOutput ¶
type GetStreamingDistributionConfigOutput struct { // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string // The streaming distribution's configuration information. StreamingDistributionConfig *types.StreamingDistributionConfig // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type GetStreamingDistributionInput ¶
type GetStreamingDistributionInput struct { // The streaming distribution's ID. // // This member is required. Id *string }
The request to get a streaming distribution's information.
type GetStreamingDistributionOutput ¶
type GetStreamingDistributionOutput struct { // The current version of the streaming distribution's information. For example: // E2QWRUHAPOMQZL. ETag *string // The streaming distribution's information. StreamingDistribution *types.StreamingDistribution // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type HTTPClient ¶
type HTTPSignerV4 ¶
type HTTPSignerV4 interface { SignHTTP(ctx context.Context, credentials aws.Credentials, r *http.Request, payloadHash string, service string, region string, signingTime time.Time) error }
type ListCachePoliciesInput ¶
type ListCachePoliciesInput struct { // Use this field when paginating results to indicate where to begin in your list // of cache policies. The response includes cache policies in the list that occur // after the marker. To get the next page of the list, set this field’s value to // the value of NextMarker from the current page’s response. Marker *string // The maximum number of cache policies that you want in the response. MaxItems *string // A filter to return only the specified kinds of cache policies. Valid values // are: // // * managed – Returns only the managed policies created by AWS. // // * // custom – Returns only the custom policies created in your AWS account. Type types.CachePolicyType }
type ListCachePoliciesOutput ¶
type ListCachePoliciesOutput struct { // A list of cache policies. CachePolicyList *types.CachePolicyList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
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 // The maximum number of origin access identities you want in the response body. MaxItems *string }
The request to list origin access identities.
type ListCloudFrontOriginAccessIdentitiesOutput ¶
type ListCloudFrontOriginAccessIdentitiesOutput struct { // The CloudFrontOriginAccessIdentityList type. CloudFrontOriginAccessIdentityList *types.CloudFrontOriginAccessIdentityList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type ListDistributionsByCachePolicyIdInput ¶
type ListDistributionsByCachePolicyIdInput struct { // The ID of the cache policy whose associated distribution IDs you want to list. // // This member is required. CachePolicyId *string // Use this field when paginating results to indicate where to begin in your list // of distribution IDs. The response includes distribution IDs in the list that // occur after the marker. To get the next page of the list, set this field’s value // to the value of NextMarker from the current page’s response. Marker *string // The maximum number of distribution IDs that you want in the response. MaxItems *string }
type ListDistributionsByCachePolicyIdOutput ¶
type ListDistributionsByCachePolicyIdOutput struct { // A list of distribution IDs. DistributionIdList *types.DistributionIdList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type ListDistributionsByOriginRequestPolicyIdInput ¶
type ListDistributionsByOriginRequestPolicyIdInput struct { // The ID of the origin request policy whose associated distribution IDs you want // to list. // // This member is required. OriginRequestPolicyId *string // Use this field when paginating results to indicate where to begin in your list // of distribution IDs. The response includes distribution IDs in the list that // occur after the marker. To get the next page of the list, set this field’s value // to the value of NextMarker from the current page’s response. Marker *string // The maximum number of distribution IDs that you want in the response. MaxItems *string }
type ListDistributionsByOriginRequestPolicyIdOutput ¶
type ListDistributionsByOriginRequestPolicyIdOutput struct { // A list of distribution IDs. DistributionIdList *types.DistributionIdList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type ListDistributionsByWebACLIdInput ¶
type ListDistributionsByWebACLIdInput struct { // 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. // // This member is required. WebACLId *string // 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 // The maximum number of distributions that you want CloudFront to return in the // response body. The maximum and default values are both 100. MaxItems *string }
The request to list distributions that are associated with a specified AWS WAF web ACL.
type ListDistributionsByWebACLIdOutput ¶
type ListDistributionsByWebACLIdOutput struct { // The DistributionList type. DistributionList *types.DistributionList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The response to a request to list the distributions that are associated with a specified AWS WAF web ACL.
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 // The maximum number of distributions you want in the response body. MaxItems *string }
The request to list your distributions.
type ListDistributionsOutput ¶
type ListDistributionsOutput struct { // The DistributionList type. DistributionList *types.DistributionList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type ListFieldLevelEncryptionConfigsInput ¶
type ListFieldLevelEncryptionConfigsInput struct { // Use this when paginating results to indicate where to begin in your list of // configurations. The results include configurations 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 // configuration on that page). Marker *string // The maximum number of field-level encryption configurations you want in the // response body. MaxItems *string }
type ListFieldLevelEncryptionConfigsOutput ¶
type ListFieldLevelEncryptionConfigsOutput struct { // Returns a list of all field-level encryption configurations that have been // created in CloudFront for this account. FieldLevelEncryptionList *types.FieldLevelEncryptionList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type ListFieldLevelEncryptionProfilesInput ¶
type ListFieldLevelEncryptionProfilesInput struct { // Use this when paginating results to indicate where to begin in your list of // profiles. The results include profiles 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 profile on // that page). Marker *string // The maximum number of field-level encryption profiles you want in the response // body. MaxItems *string }
type ListFieldLevelEncryptionProfilesOutput ¶
type ListFieldLevelEncryptionProfilesOutput struct { // Returns a list of the field-level encryption profiles that have been created in // CloudFront for this account. FieldLevelEncryptionProfileList *types.FieldLevelEncryptionProfileList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type ListInvalidationsInput ¶
type ListInvalidationsInput struct { // The distribution's ID. // // This member is required. DistributionId *string // 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 // The maximum number of invalidation batches that you want in the response body. MaxItems *string }
The request to list invalidations.
type ListInvalidationsOutput ¶
type ListInvalidationsOutput struct { // Information about invalidation batches. InvalidationList *types.InvalidationList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type ListOriginRequestPoliciesInput ¶
type ListOriginRequestPoliciesInput struct { // Use this field when paginating results to indicate where to begin in your list // of origin request policies. The response includes origin request policies in the // list that occur after the marker. To get the next page of the list, set this // field’s value to the value of NextMarker from the current page’s response. Marker *string // The maximum number of origin request policies that you want in the response. MaxItems *string // A filter to return only the specified kinds of origin request policies. Valid // values are: // // * managed – Returns only the managed policies created by AWS. // // // * custom – Returns only the custom policies created in your AWS account. Type types.OriginRequestPolicyType }
type ListOriginRequestPoliciesOutput ¶
type ListOriginRequestPoliciesOutput struct { // A list of origin request policies. OriginRequestPolicyList *types.OriginRequestPolicyList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type ListPublicKeysInput ¶
type ListPublicKeysInput struct { // Use this when paginating results to indicate where to begin in your list of // public keys. The results include public keys 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 // public key on that page). Marker *string // The maximum number of public keys you want in the response body. MaxItems *string }
type ListPublicKeysOutput ¶
type ListPublicKeysOutput struct { // Returns a list of all public keys that have been added to CloudFront for this // account. PublicKeyList *types.PublicKeyList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type ListStreamingDistributionsInput ¶
type ListStreamingDistributionsInput struct { // The value that you provided for the Marker request parameter. Marker *string // The value that you provided for the MaxItems request parameter. MaxItems *string }
The request to list your streaming distributions.
type ListStreamingDistributionsOutput ¶
type ListStreamingDistributionsOutput struct { // The StreamingDistributionList type. StreamingDistributionList *types.StreamingDistributionList // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type ListTagsForResourceInput ¶
type ListTagsForResourceInput struct { // An ARN of a CloudFront resource. // // This member is required. Resource *string }
The request to list tags for a CloudFront resource.
type ListTagsForResourceOutput ¶
type ListTagsForResourceOutput struct { // A complex type that contains zero or more Tag elements. // // This member is required. Tags *types.Tags // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type Options ¶
type Options struct { // Set of options to modify how an operation is invoked. These apply to all // operations invoked for this client. Use functional options on operation call to // modify this list for per operation behavior. APIOptions []func(*middleware.Stack) error // The credentials object to use when signing requests. Credentials aws.CredentialsProvider // The endpoint options to be used when attempting to resolve an endpoint. EndpointOptions ResolverOptions // The service endpoint resolver. EndpointResolver EndpointResolver // Signature Version 4 (SigV4) Signer HTTPSignerV4 HTTPSignerV4 // The region to send requests to. (Required) Region string // Retryer guides how HTTP requests should be retried in case of recoverable // failures. When nil the API client will use a default retryer. Retryer retry.Retryer // The HTTP client to invoke API calls with. Defaults to client's default HTTP // implementation if nil. HTTPClient HTTPClient }
func (Options) Copy ¶
Copy creates a clone where the APIOptions list is deep copied.
type ResolveEndpoint ¶
type ResolveEndpoint struct { Resolver EndpointResolver Options ResolverOptions }
func (*ResolveEndpoint) HandleSerialize ¶
func (m *ResolveEndpoint) HandleSerialize(ctx context.Context, in middleware.SerializeInput, next middleware.SerializeHandler) ( out middleware.SerializeOutput, metadata middleware.Metadata, err error, )
func (*ResolveEndpoint) ID ¶
func (*ResolveEndpoint) ID() string
type ResolverOptions ¶
type ResolverOptions = internalendpoints.Options
ResolverOptions is the service endpoint resolver options
type TagResourceInput ¶
type TagResourceInput struct { // An ARN of a CloudFront resource. // // This member is required. Resource *string // A complex type that contains zero or more Tag elements. // // This member is required. Tags *types.Tags }
The request to add tags to a CloudFront resource.
type TagResourceOutput ¶
type TagResourceOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type UntagResourceInput ¶
type UntagResourceInput struct { // An ARN of a CloudFront resource. // // This member is required. Resource *string // A complex type that contains zero or more Tag key elements. // // This member is required. TagKeys *types.TagKeys }
The request to remove tags from a CloudFront resource.
type UntagResourceOutput ¶
type UntagResourceOutput struct { // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type UpdateCachePolicyInput ¶
type UpdateCachePolicyInput struct { // A cache policy configuration. // // This member is required. CachePolicyConfig *types.CachePolicyConfig // The unique identifier for the cache policy that you are updating. The identifier // is returned in a cache behavior’s CachePolicyId field in the response to // GetDistributionConfig. // // This member is required. Id *string // The version of the cache policy that you are updating. The version is returned // in the cache policy’s ETag field in the response to GetCachePolicyConfig. IfMatch *string }
type UpdateCachePolicyOutput ¶
type UpdateCachePolicyOutput struct { // A cache policy. CachePolicy *types.CachePolicy // The current version of the cache policy. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type UpdateCloudFrontOriginAccessIdentityInput ¶
type UpdateCloudFrontOriginAccessIdentityInput struct { // The identity's configuration information. // // This member is required. CloudFrontOriginAccessIdentityConfig *types.CloudFrontOriginAccessIdentityConfig // The identity's id. // // This member is required. Id *string // The value of the ETag header that you received when retrieving the identity's // configuration. For example: E2QWRUHAPOMQZL. IfMatch *string }
The request to update an origin access identity.
type UpdateCloudFrontOriginAccessIdentityOutput ¶
type UpdateCloudFrontOriginAccessIdentityOutput struct { // The origin access identity's information. CloudFrontOriginAccessIdentity *types.CloudFrontOriginAccessIdentity // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type UpdateDistributionInput ¶
type UpdateDistributionInput struct { // The distribution's configuration information. // // This member is required. DistributionConfig *types.DistributionConfig // The distribution's id. // // This member is required. Id *string // The value of the ETag header that you received when retrieving the // distribution's configuration. For example: E2QWRUHAPOMQZL. IfMatch *string }
The request to update a distribution.
type UpdateDistributionOutput ¶
type UpdateDistributionOutput struct { // The distribution's information. Distribution *types.Distribution // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
type UpdateFieldLevelEncryptionConfigInput ¶
type UpdateFieldLevelEncryptionConfigInput struct { // Request to update a field-level encryption configuration. // // This member is required. FieldLevelEncryptionConfig *types.FieldLevelEncryptionConfig // The ID of the configuration you want to update. // // This member is required. Id *string // The value of the ETag header that you received when retrieving the configuration // identity to update. For example: E2QWRUHAPOMQZL. IfMatch *string }
type UpdateFieldLevelEncryptionConfigOutput ¶
type UpdateFieldLevelEncryptionConfigOutput struct { // The value of the ETag header that you received when updating the configuration. // For example: E2QWRUHAPOMQZL. ETag *string // Return the results of updating the configuration. FieldLevelEncryption *types.FieldLevelEncryption // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type UpdateFieldLevelEncryptionProfileInput ¶
type UpdateFieldLevelEncryptionProfileInput struct { // Request to update a field-level encryption profile. // // This member is required. FieldLevelEncryptionProfileConfig *types.FieldLevelEncryptionProfileConfig // The ID of the field-level encryption profile request. // // This member is required. Id *string // The value of the ETag header that you received when retrieving the profile // identity to update. For example: E2QWRUHAPOMQZL. IfMatch *string }
type UpdateFieldLevelEncryptionProfileOutput ¶
type UpdateFieldLevelEncryptionProfileOutput struct { // The result of the field-level encryption profile request. ETag *string // Return the results of updating the profile. FieldLevelEncryptionProfile *types.FieldLevelEncryptionProfile // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type UpdateOriginRequestPolicyInput ¶
type UpdateOriginRequestPolicyInput struct { // The unique identifier for the origin request policy that you are updating. The // identifier is returned in a cache behavior’s OriginRequestPolicyId field in the // response to GetDistributionConfig. // // This member is required. Id *string // An origin request policy configuration. // // This member is required. OriginRequestPolicyConfig *types.OriginRequestPolicyConfig // The version of the origin request policy that you are updating. The version is // returned in the origin request policy’s ETag field in the response to // GetOriginRequestPolicyConfig. IfMatch *string }
type UpdateOriginRequestPolicyOutput ¶
type UpdateOriginRequestPolicyOutput struct { // The current version of the origin request policy. ETag *string // An origin request policy. OriginRequestPolicy *types.OriginRequestPolicy // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type UpdatePublicKeyInput ¶
type UpdatePublicKeyInput struct { // ID of the public key to be updated. // // This member is required. Id *string // Request to update public key information. // // This member is required. PublicKeyConfig *types.PublicKeyConfig // The value of the ETag header that you received when retrieving the public key to // update. For example: E2QWRUHAPOMQZL. IfMatch *string }
type UpdatePublicKeyOutput ¶
type UpdatePublicKeyOutput struct { // The current version of the update public key result. For example: // E2QWRUHAPOMQZL. ETag *string // Return the results of updating the public key. PublicKey *types.PublicKey // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
type UpdateStreamingDistributionInput ¶
type UpdateStreamingDistributionInput struct { // The streaming distribution's id. // // This member is required. Id *string // The streaming distribution's configuration information. // // This member is required. StreamingDistributionConfig *types.StreamingDistributionConfig // The value of the ETag header that you received when retrieving the streaming // distribution's configuration. For example: E2QWRUHAPOMQZL. IfMatch *string }
The request to update a streaming distribution.
type UpdateStreamingDistributionOutput ¶
type UpdateStreamingDistributionOutput struct { // The current version of the configuration. For example: E2QWRUHAPOMQZL. ETag *string // The streaming distribution's information. StreamingDistribution *types.StreamingDistribution // Metadata pertaining to the operation's result. ResultMetadata middleware.Metadata }
The returned result of the corresponding request.
Source Files ¶
api_client.go api_op_CreateCachePolicy.go api_op_CreateCloudFrontOriginAccessIdentity.go api_op_CreateDistribution.go api_op_CreateDistributionWithTags.go api_op_CreateFieldLevelEncryptionConfig.go api_op_CreateFieldLevelEncryptionProfile.go api_op_CreateInvalidation.go api_op_CreateOriginRequestPolicy.go api_op_CreatePublicKey.go api_op_CreateStreamingDistribution.go api_op_CreateStreamingDistributionWithTags.go api_op_DeleteCachePolicy.go api_op_DeleteCloudFrontOriginAccessIdentity.go api_op_DeleteDistribution.go api_op_DeleteFieldLevelEncryptionConfig.go api_op_DeleteFieldLevelEncryptionProfile.go api_op_DeleteOriginRequestPolicy.go api_op_DeletePublicKey.go api_op_DeleteStreamingDistribution.go api_op_GetCachePolicy.go api_op_GetCachePolicyConfig.go api_op_GetCloudFrontOriginAccessIdentity.go api_op_GetCloudFrontOriginAccessIdentityConfig.go api_op_GetDistribution.go api_op_GetDistributionConfig.go api_op_GetFieldLevelEncryption.go api_op_GetFieldLevelEncryptionConfig.go api_op_GetFieldLevelEncryptionProfile.go api_op_GetFieldLevelEncryptionProfileConfig.go api_op_GetInvalidation.go api_op_GetOriginRequestPolicy.go api_op_GetOriginRequestPolicyConfig.go api_op_GetPublicKey.go api_op_GetPublicKeyConfig.go api_op_GetStreamingDistribution.go api_op_GetStreamingDistributionConfig.go api_op_ListCachePolicies.go api_op_ListCloudFrontOriginAccessIdentities.go api_op_ListDistributions.go api_op_ListDistributionsByCachePolicyId.go api_op_ListDistributionsByOriginRequestPolicyId.go api_op_ListDistributionsByWebACLId.go api_op_ListFieldLevelEncryptionConfigs.go api_op_ListFieldLevelEncryptionProfiles.go api_op_ListInvalidations.go api_op_ListOriginRequestPolicies.go api_op_ListPublicKeys.go api_op_ListStreamingDistributions.go api_op_ListTagsForResource.go api_op_TagResource.go api_op_UntagResource.go api_op_UpdateCachePolicy.go api_op_UpdateCloudFrontOriginAccessIdentity.go api_op_UpdateDistribution.go api_op_UpdateFieldLevelEncryptionConfig.go api_op_UpdateFieldLevelEncryptionProfile.go api_op_UpdateOriginRequestPolicy.go api_op_UpdatePublicKey.go api_op_UpdateStreamingDistribution.go deserializers.go doc.go endpoints.go serializers.go validators.go
Directories ¶
Path | Synopsis |
---|---|
internal | |
sign | Package sign provides utilities to generate signed URLs for Amazon CloudFront. |
types |
- Version
- v0.27.0
- Published
- Oct 17, 2020
- Platform
- darwin/amd64
- Imports
- 27 packages
- Last checked
- now –
Tools for package owners.