CreateDistributionCommand

Creates a CloudFront distribution.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { CloudFrontClient, CreateDistributionCommand } from "@aws-sdk/client-cloudfront"; // ES Modules import
// const { CloudFrontClient, CreateDistributionCommand } = require("@aws-sdk/client-cloudfront"); // CommonJS import
const client = new CloudFrontClient(config);
const input = { // CreateDistributionRequest
  DistributionConfig: { // DistributionConfig
    CallerReference: "STRING_VALUE", // required
    Aliases: { // Aliases
      Quantity: Number("int"), // required
      Items: [ // AliasList
        "STRING_VALUE",
      ],
    },
    DefaultRootObject: "STRING_VALUE",
    Origins: { // Origins
      Quantity: Number("int"), // required
      Items: [ // OriginList // required
        { // Origin
          Id: "STRING_VALUE", // required
          DomainName: "STRING_VALUE", // required
          OriginPath: "STRING_VALUE",
          CustomHeaders: { // CustomHeaders
            Quantity: Number("int"), // required
            Items: [ // OriginCustomHeadersList
              { // OriginCustomHeader
                HeaderName: "STRING_VALUE", // required
                HeaderValue: "STRING_VALUE", // required
              },
            ],
          },
          S3OriginConfig: { // S3OriginConfig
            OriginAccessIdentity: "STRING_VALUE", // required
          },
          CustomOriginConfig: { // CustomOriginConfig
            HTTPPort: Number("int"), // required
            HTTPSPort: Number("int"), // required
            OriginProtocolPolicy: "http-only" || "match-viewer" || "https-only", // required
            OriginSslProtocols: { // OriginSslProtocols
              Quantity: Number("int"), // required
              Items: [ // SslProtocolsList // required
                "SSLv3" || "TLSv1" || "TLSv1.1" || "TLSv1.2",
              ],
            },
            OriginReadTimeout: Number("int"),
            OriginKeepaliveTimeout: Number("int"),
          },
          VpcOriginConfig: { // VpcOriginConfig
            VpcOriginId: "STRING_VALUE", // required
            OriginReadTimeout: Number("int"),
            OriginKeepaliveTimeout: Number("int"),
          },
          ConnectionAttempts: Number("int"),
          ConnectionTimeout: Number("int"),
          OriginShield: { // OriginShield
            Enabled: true || false, // required
            OriginShieldRegion: "STRING_VALUE",
          },
          OriginAccessControlId: "STRING_VALUE",
        },
      ],
    },
    OriginGroups: { // OriginGroups
      Quantity: Number("int"), // required
      Items: [ // OriginGroupList
        { // OriginGroup
          Id: "STRING_VALUE", // required
          FailoverCriteria: { // OriginGroupFailoverCriteria
            StatusCodes: { // StatusCodes
              Quantity: Number("int"), // required
              Items: [ // StatusCodeList // required
                Number("int"),
              ],
            },
          },
          Members: { // OriginGroupMembers
            Quantity: Number("int"), // required
            Items: [ // OriginGroupMemberList // required
              { // OriginGroupMember
                OriginId: "STRING_VALUE", // required
              },
            ],
          },
          SelectionCriteria: "default" || "media-quality-based",
        },
      ],
    },
    DefaultCacheBehavior: { // DefaultCacheBehavior
      TargetOriginId: "STRING_VALUE", // required
      TrustedSigners: { // TrustedSigners
        Enabled: true || false, // required
        Quantity: Number("int"), // required
        Items: [ // AwsAccountNumberList
          "STRING_VALUE",
        ],
      },
      TrustedKeyGroups: { // TrustedKeyGroups
        Enabled: true || false, // required
        Quantity: Number("int"), // required
        Items: [ // TrustedKeyGroupIdList
          "STRING_VALUE",
        ],
      },
      ViewerProtocolPolicy: "allow-all" || "https-only" || "redirect-to-https", // required
      AllowedMethods: { // AllowedMethods
        Quantity: Number("int"), // required
        Items: [ // MethodsList // required
          "GET" || "HEAD" || "POST" || "PUT" || "PATCH" || "OPTIONS" || "DELETE",
        ],
        CachedMethods: { // CachedMethods
          Quantity: Number("int"), // required
          Items: [ // required
            "GET" || "HEAD" || "POST" || "PUT" || "PATCH" || "OPTIONS" || "DELETE",
          ],
        },
      },
      SmoothStreaming: true || false,
      Compress: true || false,
      LambdaFunctionAssociations: { // LambdaFunctionAssociations
        Quantity: Number("int"), // required
        Items: [ // LambdaFunctionAssociationList
          { // LambdaFunctionAssociation
            LambdaFunctionARN: "STRING_VALUE", // required
            EventType: "viewer-request" || "viewer-response" || "origin-request" || "origin-response", // required
            IncludeBody: true || false,
          },
        ],
      },
      FunctionAssociations: { // FunctionAssociations
        Quantity: Number("int"), // required
        Items: [ // FunctionAssociationList
          { // FunctionAssociation
            FunctionARN: "STRING_VALUE", // required
            EventType: "viewer-request" || "viewer-response" || "origin-request" || "origin-response", // required
          },
        ],
      },
      FieldLevelEncryptionId: "STRING_VALUE",
      RealtimeLogConfigArn: "STRING_VALUE",
      CachePolicyId: "STRING_VALUE",
      OriginRequestPolicyId: "STRING_VALUE",
      ResponseHeadersPolicyId: "STRING_VALUE",
      GrpcConfig: { // GrpcConfig
        Enabled: true || false, // required
      },
      ForwardedValues: { // ForwardedValues
        QueryString: true || false, // required
        Cookies: { // CookiePreference
          Forward: "none" || "whitelist" || "all", // required
          WhitelistedNames: { // CookieNames
            Quantity: Number("int"), // required
            Items: [ // CookieNameList
              "STRING_VALUE",
            ],
          },
        },
        Headers: { // Headers
          Quantity: Number("int"), // required
          Items: [ // HeaderList
            "STRING_VALUE",
          ],
        },
        QueryStringCacheKeys: { // QueryStringCacheKeys
          Quantity: Number("int"), // required
          Items: [ // QueryStringCacheKeysList
            "STRING_VALUE",
          ],
        },
      },
      MinTTL: Number("long"),
      DefaultTTL: Number("long"),
      MaxTTL: Number("long"),
    },
    CacheBehaviors: { // CacheBehaviors
      Quantity: Number("int"), // required
      Items: [ // CacheBehaviorList
        { // CacheBehavior
          PathPattern: "STRING_VALUE", // required
          TargetOriginId: "STRING_VALUE", // required
          TrustedSigners: {
            Enabled: true || false, // required
            Quantity: Number("int"), // required
            Items: [
              "STRING_VALUE",
            ],
          },
          TrustedKeyGroups: {
            Enabled: true || false, // required
            Quantity: Number("int"), // required
            Items: [
              "STRING_VALUE",
            ],
          },
          ViewerProtocolPolicy: "allow-all" || "https-only" || "redirect-to-https", // required
          AllowedMethods: {
            Quantity: Number("int"), // required
            Items: "<MethodsList>", // required
            CachedMethods: {
              Quantity: Number("int"), // required
              Items: "<MethodsList>", // required
            },
          },
          SmoothStreaming: true || false,
          Compress: true || false,
          LambdaFunctionAssociations: {
            Quantity: Number("int"), // required
            Items: [
              {
                LambdaFunctionARN: "STRING_VALUE", // required
                EventType: "viewer-request" || "viewer-response" || "origin-request" || "origin-response", // required
                IncludeBody: true || false,
              },
            ],
          },
          FunctionAssociations: {
            Quantity: Number("int"), // required
            Items: [
              {
                FunctionARN: "STRING_VALUE", // required
                EventType: "viewer-request" || "viewer-response" || "origin-request" || "origin-response", // required
              },
            ],
          },
          FieldLevelEncryptionId: "STRING_VALUE",
          RealtimeLogConfigArn: "STRING_VALUE",
          CachePolicyId: "STRING_VALUE",
          OriginRequestPolicyId: "STRING_VALUE",
          ResponseHeadersPolicyId: "STRING_VALUE",
          GrpcConfig: {
            Enabled: true || false, // required
          },
          ForwardedValues: {
            QueryString: true || false, // required
            Cookies: {
              Forward: "none" || "whitelist" || "all", // required
              WhitelistedNames: {
                Quantity: Number("int"), // required
                Items: [
                  "STRING_VALUE",
                ],
              },
            },
            Headers: {
              Quantity: Number("int"), // required
              Items: [
                "STRING_VALUE",
              ],
            },
            QueryStringCacheKeys: {
              Quantity: Number("int"), // required
              Items: [
                "STRING_VALUE",
              ],
            },
          },
          MinTTL: Number("long"),
          DefaultTTL: Number("long"),
          MaxTTL: Number("long"),
        },
      ],
    },
    CustomErrorResponses: { // CustomErrorResponses
      Quantity: Number("int"), // required
      Items: [ // CustomErrorResponseList
        { // CustomErrorResponse
          ErrorCode: Number("int"), // required
          ResponsePagePath: "STRING_VALUE",
          ResponseCode: "STRING_VALUE",
          ErrorCachingMinTTL: Number("long"),
        },
      ],
    },
    Comment: "STRING_VALUE", // required
    Logging: { // LoggingConfig
      Enabled: true || false,
      IncludeCookies: true || false,
      Bucket: "STRING_VALUE",
      Prefix: "STRING_VALUE",
    },
    PriceClass: "PriceClass_100" || "PriceClass_200" || "PriceClass_All",
    Enabled: true || false, // required
    ViewerCertificate: { // ViewerCertificate
      CloudFrontDefaultCertificate: true || false,
      IAMCertificateId: "STRING_VALUE",
      ACMCertificateArn: "STRING_VALUE",
      SSLSupportMethod: "sni-only" || "vip" || "static-ip",
      MinimumProtocolVersion: "SSLv3" || "TLSv1" || "TLSv1_2016" || "TLSv1.1_2016" || "TLSv1.2_2018" || "TLSv1.2_2019" || "TLSv1.2_2021",
      Certificate: "STRING_VALUE",
      CertificateSource: "cloudfront" || "iam" || "acm",
    },
    Restrictions: { // Restrictions
      GeoRestriction: { // GeoRestriction
        RestrictionType: "blacklist" || "whitelist" || "none", // required
        Quantity: Number("int"), // required
        Items: [ // LocationList
          "STRING_VALUE",
        ],
      },
    },
    WebACLId: "STRING_VALUE",
    HttpVersion: "http1.1" || "http2" || "http3" || "http2and3",
    IsIPV6Enabled: true || false,
    ContinuousDeploymentPolicyId: "STRING_VALUE",
    Staging: true || false,
    AnycastIpListId: "STRING_VALUE",
  },
};
const command = new CreateDistributionCommand(input);
const response = await client.send(command);
// { // CreateDistributionResult
//   Distribution: { // Distribution
//     Id: "STRING_VALUE", // required
//     ARN: "STRING_VALUE", // required
//     Status: "STRING_VALUE", // required
//     LastModifiedTime: new Date("TIMESTAMP"), // required
//     InProgressInvalidationBatches: Number("int"), // required
//     DomainName: "STRING_VALUE", // required
//     ActiveTrustedSigners: { // ActiveTrustedSigners
//       Enabled: true || false, // required
//       Quantity: Number("int"), // required
//       Items: [ // SignerList
//         { // Signer
//           AwsAccountNumber: "STRING_VALUE",
//           KeyPairIds: { // KeyPairIds
//             Quantity: Number("int"), // required
//             Items: [ // KeyPairIdList
//               "STRING_VALUE",
//             ],
//           },
//         },
//       ],
//     },
//     ActiveTrustedKeyGroups: { // ActiveTrustedKeyGroups
//       Enabled: true || false, // required
//       Quantity: Number("int"), // required
//       Items: [ // KGKeyPairIdsList
//         { // KGKeyPairIds
//           KeyGroupId: "STRING_VALUE",
//           KeyPairIds: {
//             Quantity: Number("int"), // required
//             Items: [
//               "STRING_VALUE",
//             ],
//           },
//         },
//       ],
//     },
//     DistributionConfig: { // DistributionConfig
//       CallerReference: "STRING_VALUE", // required
//       Aliases: { // Aliases
//         Quantity: Number("int"), // required
//         Items: [ // AliasList
//           "STRING_VALUE",
//         ],
//       },
//       DefaultRootObject: "STRING_VALUE",
//       Origins: { // Origins
//         Quantity: Number("int"), // required
//         Items: [ // OriginList // required
//           { // Origin
//             Id: "STRING_VALUE", // required
//             DomainName: "STRING_VALUE", // required
//             OriginPath: "STRING_VALUE",
//             CustomHeaders: { // CustomHeaders
//               Quantity: Number("int"), // required
//               Items: [ // OriginCustomHeadersList
//                 { // OriginCustomHeader
//                   HeaderName: "STRING_VALUE", // required
//                   HeaderValue: "STRING_VALUE", // required
//                 },
//               ],
//             },
//             S3OriginConfig: { // S3OriginConfig
//               OriginAccessIdentity: "STRING_VALUE", // required
//             },
//             CustomOriginConfig: { // CustomOriginConfig
//               HTTPPort: Number("int"), // required
//               HTTPSPort: Number("int"), // required
//               OriginProtocolPolicy: "http-only" || "match-viewer" || "https-only", // required
//               OriginSslProtocols: { // OriginSslProtocols
//                 Quantity: Number("int"), // required
//                 Items: [ // SslProtocolsList // required
//                   "SSLv3" || "TLSv1" || "TLSv1.1" || "TLSv1.2",
//                 ],
//               },
//               OriginReadTimeout: Number("int"),
//               OriginKeepaliveTimeout: Number("int"),
//             },
//             VpcOriginConfig: { // VpcOriginConfig
//               VpcOriginId: "STRING_VALUE", // required
//               OriginReadTimeout: Number("int"),
//               OriginKeepaliveTimeout: Number("int"),
//             },
//             ConnectionAttempts: Number("int"),
//             ConnectionTimeout: Number("int"),
//             OriginShield: { // OriginShield
//               Enabled: true || false, // required
//               OriginShieldRegion: "STRING_VALUE",
//             },
//             OriginAccessControlId: "STRING_VALUE",
//           },
//         ],
//       },
//       OriginGroups: { // OriginGroups
//         Quantity: Number("int"), // required
//         Items: [ // OriginGroupList
//           { // OriginGroup
//             Id: "STRING_VALUE", // required
//             FailoverCriteria: { // OriginGroupFailoverCriteria
//               StatusCodes: { // StatusCodes
//                 Quantity: Number("int"), // required
//                 Items: [ // StatusCodeList // required
//                   Number("int"),
//                 ],
//               },
//             },
//             Members: { // OriginGroupMembers
//               Quantity: Number("int"), // required
//               Items: [ // OriginGroupMemberList // required
//                 { // OriginGroupMember
//                   OriginId: "STRING_VALUE", // required
//                 },
//               ],
//             },
//             SelectionCriteria: "default" || "media-quality-based",
//           },
//         ],
//       },
//       DefaultCacheBehavior: { // DefaultCacheBehavior
//         TargetOriginId: "STRING_VALUE", // required
//         TrustedSigners: { // TrustedSigners
//           Enabled: true || false, // required
//           Quantity: Number("int"), // required
//           Items: [ // AwsAccountNumberList
//             "STRING_VALUE",
//           ],
//         },
//         TrustedKeyGroups: { // TrustedKeyGroups
//           Enabled: true || false, // required
//           Quantity: Number("int"), // required
//           Items: [ // TrustedKeyGroupIdList
//             "STRING_VALUE",
//           ],
//         },
//         ViewerProtocolPolicy: "allow-all" || "https-only" || "redirect-to-https", // required
//         AllowedMethods: { // AllowedMethods
//           Quantity: Number("int"), // required
//           Items: [ // MethodsList // required
//             "GET" || "HEAD" || "POST" || "PUT" || "PATCH" || "OPTIONS" || "DELETE",
//           ],
//           CachedMethods: { // CachedMethods
//             Quantity: Number("int"), // required
//             Items: [ // required
//               "GET" || "HEAD" || "POST" || "PUT" || "PATCH" || "OPTIONS" || "DELETE",
//             ],
//           },
//         },
//         SmoothStreaming: true || false,
//         Compress: true || false,
//         LambdaFunctionAssociations: { // LambdaFunctionAssociations
//           Quantity: Number("int"), // required
//           Items: [ // LambdaFunctionAssociationList
//             { // LambdaFunctionAssociation
//               LambdaFunctionARN: "STRING_VALUE", // required
//               EventType: "viewer-request" || "viewer-response" || "origin-request" || "origin-response", // required
//               IncludeBody: true || false,
//             },
//           ],
//         },
//         FunctionAssociations: { // FunctionAssociations
//           Quantity: Number("int"), // required
//           Items: [ // FunctionAssociationList
//             { // FunctionAssociation
//               FunctionARN: "STRING_VALUE", // required
//               EventType: "viewer-request" || "viewer-response" || "origin-request" || "origin-response", // required
//             },
//           ],
//         },
//         FieldLevelEncryptionId: "STRING_VALUE",
//         RealtimeLogConfigArn: "STRING_VALUE",
//         CachePolicyId: "STRING_VALUE",
//         OriginRequestPolicyId: "STRING_VALUE",
//         ResponseHeadersPolicyId: "STRING_VALUE",
//         GrpcConfig: { // GrpcConfig
//           Enabled: true || false, // required
//         },
//         ForwardedValues: { // ForwardedValues
//           QueryString: true || false, // required
//           Cookies: { // CookiePreference
//             Forward: "none" || "whitelist" || "all", // required
//             WhitelistedNames: { // CookieNames
//               Quantity: Number("int"), // required
//               Items: [ // CookieNameList
//                 "STRING_VALUE",
//               ],
//             },
//           },
//           Headers: { // Headers
//             Quantity: Number("int"), // required
//             Items: [ // HeaderList
//               "STRING_VALUE",
//             ],
//           },
//           QueryStringCacheKeys: { // QueryStringCacheKeys
//             Quantity: Number("int"), // required
//             Items: [ // QueryStringCacheKeysList
//               "STRING_VALUE",
//             ],
//           },
//         },
//         MinTTL: Number("long"),
//         DefaultTTL: Number("long"),
//         MaxTTL: Number("long"),
//       },
//       CacheBehaviors: { // CacheBehaviors
//         Quantity: Number("int"), // required
//         Items: [ // CacheBehaviorList
//           { // CacheBehavior
//             PathPattern: "STRING_VALUE", // required
//             TargetOriginId: "STRING_VALUE", // required
//             TrustedSigners: {
//               Enabled: true || false, // required
//               Quantity: Number("int"), // required
//               Items: [
//                 "STRING_VALUE",
//               ],
//             },
//             TrustedKeyGroups: {
//               Enabled: true || false, // required
//               Quantity: Number("int"), // required
//               Items: [
//                 "STRING_VALUE",
//               ],
//             },
//             ViewerProtocolPolicy: "allow-all" || "https-only" || "redirect-to-https", // required
//             AllowedMethods: {
//               Quantity: Number("int"), // required
//               Items: "<MethodsList>", // required
//               CachedMethods: {
//                 Quantity: Number("int"), // required
//                 Items: "<MethodsList>", // required
//               },
//             },
//             SmoothStreaming: true || false,
//             Compress: true || false,
//             LambdaFunctionAssociations: {
//               Quantity: Number("int"), // required
//               Items: [
//                 {
//                   LambdaFunctionARN: "STRING_VALUE", // required
//                   EventType: "viewer-request" || "viewer-response" || "origin-request" || "origin-response", // required
//                   IncludeBody: true || false,
//                 },
//               ],
//             },
//             FunctionAssociations: {
//               Quantity: Number("int"), // required
//               Items: [
//                 {
//                   FunctionARN: "STRING_VALUE", // required
//                   EventType: "viewer-request" || "viewer-response" || "origin-request" || "origin-response", // required
//                 },
//               ],
//             },
//             FieldLevelEncryptionId: "STRING_VALUE",
//             RealtimeLogConfigArn: "STRING_VALUE",
//             CachePolicyId: "STRING_VALUE",
//             OriginRequestPolicyId: "STRING_VALUE",
//             ResponseHeadersPolicyId: "STRING_VALUE",
//             GrpcConfig: {
//               Enabled: true || false, // required
//             },
//             ForwardedValues: {
//               QueryString: true || false, // required
//               Cookies: {
//                 Forward: "none" || "whitelist" || "all", // required
//                 WhitelistedNames: {
//                   Quantity: Number("int"), // required
//                   Items: [
//                     "STRING_VALUE",
//                   ],
//                 },
//               },
//               Headers: {
//                 Quantity: Number("int"), // required
//                 Items: [
//                   "STRING_VALUE",
//                 ],
//               },
//               QueryStringCacheKeys: {
//                 Quantity: Number("int"), // required
//                 Items: [
//                   "STRING_VALUE",
//                 ],
//               },
//             },
//             MinTTL: Number("long"),
//             DefaultTTL: Number("long"),
//             MaxTTL: Number("long"),
//           },
//         ],
//       },
//       CustomErrorResponses: { // CustomErrorResponses
//         Quantity: Number("int"), // required
//         Items: [ // CustomErrorResponseList
//           { // CustomErrorResponse
//             ErrorCode: Number("int"), // required
//             ResponsePagePath: "STRING_VALUE",
//             ResponseCode: "STRING_VALUE",
//             ErrorCachingMinTTL: Number("long"),
//           },
//         ],
//       },
//       Comment: "STRING_VALUE", // required
//       Logging: { // LoggingConfig
//         Enabled: true || false,
//         IncludeCookies: true || false,
//         Bucket: "STRING_VALUE",
//         Prefix: "STRING_VALUE",
//       },
//       PriceClass: "PriceClass_100" || "PriceClass_200" || "PriceClass_All",
//       Enabled: true || false, // required
//       ViewerCertificate: { // ViewerCertificate
//         CloudFrontDefaultCertificate: true || false,
//         IAMCertificateId: "STRING_VALUE",
//         ACMCertificateArn: "STRING_VALUE",
//         SSLSupportMethod: "sni-only" || "vip" || "static-ip",
//         MinimumProtocolVersion: "SSLv3" || "TLSv1" || "TLSv1_2016" || "TLSv1.1_2016" || "TLSv1.2_2018" || "TLSv1.2_2019" || "TLSv1.2_2021",
//         Certificate: "STRING_VALUE",
//         CertificateSource: "cloudfront" || "iam" || "acm",
//       },
//       Restrictions: { // Restrictions
//         GeoRestriction: { // GeoRestriction
//           RestrictionType: "blacklist" || "whitelist" || "none", // required
//           Quantity: Number("int"), // required
//           Items: [ // LocationList
//             "STRING_VALUE",
//           ],
//         },
//       },
//       WebACLId: "STRING_VALUE",
//       HttpVersion: "http1.1" || "http2" || "http3" || "http2and3",
//       IsIPV6Enabled: true || false,
//       ContinuousDeploymentPolicyId: "STRING_VALUE",
//       Staging: true || false,
//       AnycastIpListId: "STRING_VALUE",
//     },
//     AliasICPRecordals: [ // AliasICPRecordals
//       { // AliasICPRecordal
//         CNAME: "STRING_VALUE",
//         ICPRecordalStatus: "APPROVED" || "SUSPENDED" || "PENDING",
//       },
//     ],
//   },
//   Location: "STRING_VALUE",
//   ETag: "STRING_VALUE",
// };

