@aws-sdk/client-backup 3.216.0 → 3.222.0

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

@@ -88,6 +88,7 @@ export declare enum BackupJobState {
     CREATED = "CREATED",
     EXPIRED = "EXPIRED",
     FAILED = "FAILED",
+    PARTIAL = "PARTIAL",
     PENDING = "PENDING",
     RUNNING = "RUNNING"
 }
@@ -208,6 +209,17 @@ export interface BackupJob {
      * <p>Represents the type of backup for a backup job.</p>
      */
     BackupType?: string;
+    /**
+     * <p>This uniquely identifies a request to Backup
+     *          to back up a resource. The return will be the
+     *          parent (composite) job ID.</p>
+     */
+    ParentJobId?: string;
+    /**
+     * <p>This is a boolean value indicating this is
+     *          a parent (composite) backup job.</p>
+     */
+    IsParent?: boolean;
 }
 /**
  * <p>Contains an array of <code>Transition</code> objects specifying how long in days before
@@ -284,7 +296,8 @@ export interface BackupRule {
     ScheduleExpression?: string;
     /**
      * <p>A value in minutes after a backup is scheduled before a job will be canceled if it
-     *          doesn't start successfully. This value is optional.</p>
+     *          doesn't start successfully. This value is optional.
+     *          If this value is included, it must be at least 60 minutes to avoid errors.</p>
      */
     StartWindowMinutes?: number;
     /**
@@ -372,7 +385,8 @@ export interface BackupRuleInput {
     ScheduleExpression?: string;
     /**
      * <p>A value in minutes after a backup is scheduled before a job will be canceled if it
-     *          doesn't start successfully. This value is optional.</p>
+     *          doesn't start successfully. This value is optional.
+     *          If this value is included, it must be at least 60 minutes to avoid errors.</p>
      */
     StartWindowMinutes?: number;
     /**
@@ -820,6 +834,130 @@ export interface CalculatedLifecycle {
      */
     DeleteAt?: Date;
 }
+export interface CancelLegalHoldInput {
+    /**
+     * <p>Legal hold ID required to remove the specified legal hold on a recovery point.</p>
+     */
+    LegalHoldId: string | undefined;
+    /**
+     * <p>String describing the reason for removing the legal hold.</p>
+     */
+    CancelDescription: string | undefined;
+    /**
+     * <p>The integer amount in days specifying amount of days after this
+     *          API operation to remove legal hold.</p>
+     */
+    RetainRecordInDays?: number;
+}
+export interface CancelLegalHoldOutput {
+}
+/**
+ * <p>Indicates that something is wrong with a parameter's value. For example, the value is
+ *          out of range.</p>
+ */
+export declare class InvalidParameterValueException extends __BaseException {
+    readonly name: "InvalidParameterValueException";
+    readonly $fault: "client";
+    Code?: string;
+    Message?: string;
+    /**
+     * <p></p>
+     */
+    Type?: string;
+    /**
+     * <p></p>
+     */
+    Context?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<InvalidParameterValueException, __BaseException>);
+}
+/**
+ * <p>Backup is already performing an action on this recovery point. It can't
+ *          perform the action you requested until the first action finishes. Try again later.</p>
+ */
+export declare class InvalidResourceStateException extends __BaseException {
+    readonly name: "InvalidResourceStateException";
+    readonly $fault: "client";
+    Code?: string;
+    Message?: string;
+    /**
+     * <p></p>
+     */
+    Type?: string;
+    /**
+     * <p></p>
+     */
+    Context?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<InvalidResourceStateException, __BaseException>);
+}
+/**
+ * <p>Indicates that a required parameter is missing.</p>
+ */
+export declare class MissingParameterValueException extends __BaseException {
+    readonly name: "MissingParameterValueException";
+    readonly $fault: "client";
+    Code?: string;
+    Message?: string;
+    /**
+     * <p></p>
+     */
+    Type?: string;
+    /**
+     * <p></p>
+     */
+    Context?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<MissingParameterValueException, __BaseException>);
+}
+/**
+ * <p>A resource that is required for the action doesn't exist.</p>
+ */
+export declare class ResourceNotFoundException extends __BaseException {
+    readonly name: "ResourceNotFoundException";
+    readonly $fault: "client";
+    Code?: string;
+    Message?: string;
+    /**
+     * <p></p>
+     */
+    Type?: string;
+    /**
+     * <p></p>
+     */
+    Context?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
+}
+/**
+ * <p>The request failed due to a temporary failure of the server.</p>
+ */
+export declare class ServiceUnavailableException extends __BaseException {
+    readonly name: "ServiceUnavailableException";
+    readonly $fault: "server";
+    Code?: string;
+    Message?: string;
+    /**
+     * <p></p>
+     */
+    Type?: string;
+    /**
+     * <p></p>
+     */
+    Context?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ServiceUnavailableException, __BaseException>);
+}
 /**
  * <p>Backup can't perform the action that you requested until it finishes
  *          performing a previous action. Try again later.</p>
@@ -893,6 +1031,7 @@ export declare enum CopyJobState {
     COMPLETED = "COMPLETED",
     CREATED = "CREATED",
     FAILED = "FAILED",
+    PARTIAL = "PARTIAL",
     RUNNING = "RUNNING"
 }
 /**
@@ -971,6 +1110,34 @@ export interface CopyJob {
      * <p>The type of Amazon Web Services resource to be copied; for example, an Amazon Elastic Block Store (Amazon EBS) volume or an Amazon Relational Database Service (Amazon RDS) database.</p>
      */
     ResourceType?: string;
