@aws-sdk/client-backup 3.901.0 → 3.904.0

package/dist-cjs/index.js

@@ -159,6 +159,7 @@ __export(index_exports, {
   RestoreValidationStatus: () => RestoreValidationStatus,
   RevokeRestoreAccessBackupVaultCommand: () => RevokeRestoreAccessBackupVaultCommand,
   RevokeRestoreAccessBackupVaultInputFilterSensitiveLog: () => RevokeRestoreAccessBackupVaultInputFilterSensitiveLog,
+  RuleExecutionType: () => RuleExecutionType,
   ServiceUnavailableException: () => ServiceUnavailableException,
   StartBackupJobCommand: () => StartBackupJobCommand,
   StartBackupJobInputFilterSensitiveLog: () => StartBackupJobInputFilterSensitiveLog,
@@ -877,6 +878,11 @@ var RestoreValidationStatus = {
   TIMED_OUT: "TIMED_OUT",
   VALIDATING: "VALIDATING"
 };
+var RuleExecutionType = {
+  CONTINUOUS: "CONTINUOUS",
+  CONTINUOUS_AND_SNAPSHOTS: "CONTINUOUS_AND_SNAPSHOTS",
+  SNAPSHOTS: "SNAPSHOTS"
+};
 var MpaRevokeSessionStatus = {
   FAILED: "FAILED",
   PENDING: "PENDING"
@@ -1501,7 +1507,8 @@ var se_GetBackupPlanCommand = /* @__PURE__ */ __name(async (input, context) => {
   b.bp("/backup/plans/{BackupPlanId}");
   b.p("BackupPlanId", () => input.BackupPlanId, "{BackupPlanId}", false);
   const query = (0, import_smithy_client.map)({
-    [_vI]: [, input[_VI]]
+    [_vI]: [, input[_VI]],
+    [_MSRP]: [() => input.MaxScheduledRunsPreview !== void 0, () => input[_MSRP].toString()]
   });
   let body;
   b.m("GET").h(headers).q(query).b(body);
@@ -3014,6 +3021,7 @@ var de_GetBackupPlanCommand = /* @__PURE__ */ __name(async (output, context) =>
     CreatorRequestId: import_smithy_client.expectString,
     DeletionDate: /* @__PURE__ */ __name((_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_))), "DeletionDate"),
     LastExecutionDate: /* @__PURE__ */ __name((_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_))), "LastExecutionDate"),
+    ScheduledRunsPreview: /* @__PURE__ */ __name((_) => de_ScheduledRunsPreview(_, context), "ScheduledRunsPreview"),
     VersionId: import_smithy_client.expectString
   });
   Object.assign(contents, doc);
@@ -4616,6 +4624,19 @@ var de_RestoreTestingSelections = /* @__PURE__ */ __name((output, context) => {
   });
   return retVal;
 }, "de_RestoreTestingSelections");