CreateDistributionCommand Input

See CreateDistributionCommandInput for more details

Parameter
Type
Description
DistributionConfig
Required
DistributionConfig | undefined

The distribution's configuration information.

CreateDistributionCommand Output

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
Distribution
Distribution | undefined

The distribution's information.

ETag
string | undefined

The current version of the distribution created.

Location
string | undefined

The fully qualified URI of the new distribution resource just created.

Throws

Name
Fault
Details
AccessDenied
client

Access denied.

CNAMEAlreadyExists
client

The CNAME specified is already defined for CloudFront.

ContinuousDeploymentPolicyInUse
client

You cannot delete a continuous deployment policy that is associated with a primary distribution.

DistributionAlreadyExists
client

The caller reference you attempted to create the distribution with is associated with another distribution.

EntityNotFound
client

The entity was not found.

IllegalFieldLevelEncryptionConfigAssociationWithCacheBehavior
client

The specified configuration for field-level encryption can't be associated with the specified cache behavior.

IllegalOriginAccessConfiguration
client

An origin cannot contain both an origin access control (OAC) and an origin access identity (OAI).

InconsistentQuantities
client

The value of Quantity and the size of Items don't match.

InvalidArgument
client

An argument is invalid.

InvalidDefaultRootObject
client

The default root object file name is too big or contains an invalid character.