+    /**
+     * <p>This uniquely identifies a request to Backup
+     *          to copy a resource. The return will be the
+     *          parent (composite) job ID.</p>
+     */
+    ParentJobId?: string;
+    /**
+     * <p>This is a boolean value indicating this is
+     *          a parent (composite) copy job.</p>
+     */
+    IsParent?: boolean;
+    /**
+     * <p>This is the identifier of a resource within a composite group, such as
+     *          nested (child) recovery point belonging to a composite (parent) stack. The
+     *          ID is transferred from
+     *          the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax">
+     *             logical ID</a> within a stack.</p>
+     */
+    CompositeMemberIdentifier?: string;
+    /**
+     * <p>This is the number of child (nested) copy jobs.</p>
+     */
+    NumberOfChildJobs?: number;
+    /**
+     * <p>This returns the statistics of the included
+     *          child (nested) copy jobs.</p>
+     */
+    ChildJobsInState?: Record<string, number>;
 }
 export interface CreateBackupPlanInput {
     /**
@@ -1020,28 +1187,6 @@ export interface CreateBackupPlanOutput {
      */
     AdvancedBackupSettings?: AdvancedBackupSetting[];
 }
-/**
- * <p>Indicates that something is wrong with a parameter's value. For example, the value is
- *          out of range.</p>
- */
-export declare class InvalidParameterValueException extends __BaseException {
-    readonly name: "InvalidParameterValueException";
-    readonly $fault: "client";
-    Code?: string;
-    Message?: string;
-    /**
-     * <p></p>
-     */
-    Type?: string;
-    /**
-     * <p></p>
-     */
-    Context?: string;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<InvalidParameterValueException, __BaseException>);
-}
 /**
  * <p>A limit in the request has been exceeded; for example, a maximum number of items allowed
  *          in a request.</p>
@@ -1064,48 +1209,6 @@ export declare class LimitExceededException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<LimitExceededException, __BaseException>);
 }
-/**
- * <p>Indicates that a required parameter is missing.</p>
- */
-export declare class MissingParameterValueException extends __BaseException {
-    readonly name: "MissingParameterValueException";
-    readonly $fault: "client";
-    Code?: string;
-    Message?: string;
-    /**
-     * <p></p>
-     */
-    Type?: string;
-    /**
-     * <p></p>
-     */
-    Context?: string;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<MissingParameterValueException, __BaseException>);
-}
-/**
- * <p>The request failed due to a temporary failure of the server.</p>
- */
-export declare class ServiceUnavailableException extends __BaseException {
-    readonly name: "ServiceUnavailableException";
-    readonly $fault: "server";
-    Code?: string;
-    Message?: string;
-    /**
-     * <p></p>
-     */
-    Type?: string;
-    /**
-     * <p></p>
-     */
-    Context?: string;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<ServiceUnavailableException, __BaseException>);
-}
 export interface CreateBackupSelectionInput {
     /**
      * <p>Uniquely identifies the backup plan to be associated with the selection of
@@ -1248,6 +1351,125 @@ export interface CreateFrameworkOutput {
      */
     FrameworkArn?: string;
 }
