@aws-sdk/client-cloudfront 3.213.0 → 3.214.0

package/dist-types/commands/GetContinuousDeploymentPolicyCommand.d.ts

@@ -0,0 +1,38 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { CloudFrontClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudFrontClient";
+import { GetContinuousDeploymentPolicyRequest, GetContinuousDeploymentPolicyResult } from "../models/models_1";
+export interface GetContinuousDeploymentPolicyCommandInput extends GetContinuousDeploymentPolicyRequest {
+}
+export interface GetContinuousDeploymentPolicyCommandOutput extends GetContinuousDeploymentPolicyResult, __MetadataBearer {
+}
+/**
+ * <p>Gets a continuous deployment policy, including metadata (the policy’s identifier and
+ * 			the date and time when the policy was last modified).</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudFrontClient, GetContinuousDeploymentPolicyCommand } from "@aws-sdk/client-cloudfront"; // ES Modules import
+ * // const { CloudFrontClient, GetContinuousDeploymentPolicyCommand } = require("@aws-sdk/client-cloudfront"); // CommonJS import
+ * const client = new CloudFrontClient(config);
+ * const command = new GetContinuousDeploymentPolicyCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link GetContinuousDeploymentPolicyCommandInput} for command's `input` shape.
+ * @see {@link GetContinuousDeploymentPolicyCommandOutput} for command's `response` shape.
+ * @see {@link CloudFrontClientResolvedConfig | config} for CloudFrontClient's `config` shape.
+ *
+ */
+export declare class GetContinuousDeploymentPolicyCommand extends $Command<GetContinuousDeploymentPolicyCommandInput, GetContinuousDeploymentPolicyCommandOutput, CloudFrontClientResolvedConfig> {
+    readonly input: GetContinuousDeploymentPolicyCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    constructor(input: GetContinuousDeploymentPolicyCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudFrontClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetContinuousDeploymentPolicyCommandInput, GetContinuousDeploymentPolicyCommandOutput>;
+    private serialize;
+    private deserialize;
+}

package/dist-types/commands/GetContinuousDeploymentPolicyConfigCommand.d.ts

@@ -0,0 +1,37 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { CloudFrontClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudFrontClient";
+import { GetContinuousDeploymentPolicyConfigRequest, GetContinuousDeploymentPolicyConfigResult } from "../models/models_1";
+export interface GetContinuousDeploymentPolicyConfigCommandInput extends GetContinuousDeploymentPolicyConfigRequest {
+}
+export interface GetContinuousDeploymentPolicyConfigCommandOutput extends GetContinuousDeploymentPolicyConfigResult, __MetadataBearer {
+}
+/**
+ * <p>Gets configuration information about a continuous deployment policy.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudFrontClient, GetContinuousDeploymentPolicyConfigCommand } from "@aws-sdk/client-cloudfront"; // ES Modules import
+ * // const { CloudFrontClient, GetContinuousDeploymentPolicyConfigCommand } = require("@aws-sdk/client-cloudfront"); // CommonJS import
+ * const client = new CloudFrontClient(config);
+ * const command = new GetContinuousDeploymentPolicyConfigCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link GetContinuousDeploymentPolicyConfigCommandInput} for command's `input` shape.
+ * @see {@link GetContinuousDeploymentPolicyConfigCommandOutput} for command's `response` shape.
+ * @see {@link CloudFrontClientResolvedConfig | config} for CloudFrontClient's `config` shape.
+ *
+ */
+export declare class GetContinuousDeploymentPolicyConfigCommand extends $Command<GetContinuousDeploymentPolicyConfigCommandInput, GetContinuousDeploymentPolicyConfigCommandOutput, CloudFrontClientResolvedConfig> {
+    readonly input: GetContinuousDeploymentPolicyConfigCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    constructor(input: GetContinuousDeploymentPolicyConfigCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudFrontClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetContinuousDeploymentPolicyConfigCommandInput, GetContinuousDeploymentPolicyConfigCommandOutput>;
+    private serialize;
+    private deserialize;
+}

package/dist-types/commands/ListContinuousDeploymentPoliciesCommand.d.ts

@@ -0,0 +1,42 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { CloudFrontClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudFrontClient";
+import { ListContinuousDeploymentPoliciesRequest, ListContinuousDeploymentPoliciesResult } from "../models/models_1";
+export interface ListContinuousDeploymentPoliciesCommandInput extends ListContinuousDeploymentPoliciesRequest {
+}
+export interface ListContinuousDeploymentPoliciesCommandOutput extends ListContinuousDeploymentPoliciesResult, __MetadataBearer {
+}
+/**
+ * <p>Gets a list of the continuous deployment policies in your Amazon Web Services account.</p>
+ * 		       <p>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 <code>NextMarker</code> value from the current
+ * 			response as the <code>Marker</code> value in the subsequent request.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudFrontClient, ListContinuousDeploymentPoliciesCommand } from "@aws-sdk/client-cloudfront"; // ES Modules import
+ * // const { CloudFrontClient, ListContinuousDeploymentPoliciesCommand } = require("@aws-sdk/client-cloudfront"); // CommonJS import
+ * const client = new CloudFrontClient(config);
+ * const command = new ListContinuousDeploymentPoliciesCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link ListContinuousDeploymentPoliciesCommandInput} for command's `input` shape.
+ * @see {@link ListContinuousDeploymentPoliciesCommandOutput} for command's `response` shape.
+ * @see {@link CloudFrontClientResolvedConfig | config} for CloudFrontClient's `config` shape.
+ *
+ */
+export declare class ListContinuousDeploymentPoliciesCommand extends $Command<ListContinuousDeploymentPoliciesCommandInput, ListContinuousDeploymentPoliciesCommandOutput, CloudFrontClientResolvedConfig> {
+    readonly input: ListContinuousDeploymentPoliciesCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    constructor(input: ListContinuousDeploymentPoliciesCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudFrontClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListContinuousDeploymentPoliciesCommandInput, ListContinuousDeploymentPoliciesCommandOutput>;
+    private serialize;
+    private deserialize;
+}

package/dist-types/commands/UpdateContinuousDeploymentPolicyCommand.d.ts

@@ -0,0 +1,57 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { CloudFrontClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudFrontClient";
+import { UpdateContinuousDeploymentPolicyRequest, UpdateContinuousDeploymentPolicyResult } from "../models/models_1";
+export interface UpdateContinuousDeploymentPolicyCommandInput extends UpdateContinuousDeploymentPolicyRequest {
+}
+export interface UpdateContinuousDeploymentPolicyCommandOutput extends UpdateContinuousDeploymentPolicyResult, __MetadataBearer {
+}
+/**
+ * <p>Updates a continuous deployment policy. You can update a continuous deployment policy to
+ * 			enable or disable it, to change the percentage of traffic that it sends to the staging
+ * 			distribution, or to change the staging distribution that it sends traffic to.</p>
+ * 		       <p>When you update a continuous deployment policy configuration, all the fields are
+ * 			updated with the values that are provided in the request. You cannot update some fields
+ * 			independent of others. To update a continuous deployment policy configuration:</p>
+ * 		       <ol>
+ *             <li>
+ * 				           <p>Use <code>GetContinuousDeploymentPolicyConfig</code> to get the current
+ * 					configuration.</p>
+ * 			         </li>
+ *             <li>
+ * 				           <p>Locally modify the fields in the continuous deployment policy configuration
+ * 					that you want to update.</p>
+ * 			         </li>
+ *             <li>
+ * 				           <p>Use <code>UpdateContinuousDeploymentPolicy</code>, providing the entire
+ * 					continuous deployment policy configuration, including the fields that you
+ * 					modified and those that you didn’t.</p>
+ * 			         </li>
+ *          </ol>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { CloudFrontClient, UpdateContinuousDeploymentPolicyCommand } from "@aws-sdk/client-cloudfront"; // ES Modules import
+ * // const { CloudFrontClient, UpdateContinuousDeploymentPolicyCommand } = require("@aws-sdk/client-cloudfront"); // CommonJS import
+ * const client = new CloudFrontClient(config);
+ * const command = new UpdateContinuousDeploymentPolicyCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link UpdateContinuousDeploymentPolicyCommandInput} for command's `input` shape.
+ * @see {@link UpdateContinuousDeploymentPolicyCommandOutput} for command's `response` shape.
+ * @see {@link CloudFrontClientResolvedConfig | config} for CloudFrontClient's `config` shape.
+ *
+ */
+export declare class UpdateContinuousDeploymentPolicyCommand extends $Command<UpdateContinuousDeploymentPolicyCommandInput, UpdateContinuousDeploymentPolicyCommandOutput, CloudFrontClientResolvedConfig> {
+    readonly input: UpdateContinuousDeploymentPolicyCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    constructor(input: UpdateContinuousDeploymentPolicyCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: CloudFrontClientResolvedConfig, options?: __HttpHandlerOptions): Handler<UpdateContinuousDeploymentPolicyCommandInput, UpdateContinuousDeploymentPolicyCommandOutput>;
+    private serialize;
+    private deserialize;
+}

package/dist-types/commands/UpdateDistributionCommand.d.ts

@@ -8,83 +8,40 @@ export interface UpdateDistributionCommandInput extends UpdateDistributionReques
 export interface UpdateDistributionCommandOutput extends UpdateDistributionResult, __MetadataBearer {
 }
 /**
- * <p>Updates the configuration for a web distribution. </p>
- * 		       <important>
- *             <p>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 <a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-overview-required-fields.html">Required
- * 				Fields for Create Distribution and Update Distribution</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
- *          </important>
- * 		       <p>The update process includes getting the current distribution configuration, updating the XML document that is
- * 			returned to make your changes, and then submitting an <code>UpdateDistribution</code> request to make the updates.</p>
- * 		       <p>For information about updating a distribution using the CloudFront console instead, see
- * 			<a href="https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html">Creating a
- * 				Distribution</a> in the <i>Amazon CloudFront Developer Guide</i>.</p>
+ * <p>Updates the configuration for a CloudFront distribution.</p>
+ * 		       <p>The update process includes getting the current distribution configuration, updating it to
+ * 			make your changes, and then submitting an <code>UpdateDistribution</code> request to
+ * 			make the updates.</p>
  *
  * 		       <p>
  *             <b>To update a web distribution using the CloudFront API</b>
  *          </p>
  * 		       <ol>
  *             <li>
- *                <p>Submit a
- * 				<a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetDistributionConfig.html">GetDistributionConfig</a>
- * 				request to get the current configuration and an <code>Etag</code> header
- * 				for the distribution.</p>
- * 				           <note>
- *                   <p>If you update the distribution again, you must get a new <code>Etag</code> header.</p>
- *                </note>
+ *                <p>Use <code>GetDistributionConfig</code> to get the current configuration, including the version
+ * 					identifier (<code>ETag</code>).</p>
  * 			         </li>
  *             <li>
- *                <p>Update the XML document that was returned in the response to your <code>GetDistributionConfig</code> request to include
- * 				your changes. </p>
- * 				           <important>
- * 					             <p>When you edit the XML file, be aware of the following:</p>
- * 					             <ul>
- *                      <li>
- *                         <p>You must strip out the ETag parameter that is returned.</p>
- *                      </li>
- *                      <li>
- *                         <p>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.</p>
- *                      </li>
- *                      <li>
- *                         <p>You can't change the value of <code>CallerReference</code>. If you try to change this value, CloudFront returns an
- * 							<code>IllegalUpdate</code> error. </p>
- *                      </li>
- *                      <li>
- *                         <p>The new configuration replaces the existing configuration; the values that you specify in an
- * 							<code>UpdateDistribution</code> request are not merged into your existing configuration. When you add, delete, or
- * 							replace values in an element that allows multiple values (for example, <code>CNAME</code>), you must specify all of the
- * 							values that you want to appear in the updated distribution. In addition,
- * 							you must update the corresponding <code>Quantity</code> element.</p>
- *                      </li>
- *                   </ul>
- *                </important>
- * 			         </li>
- *             <li>
- *                <p>Submit an <code>UpdateDistribution</code> request to update the configuration for your distribution:</p>
+ *                <p>Update the distribution configuration that was returned in the response. Note the following
+ * 					important requirements and restrictions:</p>
  * 				           <ul>
  *                   <li>
- *                      <p>In the request body, include the XML document that you updated in Step 2. The request body must include an
- * 						XML document with a <code>DistributionConfig</code> element.</p>
- *                   </li>
+ * 						               <p>You must rename the <code>ETag</code> field to <code>IfMatch</code>,
+ * 							leaving the value unchanged. (Set the value of <code>IfMatch</code> to
+ * 							the value of <code>ETag</code>, then remove the <code>ETag</code>
+ * 							field.)</p>
+ * 					             </li>
  *                   <li>
- *                      <p>Set the value of the HTTP <code>If-Match</code> header to the value of the <code>ETag</code> header that CloudFront returned
- * 						when you submitted the <code>GetDistributionConfig</code> request in Step 1.</p>
- *                   </li>
+ * 						               <p>You can’t change the value of <code>CallerReference</code>.</p>
+ * 					             </li>
  *                </ul>
  * 			         </li>
  *             <li>
- *                <p>Review the response to the <code>UpdateDistribution</code> request to confirm that the configuration was
- * 				successfully updated.</p>
- *             </li>
- *             <li>
- *                <p>Optional: Submit a
- * 				<a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetDistribution.html">GetDistribution</a>
- * 				request to confirm that your changes have propagated.
- * 				When propagation is complete, the value of <code>Status</code> is <code>Deployed</code>.</p>
+ *                <p>Submit an <code>UpdateDistribution</code> request, providing the distribution configuration.
+ * 					The new configuration replaces the existing configuration. The values that you
+ * 					specify in an <code>UpdateDistribution</code> request are not merged into your
+ * 					existing configuration. Make sure to include all fields: the ones that you
+ * 					modified and also the ones that you didn’t.</p>
  * 			         </li>
  *          </ol>
  * @example

package/dist-types/commands/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./AssociateAliasCommand";
+export * from "./CopyDistributionCommand";
 export * from "./CreateCachePolicyCommand";
 export * from "./CreateCloudFrontOriginAccessIdentityCommand";
+export * from "./CreateContinuousDeploymentPolicyCommand";
 export * from "./CreateDistributionCommand";
 export * from "./CreateDistributionWithTagsCommand";
 export * from "./CreateFieldLevelEncryptionConfigCommand";
@@ -18,6 +20,7 @@ export * from "./CreateStreamingDistributionCommand";
 export * from "./CreateStreamingDistributionWithTagsCommand";
 export * from "./DeleteCachePolicyCommand";
 export * from "./DeleteCloudFrontOriginAccessIdentityCommand";
+export * from "./DeleteContinuousDeploymentPolicyCommand";
 export * from "./DeleteDistributionCommand";
 export * from "./DeleteFieldLevelEncryptionConfigCommand";
 export * from "./DeleteFieldLevelEncryptionProfileCommand";
@@ -35,6 +38,8 @@ export * from "./GetCachePolicyCommand";
 export * from "./GetCachePolicyConfigCommand";
 export * from "./GetCloudFrontOriginAccessIdentityCommand";
 export * from "./GetCloudFrontOriginAccessIdentityConfigCommand";
+export * from "./GetContinuousDeploymentPolicyCommand";
+export * from "./GetContinuousDeploymentPolicyConfigCommand";
 export * from "./GetDistributionCommand";
 export * from "./GetDistributionConfigCommand";
 export * from "./GetFieldLevelEncryptionCommand";
@@ -60,6 +65,7 @@ export * from "./GetStreamingDistributionConfigCommand";
 export * from "./ListCachePoliciesCommand";
 export * from "./ListCloudFrontOriginAccessIdentitiesCommand";
 export * from "./ListConflictingAliasesCommand";
+export * from "./ListContinuousDeploymentPoliciesCommand";
 export * from "./ListDistributionsByCachePolicyIdCommand";
 export * from "./ListDistributionsByKeyGroupCommand";
 export * from "./ListDistributionsByOriginRequestPolicyIdCommand";
@@ -85,6 +91,7 @@ export * from "./TestFunctionCommand";
 export * from "./UntagResourceCommand";
 export * from "./UpdateCachePolicyCommand";
 export * from "./UpdateCloudFrontOriginAccessIdentityCommand";
+export * from "./UpdateContinuousDeploymentPolicyCommand";
 export * from "./UpdateDistributionCommand";
 export * from "./UpdateFieldLevelEncryptionConfigCommand";
 export * from "./UpdateFieldLevelEncryptionProfileCommand";

package/dist-types/endpoint/EndpointParameters.d.ts

@@ -12,7 +12,7 @@ export declare const resolveClientEndpointParameters: <T>(options: T & ClientInp
     defaultSigningName: string;
 };
 export interface EndpointParameters extends __EndpointParameters {
-    Region?: string;
+    Region: string;
     UseDualStack?: boolean;
     UseFIPS?: boolean;
     Endpoint?: string;