InvalidDomainNameForOriginAccessControl
client

An origin access control is associated with an origin whose domain name is not supported.

InvalidErrorCode
client

An invalid error code was specified.

InvalidForwardCookies
client

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

InvalidFunctionAssociation
client

A CloudFront function association is invalid.

InvalidGeoRestrictionParameter
client

The specified geo restriction parameter is not valid.

InvalidHeadersForS3Origin
client

The headers specified are not valid for an Amazon S3 origin.

InvalidLambdaFunctionAssociation
client

The specified LambdaEdge function association is invalid.

InvalidLocationCode
client

The location code specified is not valid.

InvalidMinimumProtocolVersion
client

The minimum protocol version specified is not valid.

InvalidOrigin
client

The Amazon S3 origin server specified does not refer to a valid Amazon S3 bucket.

InvalidOriginAccessControl
client

The origin access control is not valid.

InvalidOriginAccessIdentity
client

The origin access identity is not valid or doesn't exist.

InvalidOriginKeepaliveTimeout
client

The keep alive timeout specified for the origin is not valid.

InvalidOriginReadTimeout
client

The read timeout specified for the origin is not valid.

InvalidProtocolSettings
client

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

InvalidQueryStringParameters
client

The query string parameters specified are not valid.

InvalidRelativePath
client

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