+/**
+ * <p>This is a resource filter containing FromDate: DateTime
+ *          and ToDate: DateTime. Both values are required. Future DateTime
+ *          values are not permitted.</p>
+ *          <p>The date and time are in Unix format and Coordinated
+ *          Universal Time (UTC), and it is accurate to milliseconds
+ *          ((milliseconds are optional).
+ *          For example, the value 1516925490.087 represents Friday, January
+ *          26, 2018 12:11:30.087 AM.</p>
+ */
+export interface DateRange {
+    /**
+     * <p>This value is the beginning date, inclusive.</p>
+     *          <p>The date and time are in Unix format and Coordinated
+     *          Universal Time (UTC), and it is accurate to milliseconds
+     *          (milliseconds are optional).</p>
+     */
+    FromDate: Date | undefined;
+    /**
+     * <p>This value is the end date, inclusive.</p>
+     *          <p>The date and time are in Unix format and Coordinated
+     *          Universal Time (UTC), and it is accurate to milliseconds
+     *          (milliseconds are optional).</p>
+     */
+    ToDate: Date | undefined;
+}
+/**
+ * <p>This specifies criteria to assign
+ *          a set of resources, such as resource types or backup vaults.</p>
+ */
+export interface RecoveryPointSelection {
+    /**
+     * <p>These are the names of the vaults in which the selected
+     *          recovery points are contained.</p>
+     */
+    VaultNames?: string[];
+    /**
+     * <p>These are the resources included in the resource selection
+     *          (including type of resources and vaults).</p>
+     */
+    ResourceIdentifiers?: string[];
+    /**
+     * <p>This is a resource filter containing FromDate: DateTime
+     *          and ToDate: DateTime. Both values are required. Future DateTime
+     *          values are not permitted.</p>
+     *          <p>The date and time are in Unix format and Coordinated
+     *          Universal Time (UTC), and it is accurate to milliseconds
+     *          ((milliseconds are optional).
+     *          For example, the value 1516925490.087 represents Friday, January
+     *          26, 2018 12:11:30.087 AM.</p>
+     */
+    DateRange?: DateRange;
+}
+export interface CreateLegalHoldInput {
+    /**
+     * <p>This is the string title of the legal hold.</p>
+     */
+    Title: string | undefined;
+    /**
+     * <p>This is the string description of the legal hold.</p>
+     */
+    Description: string | undefined;
+    /**
+     * <p>This is a user-chosen string used to distinguish between otherwise identical
+     *          calls. Retrying a successful request with the
+     *          same idempotency token results in a success message with no action taken.</p>
+     */
+    IdempotencyToken?: string;
+    /**
+     * <p>This specifies criteria to assign
+     *          a set of resources, such as resource types or backup vaults.</p>
+     */
+    RecoveryPointSelection?: RecoveryPointSelection;
+    /**
+     * <p>Optional tags to include. A tag is a key-value pair you can use to manage,
+     *          filter, and search for your resources. Allowed characters include UTF-8 letters,
+     *          numbers, spaces, and the following characters: + - = . _ : /. </p>
+     */
+    Tags?: Record<string, string>;
+}
+export declare enum LegalHoldStatus {
+    ACTIVE = "ACTIVE",
+    CANCELED = "CANCELED",
+    CANCELING = "CANCELING",
+    CREATING = "CREATING"
+}
+export interface CreateLegalHoldOutput {
+    /**
+     * <p>This is the string title of the legal hold returned after creating the legal hold.</p>
+     */
+    Title?: string;
+    /**
+     * <p>This displays the status of the legal hold returned after creating the legal hold.
+     *          Statuses can be <code>ACTIVE</code>, <code>PENDING</code>, <code>CANCELED</code>,
+     *          <code>CANCELING</code>, or <code>FAILED</code>.</p>
+     */
+    Status?: LegalHoldStatus | string;
+    /**
+     * <p>This is the returned string description of the legal hold.</p>
+     */
+    Description?: string;
+    /**
+     * <p>Legal hold ID returned for the specified legal hold on a recovery point.</p>
+     */
+    LegalHoldId?: string;
+    /**
+     * <p>This is the ARN (Amazon Resource Number) of the created legal hold.</p>
+     */
+    LegalHoldArn?: string;
+    /**
+     * <p>Time in number format when legal hold was created.</p>
+     */
+    CreationDate?: Date;
+    /**
+     * <p>This specifies criteria to assign
+     *          a set of resources, such as resource types or backup vaults.</p>
+     */
+    RecoveryPointSelection?: RecoveryPointSelection;
+}
 /**
  * <p>Contains information from your report plan about where to deliver your reports,
  *          specifically your Amazon S3 bucket name, S3 key prefix, and the formats of your
@@ -1291,6 +1513,18 @@ export interface ReportSetting {
      * <p>The number of frameworks a report covers.</p>
      */
     NumberOfFrameworks?: number;