+var de_ScheduledPlanExecutionMember = /* @__PURE__ */ __name((output, context) => {
+  return (0, import_smithy_client.take)(output, {
+    ExecutionTime: /* @__PURE__ */ __name((_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_))), "ExecutionTime"),
+    RuleExecutionType: import_smithy_client.expectString,
+    RuleId: import_smithy_client.expectString
+  });
+}, "de_ScheduledPlanExecutionMember");
+var de_ScheduledRunsPreview = /* @__PURE__ */ __name((output, context) => {
+  const retVal = (output || []).filter((e) => e != null).map((entry) => {
+    return de_ScheduledPlanExecutionMember(entry, context);
+  });
+  return retVal;
+}, "de_ScheduledRunsPreview");
 var deserializeMetadata = /* @__PURE__ */ __name((output) => ({
   httpStatusCode: output.statusCode,
   requestId: output.headers["x-amzn-requestid"] ?? output.headers["x-amzn-request-id"] ?? output.headers["x-amz-request-id"],
@@ -4659,6 +4680,7 @@ var _IS = "IndexStatus";
 var _MBAWSBO = "ManagedByAWSBackupOnly";
 var _MC = "MessageCategory";
 var _MR = "MaxResults";
+var _MSRP = "MaxScheduledRunsPreview";
 var _NT = "NextToken";
 var _RC = "RequesterComment";
 var _RPA = "RecoveryPointArn";
@@ -6558,6 +6580,7 @@ var paginateListTags = (0, import_core.createPaginator)(BackupClient, ListTagsCo
   RestoreDeletionStatus,
   RestoreJobStatus,
   RestoreValidationStatus,
+  RuleExecutionType,
   MpaRevokeSessionStatus,
   RestoreJobState,
   Index,

package/dist-es/models/models_0.js

@@ -346,6 +346,11 @@ export const RestoreValidationStatus = {
     TIMED_OUT: "TIMED_OUT",
     VALIDATING: "VALIDATING",
 };
+export const RuleExecutionType = {
+    CONTINUOUS: "CONTINUOUS",
+    CONTINUOUS_AND_SNAPSHOTS: "CONTINUOUS_AND_SNAPSHOTS",
+    SNAPSHOTS: "SNAPSHOTS",
+};
 export const MpaRevokeSessionStatus = {
     FAILED: "FAILED",
     PENDING: "PENDING",

package/dist-es/protocols/Aws_restJson1.js

@@ -453,6 +453,7 @@ export const se_GetBackupPlanCommand = async (input, context) => {
     b.p("BackupPlanId", () => input.BackupPlanId, "{BackupPlanId}", false);
     const query = map({
         [_vI]: [, input[_VI]],
+        [_MSRP]: [() => input.MaxScheduledRunsPreview !== void 0, () => input[_MSRP].toString()],
     });
     let body;
     b.m("GET").h(headers).q(query).b(body);
@@ -1923,6 +1924,7 @@ export const de_GetBackupPlanCommand = async (output, context) => {
         CreatorRequestId: __expectString,
         DeletionDate: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         LastExecutionDate: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
+        ScheduledRunsPreview: (_) => de_ScheduledRunsPreview(_, context),
         VersionId: __expectString,
     });
     Object.assign(contents, doc);
@@ -3567,6 +3569,21 @@ const de_RestoreTestingSelections = (output, context) => {
     });
     return retVal;
 };
+const de_ScheduledPlanExecutionMember = (output, context) => {
+    return take(output, {
+        ExecutionTime: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
+        RuleExecutionType: __expectString,
+        RuleId: __expectString,
+    });
+};
+const de_ScheduledRunsPreview = (output, context) => {
+    const retVal = (output || [])
+        .filter((e) => e != null)
+        .map((entry) => {
+        return de_ScheduledPlanExecutionMember(entry, context);
+    });
+    return retVal;
+};
 const deserializeMetadata = (output) => ({
     httpStatusCode: output.statusCode,
     requestId: output.headers["x-amzn-requestid"] ?? output.headers["x-amzn-request-id"] ?? output.headers["x-amz-request-id"],
@@ -3611,6 +3628,7 @@ const _IS = "IndexStatus";
 const _MBAWSBO = "ManagedByAWSBackupOnly";
 const _MC = "MessageCategory";
 const _MR = "MaxResults";
+const _MSRP = "MaxScheduledRunsPreview";
 const _NT = "NextToken";
 const _RC = "RequesterComment";
 const _RPA = "RecoveryPointArn";

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

@@ -40,6 +40,7 @@ declare const GetBackupPlanCommand_base: {
  * const input = { // GetBackupPlanInput
  *   BackupPlanId: "STRING_VALUE", // required
  *   VersionId: "STRING_VALUE",
+ *   MaxScheduledRunsPreview: Number("int"),
  * };
  * const command = new GetBackupPlanCommand(input);
  * const response = await client.send(command);
@@ -107,6 +108,13 @@ declare const GetBackupPlanCommand_base: {
  * //       },
  * //     },
  * //   ],
+ * //   ScheduledRunsPreview: [ // ScheduledRunsPreview
+ * //     { // ScheduledPlanExecutionMember
+ * //       ExecutionTime: new Date("TIMESTAMP"),
+ * //       RuleId: "STRING_VALUE",
+ * //       RuleExecutionType: "CONTINUOUS" || "SNAPSHOTS" || "CONTINUOUS_AND_SNAPSHOTS",
+ * //     },
+ * //   ],
  * // };
  *
  * ```

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

@@ -29,6 +29,9 @@ declare const StartCopyJobCommand_base: {
 /**
  * <p>Starts a job to create a one-time copy of the specified resource.</p>
  *          <p>Does not support continuous backups.</p>
+ *          <p>See <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/recov-point-create-a-copy.html#backup-copy-retry">Copy
+ *       job retry</a> for information on how Backup retries copy job
+ *       operations.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/models/models_0.d.ts

@@ -3625,7 +3625,8 @@ export interface DescribeGlobalSettingsInput {
  */
 export interface DescribeGlobalSettingsOutput {
     /**
-     * <p>The status of the flag <code>isCrossAccountBackupEnabled</code>.</p>
+     * <p>The status of the flags <code>isCrossAccountBackupEnabled</code> and
+     *           <code>isMpaEnabled</code> ('Mpa' refers to multi-party approval).</p>
      * @public
      */
     GlobalSettings?: Record<string, string> | undefined;
@@ -4511,6 +4512,45 @@ export interface GetBackupPlanInput {
      * @public
      */
     VersionId?: string | undefined;
+    /**
+     * <p>Number of future scheduled backup runs to preview. When set to 0 (default), no scheduled runs preview is included in the response. Valid range is 0-10.</p>
+     * @public
+     */
+    MaxScheduledRunsPreview?: number | undefined;
+}
+/**
+ * @public
+ * @enum
+ */
+export declare const RuleExecutionType: {
+    readonly CONTINUOUS: "CONTINUOUS";
+    readonly CONTINUOUS_AND_SNAPSHOTS: "CONTINUOUS_AND_SNAPSHOTS";
+    readonly SNAPSHOTS: "SNAPSHOTS";
+};
+/**
+ * @public
+ */
+export type RuleExecutionType = (typeof RuleExecutionType)[keyof typeof RuleExecutionType];
+/**
+ * <p>Contains information about a scheduled backup plan execution, including the execution time, rule type, and associated rule identifier.</p>
+ * @public
+ */
+export interface ScheduledPlanExecutionMember {
+    /**
+     * <p>The timestamp when the backup is scheduled to run, in Unix format and Coordinated Universal Time (UTC). The value is accurate to milliseconds.</p>
+     * @public
+     */
+    ExecutionTime?: Date | undefined;
+    /**
+     * <p>The unique identifier of the backup rule that will execute at the scheduled time.</p>
+     * @public
+     */
+    RuleId?: string | undefined;
+    /**
+     * <p>The type of backup rule execution. Valid values are <code>CONTINUOUS</code> (point-in-time recovery), <code>SNAPSHOTS</code> (snapshot backups), or <code>CONTINUOUS_AND_SNAPSHOTS</code> (both types combined).</p>
+     * @public
+     */
+    RuleExecutionType?: RuleExecutionType | undefined;
 }
 /**
  * @public
@@ -4575,6 +4615,11 @@ export interface GetBackupPlanOutput {
      * @public
      */
     AdvancedBackupSettings?: AdvancedBackupSetting[] | undefined;
+    /**
+     * <p>List of upcoming scheduled backup runs. Only included when <code>MaxScheduledRunsPreview</code> parameter is greater than 0. Contains up to 10 future backup executions with their scheduled times, execution types, and associated rule IDs.</p>
+     * @public
+     */
+    ScheduledRunsPreview?: ScheduledPlanExecutionMember[] | undefined;
 }
 /**
  * @public
@@ -8887,9 +8932,14 @@ export interface UpdateFrameworkOutput {
  */
 export interface UpdateGlobalSettingsInput {
     /**
-     * <p>A value for <code>isCrossAccountBackupEnabled</code> and a Region. Example:
+     * <p>Inputs can include:</p>
+     *          <p>A value for <code>isCrossAccountBackupEnabled</code> and a Region. Example:
      *             <code>update-global-settings --global-settings isCrossAccountBackupEnabled=false
      *             --region us-west-2</code>.</p>
+     *          <p>A value for Multi-party approval, styled as "Mpa": <code>isMpaEnabled</code>. Values can
+     *          be true or false. Example:
+     *          <code>update-global-settings --global-settings isMpaEnabled=false
+     *             --region us-west-2</code>.</p>
      * @public
      */
     GlobalSettings?: Record<string, string> | undefined;

package/dist-types/ts3.4/models/models_0.d.ts

@@ -940,6 +940,19 @@ export interface ExportBackupPlanTemplateOutput {
 export interface GetBackupPlanInput {
   BackupPlanId: string | undefined;
   VersionId?: string | undefined;
+  MaxScheduledRunsPreview?: number | undefined;
+}
+export declare const RuleExecutionType: {
+  readonly CONTINUOUS: "CONTINUOUS";
+  readonly CONTINUOUS_AND_SNAPSHOTS: "CONTINUOUS_AND_SNAPSHOTS";
+  readonly SNAPSHOTS: "SNAPSHOTS";
+};
+export type RuleExecutionType =
+  (typeof RuleExecutionType)[keyof typeof RuleExecutionType];
+export interface ScheduledPlanExecutionMember {
+  ExecutionTime?: Date | undefined;
+  RuleId?: string | undefined;
+  RuleExecutionType?: RuleExecutionType | undefined;
 }
 export interface GetBackupPlanOutput {
   BackupPlan?: BackupPlan | undefined;
@@ -951,6 +964,7 @@ export interface GetBackupPlanOutput {
   DeletionDate?: Date | undefined;
   LastExecutionDate?: Date | undefined;
   AdvancedBackupSettings?: AdvancedBackupSetting[] | undefined;
+  ScheduledRunsPreview?: ScheduledPlanExecutionMember[] | undefined;
 }
 export interface GetBackupPlanFromJSONInput {
   BackupPlanTemplateJson: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-backup",
   "description": "AWS SDK for JavaScript Backup Client for Node.js, Browser and React Native",
-  "version": "3.901.0",
+  "version": "3.904.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-backup",