InvalidRequiredProtocol
client

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

InvalidResponseCode
client

A response code is not valid.

InvalidTTLOrder
client

The TTL order specified is not valid.

InvalidViewerCertificate
client

A viewer certificate specified is not valid.

InvalidWebACLId
client

A web ACL ID specified is not valid. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/473e64fd-f30b-4765-81a0-62ad96dd167a. To specify a web ACL created using WAF Classic, use the ACL ID, for example 473e64fd-f30b-4765-81a0-62ad96dd167a.

MissingBody
client

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

NoSuchCachePolicy
client

The cache policy does not exist.

NoSuchContinuousDeploymentPolicy
client

The continuous deployment policy doesn't exist.

NoSuchFieldLevelEncryptionConfig
client

The specified configuration for field-level encryption doesn't exist.

NoSuchOrigin
client

No origin exists with the specified Origin Id.

NoSuchOriginRequestPolicy
client

The origin request policy does not exist.

NoSuchRealtimeLogConfig
client

The real-time log configuration does not exist.

NoSuchResponseHeadersPolicy
client

The response headers policy does not exist.

RealtimeLogConfigOwnerMismatch
client

The specified real-time log configuration belongs to a different Amazon Web Services account.

TooManyCacheBehaviors
client

You cannot create more cache behaviors for the distribution.