+    /**
+     * <p>These are the accounts to be included in the report.</p>
+     */
+    Accounts?: string[];
+    /**
+     * <p>These are the Organizational Units to be included in the report.</p>
+     */
+    OrganizationUnits?: string[];
+    /**
+     * <p>These are the Regions to be included in the report.</p>
+     */
+    Regions?: string[];
 }
 export interface CreateReportPlanInput {
     /**
@@ -1402,27 +1636,6 @@ export declare class InvalidRequestException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<InvalidRequestException, __BaseException>);
 }
-/**
- * <p>A resource that is required for the action doesn't exist.</p>
- */
-export declare class ResourceNotFoundException extends __BaseException {
-    readonly name: "ResourceNotFoundException";
-    readonly $fault: "client";
-    Code?: string;
-    Message?: string;
-    /**
-     * <p></p>
-     */
-    Type?: string;
-    /**
-     * <p></p>
-     */
-    Context?: string;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
-}
 export interface DeleteBackupSelectionInput {
     /**
      * <p>Uniquely identifies a backup plan.</p>
@@ -1486,28 +1699,6 @@ export interface DeleteRecoveryPointInput {
      */
     RecoveryPointArn: string | undefined;
 }
-/**
- * <p>Backup is already performing an action on this recovery point. It can't
- *          perform the action you requested until the first action finishes. Try again later.</p>
- */
-export declare class InvalidResourceStateException extends __BaseException {
-    readonly name: "InvalidResourceStateException";
-    readonly $fault: "client";
-    Code?: string;
-    Message?: string;
-    /**
-     * <p></p>
-     */
-    Type?: string;
-    /**
-     * <p></p>
-     */
-    Context?: string;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<InvalidResourceStateException, __BaseException>);
-}
 export interface DeleteReportPlanInput {
     /**
      * <p>The unique name of a report plan.</p>
@@ -1650,6 +1841,22 @@ export interface DescribeBackupJobOutput {
      *          empty, then the backup type was a regular backup.</p>
      */
     BackupType?: string;
+    /**
+     * <p>This returns the parent (composite) resource backup job ID.</p>
+     */
+    ParentJobId?: string;
+    /**
+     * <p>This returns the boolean value that a backup job is a parent (composite) job.</p>
+     */
+    IsParent?: boolean;
+    /**
+     * <p>This returns the number of child (nested) backup jobs.</p>
+     */
+    NumberOfChildJobs?: number;
+    /**
+     * <p>This returns the statistics of the included child (nested) backup jobs.</p>
+     */
+    ChildJobsInState?: Record<string, number>;
 }
 export interface DescribeBackupVaultInput {
     /**
@@ -1774,10 +1981,9 @@ export interface DescribeFrameworkOutput {
      */
     FrameworkControls?: FrameworkControl[];
     /**
-     * <p>The date and time that a framework is created, in Unix format and Coordinated Universal
-     *          Time (UTC). The value of <code>CreationTime</code> is accurate to milliseconds. For
-     *          example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087
-     *          AM.</p>
+     * <p>The date and time that a framework is created, in ISO 8601 representation. The value of <code>CreationTime</code> is accurate to milliseconds. For example,
+     *          2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind
+     *          UTC.</p>
      */
     CreationTime?: Date;
     /**
@@ -1948,6 +2154,15 @@ export interface DescribeRecoveryPointOutput {
      *          manually delete these recovery points, see <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/gs-cleanup-resources.html#cleanup-backups"> Step 3:
      *             Delete the recovery points</a> in the <i>Clean up resources</i>
      *          section of <i>Getting started</i>.</p>
+     *          <p>
+     *             <code>STOPPED</code> status occurs on a continuous backup where a user has taken some
+     *          action that causes the continuous backup to be disabled. This can be caused by the removal
+     *          of permissions, turning off versioning, turning off events being sent to EventBridge,
+     *          or disabling the EventBridge rules that are put in place by Backup.</p>
+     *          <p>To resolve <code>STOPPED</code> status, ensure that all requested permissions are in place and
+     *          that versioning is enabled on the S3 bucket. Once these conditions are met, the next instance
+     *          of a backup rule running will result in a new continuous recovery point being created.
+     *          The recovery points with STOPPED status do not need to be deleted.</p>
      */
     Status?: RecoveryPointStatus | string;
     /**
@@ -2013,6 +2228,23 @@ export interface DescribeRecoveryPointOutput {
      *          12:11:30.087 AM.</p>
      */
     LastRestoreTime?: Date;
+    /**
+     * <p>This is an ARN that uniquely identifies a parent (composite) recovery point; for example,
+     *          <code>arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45</code>.</p>
+     */
+    ParentRecoveryPointArn?: string;
+    /**
+     * <p>This is the identifier of a resource within a composite group, such as
+     *          nested (child) recovery point belonging to a composite (parent) stack. The
+     *          ID is transferred from
+     *          the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax">
+     *             logical ID</a> within a stack.</p>
+     */
+    CompositeMemberIdentifier?: string;
+    /**
+     * <p>This returns the boolean value that a recovery point is a parent (composite) job.</p>
+     */
+    IsParent?: boolean;
 }
 export interface DescribeRegionSettingsInput {
 }
@@ -2292,6 +2524,22 @@ export interface DisassociateRecoveryPointInput {
      */
     RecoveryPointArn: string | undefined;
 }