TooManyCertificates
client

You cannot create anymore custom SSL/TLS certificates.

TooManyCookieNamesInWhiteList
client

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

TooManyDistributionCNAMEs
client

Your request contains more CNAMEs than are allowed per distribution.

TooManyDistributions
client

Processing your request would cause you to exceed the maximum number of distributions allowed.

TooManyDistributionsAssociatedToCachePolicy
client

The maximum number of distributions have been associated with the specified cache policy. For more information, see Quotas  (formerly known as limits) in the Amazon CloudFront Developer Guide.

TooManyDistributionsAssociatedToFieldLevelEncryptionConfig
client

The maximum number of distributions have been associated with the specified configuration for field-level encryption.

TooManyDistributionsAssociatedToKeyGroup
client

The number of distributions that reference this key group is more than the maximum allowed. For more information, see Quotas  (formerly known as limits) in the Amazon CloudFront Developer Guide.

TooManyDistributionsAssociatedToOriginAccessControl
client

The maximum number of distributions have been associated with the specified origin access control.

For more information, see Quotas  (formerly known as limits) in the Amazon CloudFront Developer Guide.

TooManyDistributionsAssociatedToOriginRequestPolicy
client

The maximum number of distributions have been associated with the specified origin request policy. For more information, see Quotas  (formerly known as limits) in the Amazon CloudFront Developer Guide.