+export interface DisassociateRecoveryPointFromParentInput {
+    /**
+     * <p>This is the name of a logical container where the child (nested) recovery point
+     *          is stored. Backup vaults are identified by names that are unique to the account used
+     *          to create them and the Amazon Web Services Region where they are created. They consist of lowercase
+     *          letters, numbers, and hyphens.</p>
+     */
+    BackupVaultName: string | undefined;
+    /**
+     * <p>This is the Amazon Resource Name (ARN) that uniquely identifies the child
+     *          (nested) recovery point; for example,
+     *          <code>arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.</code>
+     *          </p>
+     */
+    RecoveryPointArn: string | undefined;
+}
 export interface ExportBackupPlanTemplateInput {
     /**
      * <p>Uniquely identifies a backup plan.</p>
@@ -2494,6 +2742,61 @@ export interface GetBackupVaultNotificationsOutput {
      */
     BackupVaultEvents?: (BackupVaultEvent | string)[];
 }
+export interface GetLegalHoldInput {
+    /**
+     * <p>This is the ID required to use <code>GetLegalHold</code>. This unique ID
+     *          is associated with a specific legal hold.</p>
+     */
+    LegalHoldId: string | undefined;
+}
+export interface GetLegalHoldOutput {
+    /**
+     * <p>This is the string title of the legal hold.</p>
+     */
+    Title?: string;
+    /**
+     * <p>This is the status of the legal hold. Statuses can be
+     *          <code>ACTIVE</code>, <code>CREATING</code>, <code>CANCELED</code>, and
+     *          <code>CANCELING</code>.</p>
+     */
+    Status?: LegalHoldStatus | string;
+    /**
+     * <p>This is the returned string description of the legal hold.</p>
+     */
+    Description?: string;
+    /**
+     * <p>String describing the reason for removing the legal hold.</p>
+     */
+    CancelDescription?: string;
+    /**
+     * <p>This is the returned ID associated with a specified legal hold.</p>
+     */
+    LegalHoldId?: string;
+    /**
+     * <p>This is the returned framework ARN for the specified legal hold.
+     *          An Amazon Resource Name (ARN) uniquely identifies a resource. The format
+     *          of the ARN depends on the resource type.</p>
+     */
+    LegalHoldArn?: string;
+    /**
+     * <p>Time in number format when legal hold was created.</p>
+     */
+    CreationDate?: Date;
+    /**
+     * <p>Time in number when legal hold was cancelled.</p>
+     */
+    CancellationDate?: Date;
+    /**
+     * <p>This is the date and time until which the legal hold record will
+     *          be retained.</p>
+     */
+    RetainRecordUntil?: Date;
+    /**
+     * <p>This specifies criteria to assign
+     *          a set of resources, such as resource types or backup vaults.</p>
+     */
+    RecoveryPointSelection?: RecoveryPointSelection;
+}
 export interface GetRecoveryPointRestoreMetadataInput {
     /**
      * <p>The name of a logical container where backups are stored. Backup vaults are identified
@@ -2681,6 +2984,10 @@ export interface ListBackupJobsInput {
      *          Coordinated Universal Time (UTC).</p>
      */
     ByCompleteBefore?: Date;
+    /**
+     * <p>This is a filter to list child (nested) jobs based on parent job ID.</p>
+     */
+    ByParentJobId?: string;
 }
 export interface ListBackupJobsOutput {
     /**
@@ -2946,6 +3253,10 @@ export interface ListCopyJobsInput {
      *          Universal Time (UTC).</p>
      */
     ByCompleteAfter?: Date;
+    /**
+     * <p>This is a filter to list child (nested) jobs based on parent job ID.</p>
+     */
+    ByParentJobId?: string;
 }
 export interface ListCopyJobsOutput {
     /**
@@ -2997,10 +3308,10 @@ export interface Framework {
      */
     NumberOfControls?: number;
     /**
-     * <p>The date and time that a framework is created, in Unix format and Coordinated Universal
-     *          Time (UTC). The value of <code>CreationTime</code> is accurate to milliseconds. For
-     *          example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087
-     *          AM.</p>
+     * <p>The date and time that a framework is created, in ISO 8601 representation.
+     *          The value of <code>CreationTime</code> is accurate to milliseconds. For example,
+     *           2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind
+     *           UTC.</p>
      */
     CreationTime?: Date;
     /**
@@ -3025,6 +3336,75 @@ export interface ListFrameworksOutput {
      */
     NextToken?: string;
 }
+export interface ListLegalHoldsInput {
+    /**
+     * <p>The next item following a partial list of returned resources. For example, if a request
+     *          is made to return <code>maxResults</code> number of resources, <code>NextToken</code>
+     *          allows you to return more items in your list starting at the location pointed to by the
+     *          next token.</p>
+     */
+    NextToken?: string;
+    /**
+     * <p>The maximum number of resource list items to be returned.</p>
+     */
+    MaxResults?: number;
+}
+/**
+ * <p>A legal hold is an administrative tool that helps prevent backups
+ *          from being deleted while under a hold. While the hold is in place,
+ *          backups under a hold cannot be deleted and lifecycle policies that
+ *          would alter the backup status (such as transition to cold storage) are
+ *          delayed until the legal hold is removed. A backup can have more than
+ *          one legal hold. Legal holds are applied to one or more backups
+ *          (also known as recovery points). These backups can be filtered by resource
+ *          types and by resource IDs.</p>
+ */
+export interface LegalHold {
+    /**
+     * <p>This is the title of a legal hold.</p>
+     */
+    Title?: string;
+    /**
+     * <p>This is the status of the legal hold. Statuses can be
+     *          <code>ACTIVE</code>, <code>CREATING</code>, <code>CANCELED</code>, and
+     *          <code>CANCELING</code>.</p>
+     */
+    Status?: LegalHoldStatus | string;
+    /**
+     * <p>This is the description of a legal hold.</p>
+     */
+    Description?: string;
+    /**
+     * <p>ID of specific legal hold on one or more recovery points.</p>
+     */
+    LegalHoldId?: string;
+    /**
+     * <p>This is an Amazon Resource Number (ARN) that uniquely identifies the legal hold; for example,
+     *          <code>arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45</code>.</p>
+     */
+    LegalHoldArn?: string;
+    /**
+     * <p>This is the time in number format when legal hold was created.</p>
+     */
+    CreationDate?: Date;
+    /**
+     * <p>This is the time in number format when legal hold was cancelled.</p>
+     */
+    CancellationDate?: Date;
+}
+export interface ListLegalHoldsOutput {
+    /**
+     * <p>The next item following a partial list of returned resources. For example, if a request
+     *          is made to return <code>maxResults</code> number of resources, <code>NextToken</code>
+     *          allows you to return more items in your list starting at the location pointed to by the
+     *          next token.</p>
+     */
+    NextToken?: string;
+    /**
+     * <p>This is an array of returned legal holds, both active and previous.</p>
+     */
+    LegalHolds?: LegalHold[];
+}
 export interface ListProtectedResourcesInput {
     /**
      * <p>The next item following a partial list of returned items. For example, if a request is
@@ -3120,6 +3500,11 @@ export interface ListRecoveryPointsByBackupVaultInput {
      * <p>Returns only recovery points that were created after the specified timestamp.</p>
      */
     ByCreatedAfter?: Date;
+    /**
+     * <p>This returns only recovery points that match the specified parent (composite)
+     *          recovery point Amazon Resource Name (ARN).</p>
+     */
+    ByParentRecoveryPointArn?: string;
 }
 /**
  * <p>Contains detailed information about the recovery points stored in a backup vault.</p>
@@ -3231,6 +3616,24 @@ export interface RecoveryPointByBackupVault {
      *          12:11:30.087 AM.</p>
      */
     LastRestoreTime?: Date;
+    /**
+     * <p>This is the Amazon Resource Name (ARN) of the parent (composite)
+     *          recovery point.</p>
+     */
+    ParentRecoveryPointArn?: string;
+    /**
+     * <p>This is the identifier of a resource within a composite group, such as
+     *          nested (child) recovery point belonging to a composite (parent) stack. The
+     *          ID is transferred from
+     *          the <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax">
+     *             logical ID</a> within a stack.</p>
+     */
+    CompositeMemberIdentifier?: string;
+    /**
+     * <p>This is a boolean value indicating this is
+     *          a parent (composite) recovery point.</p>
+     */
+    IsParent?: boolean;
 }
 export interface ListRecoveryPointsByBackupVaultOutput {
     /**
@@ -3246,6 +3649,47 @@ export interface ListRecoveryPointsByBackupVaultOutput {
      */
     RecoveryPoints?: RecoveryPointByBackupVault[];
 }