TooManyDistributionsAssociatedToResponseHeadersPolicy
client

The maximum number of distributions have been associated with the specified response headers policy.

For more information, see Quotas  (formerly known as limits) in the Amazon CloudFront Developer Guide.

TooManyDistributionsWithFunctionAssociations
client

You have reached the maximum number of distributions that are associated with a CloudFront function. For more information, see Quotas  (formerly known as limits) in the Amazon CloudFront Developer Guide.

TooManyDistributionsWithLambdaAssociations
client

Processing your request would cause the maximum number of distributions with LambdaEdge function associations per owner to be exceeded.

TooManyDistributionsWithSingleFunctionARN
client

The maximum number of distributions have been associated with the specified LambdaEdge function.

TooManyFunctionAssociations
client

You have reached the maximum number of CloudFront function associations for this distribution. For more information, see Quotas  (formerly known as limits) in the Amazon CloudFront Developer Guide.

TooManyHeadersInForwardedValues
client

Your request contains too many headers in forwarded values.

TooManyKeyGroupsAssociatedToDistribution
client

The number of key groups referenced by this distribution is more than the maximum allowed. For more information, see Quotas  (formerly known as limits) in the Amazon CloudFront Developer Guide.

TooManyLambdaFunctionAssociations
client

Your request contains more LambdaEdge function associations than are allowed per distribution.

TooManyOriginCustomHeaders
client

Your request contains too many origin custom headers.

TooManyOriginGroupsPerDistribution
client

Processing your request would cause you to exceed the maximum number of origin groups allowed.

TooManyOrigins
client

You cannot create more origins for the distribution.

TooManyQueryStringParameters
client

Your request contains too many query string parameters.

TooManyTrustedSigners
client

Your request contains more trusted signers than are allowed per distribution.

TrustedKeyGroupDoesNotExist
client

The specified key group does not exist.

TrustedSignerDoesNotExist
client

One or more of your trusted signers don't exist.

CloudFrontServiceException
Base exception class for all service exceptions from CloudFront service.