+export interface ListRecoveryPointsByLegalHoldInput {
+    /**
+     * <p>This is the ID of the legal hold.</p>
+     */
+    LegalHoldId: string | undefined;
+    /**
+     * <p>This is the next item following a partial list of returned resources. For example, if a request
+     *          is made to return <code>maxResults</code> number of resources, <code>NextToken</code>
+     *          allows you to return more items in your list starting at the location pointed to by the
+     *          next token.</p>
+     */
+    NextToken?: string;
+    /**
+     * <p>This is the maximum number of resource list items to be returned.</p>
+     */
+    MaxResults?: number;
+}
+/**
+ * <p>This is a recovery point which is a child (nested) recovery point
+ *          of a parent (composite) recovery point. These recovery points
+ *          can be disassociated from their parent (composite) recovery
+ *          point, in which case they will no longer be a member.</p>
+ */
+export interface RecoveryPointMember {
+    /**
+     * <p>This is the Amazon Resource Name (ARN) of the parent (composite)
+     *          recovery point.</p>
+     */
+    RecoveryPointArn?: string;
+}
+export interface ListRecoveryPointsByLegalHoldOutput {
+    /**
+     * <p>This is a list of the recovery points returned by
+     *          <code>ListRecoveryPointsByLegalHold</code>.</p>
+     */
+    RecoveryPoints?: RecoveryPointMember[];
+    /**
+     * <p>This return is the next item following a partial list of returned resources.</p>
+     */
+    NextToken?: string;
+}
 export interface ListRecoveryPointsByResourceInput {
     /**
      * <p>An ARN that uniquely identifies a resource. The format of the ARN depends on the
@@ -3307,6 +3751,16 @@ export interface RecoveryPointByResource {
      *          hyphens.</p>
      */
     BackupVaultName?: string;
+    /**
+     * <p>This is a boolean value indicating this is
+     *          a parent (composite) recovery point.</p>
+     */
+    IsParent?: boolean;
+    /**
+     * <p>This is the Amazon Resource Name (ARN) of the parent (composite)
+     *          recovery point.</p>
+     */
+    ParentRecoveryPointArn?: string;
 }
 export interface ListRecoveryPointsByResourceOutput {
     /**
@@ -3671,8 +4125,9 @@ export interface PutBackupVaultNotificationsInput {
      *             </li>
      *          </ul>
      *          <note>
-     *             <p>Ignore the list below because it includes deprecated events. Refer to the list
-     *             above.</p>
+     *             <p>The list below shows items that are deprecated events (for reference) and are no longer
+     *             in use. They are no longer supported and will not return statuses or notifications.
+     *             Refer to the list above for current supported events.</p>
      *          </note>
      */
     BackupVaultEvents: (BackupVaultEvent | string)[] | undefined;
@@ -3703,7 +4158,8 @@ export interface StartBackupJobInput {
     IdempotencyToken?: string;
     /**
      * <p>A value in minutes after a backup is scheduled before a job will be canceled if it
-     *          doesn't start successfully. This value is optional, and the default is 8 hours.</p>
+     *          doesn't start successfully. This value is optional, and the default is 8 hours.
+     *          If this value is included, it must be at least 60 minutes to avoid errors.</p>
      */
     StartWindowMinutes?: number;
     /**
@@ -3736,9 +4192,9 @@ export interface StartBackupJobInput {
      * <p>Specifies the backup option for a selected resource. This option is only available for
      *          Windows Volume Shadow Copy Service (VSS) backup jobs.</p>
      *          <p>Valid values: Set to <code>"WindowsVSS":"enabled"</code> to enable the
-     *             <code>WindowsVSS</code> backup option and create a Windows VSS backup. Set to
-     *             <code>"WindowsVSS""disabled"</code> to create a regular backup. The
-     *             <code>WindowsVSS</code> option is not enabled by default.</p>
+     *          <code>WindowsVSS</code> backup option and create a Windows VSS backup. Set to
+     *          <code>"WindowsVSS""disabled"</code> to create a regular backup. The
+     *          <code>WindowsVSS</code> option is not enabled by default.</p>
      */
     BackupOptions?: Record<string, string>;
 }
@@ -3759,6 +4215,11 @@ export interface StartBackupJobOutput {
      *          AM.</p>
      */
     CreationDate?: Date;
+    /**
+     * <p>This is a returned boolean value indicating this is a parent (composite)
+     *          backup job.</p>
+     */
+    IsParent?: boolean;
 }
 export interface StartCopyJobInput {
     /**
@@ -3816,6 +4277,11 @@ export interface StartCopyJobOutput {
      *          AM.</p>
      */
     CreationDate?: Date;
+    /**
+     * <p>This is a returned boolean value indicating this is a parent (composite)
+     *          copy job.</p>
+     */
+    IsParent?: boolean;
 }
 export interface StartReportJobInput {
     /**
@@ -3896,7 +4362,7 @@ export interface StartRestoreJobInput {
     Metadata: Record<string, string> | undefined;
     /**
      * <p>The Amazon Resource Name (ARN) of the IAM role that Backup uses to create
-     *          the target recovery point; for example,
+     *          the target resource; for example:
      *             <code>arn:aws:iam::123456789012:role/S3Access</code>.</p>
      */
     IamRoleArn?: string;
@@ -4069,10 +4535,9 @@ export interface UpdateFrameworkOutput {
      */
     FrameworkArn?: string;
     /**
-     * <p>The date and time that a framework is created, in Unix format and Coordinated Universal
-     *          Time (UTC). The value of <code>CreationTime</code> is accurate to milliseconds. For
-     *          example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087
-     *          AM.</p>
+     * <p>The date and time that a framework is created, in ISO 8601 representation. The value of <code>CreationTime</code> is accurate to milliseconds. For example,
+     *          2020-07-10T15:00:00.000-08:00 represents the 10th of July 2020 at 3:00 PM 8 hours behind
+     *          UTC.</p>
      */
     CreationTime?: Date;
 }
@@ -4277,6 +4742,14 @@ export declare const BackupVaultListMemberFilterSensitiveLog: (obj: BackupVaultL
  * @internal
  */
 export declare const CalculatedLifecycleFilterSensitiveLog: (obj: CalculatedLifecycle) => any;
+/**
+ * @internal
+ */
+export declare const CancelLegalHoldInputFilterSensitiveLog: (obj: CancelLegalHoldInput) => any;
+/**
+ * @internal
+ */
+export declare const CancelLegalHoldOutputFilterSensitiveLog: (obj: CancelLegalHoldOutput) => any;
 /**
  * @internal
  */
@@ -4325,6 +4798,22 @@ export declare const CreateFrameworkInputFilterSensitiveLog: (obj: CreateFramewo
  * @internal
  */
 export declare const CreateFrameworkOutputFilterSensitiveLog: (obj: CreateFrameworkOutput) => any;
+/**
+ * @internal
+ */
+export declare const DateRangeFilterSensitiveLog: (obj: DateRange) => any;
+/**
+ * @internal
+ */
+export declare const RecoveryPointSelectionFilterSensitiveLog: (obj: RecoveryPointSelection) => any;
+/**
+ * @internal
+ */
+export declare const CreateLegalHoldInputFilterSensitiveLog: (obj: CreateLegalHoldInput) => any;
+/**
+ * @internal
+ */
+export declare const CreateLegalHoldOutputFilterSensitiveLog: (obj: CreateLegalHoldOutput) => any;
 /**
  * @internal
  */
@@ -4485,6 +4974,10 @@ export declare const DescribeRestoreJobOutputFilterSensitiveLog: (obj: DescribeR
  * @internal
  */
 export declare const DisassociateRecoveryPointInputFilterSensitiveLog: (obj: DisassociateRecoveryPointInput) => any;
+/**
+ * @internal
+ */
+export declare const DisassociateRecoveryPointFromParentInputFilterSensitiveLog: (obj: DisassociateRecoveryPointFromParentInput) => any;
 /**
  * @internal
  */
@@ -4541,6 +5034,14 @@ export declare const GetBackupVaultNotificationsInputFilterSensitiveLog: (obj: G
  * @internal
  */
 export declare const GetBackupVaultNotificationsOutputFilterSensitiveLog: (obj: GetBackupVaultNotificationsOutput) => any;
+/**
+ * @internal
+ */
+export declare const GetLegalHoldInputFilterSensitiveLog: (obj: GetLegalHoldInput) => any;
+/**
+ * @internal
+ */
+export declare const GetLegalHoldOutputFilterSensitiveLog: (obj: GetLegalHoldOutput) => any;
 /**
  * @internal
  */
@@ -4621,6 +5122,18 @@ export declare const FrameworkFilterSensitiveLog: (obj: Framework) => any;
  * @internal
  */
 export declare const ListFrameworksOutputFilterSensitiveLog: (obj: ListFrameworksOutput) => any;
+/**
+ * @internal
+ */
+export declare const ListLegalHoldsInputFilterSensitiveLog: (obj: ListLegalHoldsInput) => any;
+/**
+ * @internal
+ */
+export declare const LegalHoldFilterSensitiveLog: (obj: LegalHold) => any;
+/**
+ * @internal
+ */
+export declare const ListLegalHoldsOutputFilterSensitiveLog: (obj: ListLegalHoldsOutput) => any;
 /**
  * @internal
  */
@@ -4645,6 +5158,18 @@ export declare const RecoveryPointByBackupVaultFilterSensitiveLog: (obj: Recover
  * @internal
  */
 export declare const ListRecoveryPointsByBackupVaultOutputFilterSensitiveLog: (obj: ListRecoveryPointsByBackupVaultOutput) => any;
+/**
+ * @internal
+ */
+export declare const ListRecoveryPointsByLegalHoldInputFilterSensitiveLog: (obj: ListRecoveryPointsByLegalHoldInput) => any;
+/**
+ * @internal
+ */
+export declare const RecoveryPointMemberFilterSensitiveLog: (obj: RecoveryPointMember) => any;
+/**
+ * @internal
+ */
+export declare const ListRecoveryPointsByLegalHoldOutputFilterSensitiveLog: (obj: ListRecoveryPointsByLegalHoldOutput) => any;
 /**
  * @internal
  */