@aws-sdk/client-backup 3.39.0 → 3.43.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/dist-cjs/endpoints.js +74 -5
  3. package/dist-cjs/models/models_0.js +16 -4
  4. package/dist-cjs/protocols/Aws_restJson1.js +117 -0
  5. package/dist-cjs/runtimeConfig.browser.js +6 -3
  6. package/dist-cjs/runtimeConfig.js +5 -3
  7. package/dist-es/endpoints.js +74 -5
  8. package/dist-es/models/models_0.js +8 -0
  9. package/dist-es/protocols/Aws_restJson1.js +133 -29
  10. package/dist-es/runtimeConfig.browser.js +3 -2
  11. package/dist-es/runtimeConfig.js +3 -3
  12. package/dist-types/Backup.d.ts +6 -40
  13. package/dist-types/BackupClient.d.ts +8 -0
  14. package/dist-types/commands/CreateBackupPlanCommand.d.ts +1 -1
  15. package/dist-types/commands/CreateBackupSelectionCommand.d.ts +3 -41
  16. package/dist-types/commands/CreateBackupVaultCommand.d.ts +1 -1
  17. package/dist-types/commands/CreateFrameworkCommand.d.ts +1 -1
  18. package/dist-types/commands/CreateReportPlanCommand.d.ts +1 -1
  19. package/dist-types/commands/DeleteBackupPlanCommand.d.ts +1 -1
  20. package/dist-types/commands/DeleteBackupSelectionCommand.d.ts +1 -1
  21. package/dist-types/commands/DeleteBackupVaultAccessPolicyCommand.d.ts +1 -1
  22. package/dist-types/commands/DeleteBackupVaultCommand.d.ts +1 -1
  23. package/dist-types/commands/DeleteBackupVaultLockConfigurationCommand.d.ts +1 -1
  24. package/dist-types/commands/DeleteBackupVaultNotificationsCommand.d.ts +1 -1
  25. package/dist-types/commands/DeleteFrameworkCommand.d.ts +1 -1
  26. package/dist-types/commands/DeleteRecoveryPointCommand.d.ts +1 -1
  27. package/dist-types/commands/DeleteReportPlanCommand.d.ts +1 -1
  28. package/dist-types/commands/DescribeBackupJobCommand.d.ts +1 -1
  29. package/dist-types/commands/DescribeBackupVaultCommand.d.ts +1 -1
  30. package/dist-types/commands/DescribeCopyJobCommand.d.ts +1 -1
  31. package/dist-types/commands/DescribeFrameworkCommand.d.ts +1 -1
  32. package/dist-types/commands/DescribeGlobalSettingsCommand.d.ts +1 -1
  33. package/dist-types/commands/DescribeProtectedResourceCommand.d.ts +1 -1
  34. package/dist-types/commands/DescribeRecoveryPointCommand.d.ts +1 -1
  35. package/dist-types/commands/DescribeRegionSettingsCommand.d.ts +1 -1
  36. package/dist-types/commands/DescribeReportJobCommand.d.ts +1 -1
  37. package/dist-types/commands/DescribeReportPlanCommand.d.ts +1 -1
  38. package/dist-types/commands/DescribeRestoreJobCommand.d.ts +1 -1
  39. package/dist-types/commands/DisassociateRecoveryPointCommand.d.ts +1 -1
  40. package/dist-types/commands/ExportBackupPlanTemplateCommand.d.ts +1 -1
  41. package/dist-types/commands/GetBackupPlanCommand.d.ts +1 -1
  42. package/dist-types/commands/GetBackupPlanFromJSONCommand.d.ts +1 -1
  43. package/dist-types/commands/GetBackupPlanFromTemplateCommand.d.ts +1 -1
  44. package/dist-types/commands/GetBackupSelectionCommand.d.ts +1 -1
  45. package/dist-types/commands/GetBackupVaultAccessPolicyCommand.d.ts +1 -1
  46. package/dist-types/commands/GetBackupVaultNotificationsCommand.d.ts +1 -1
  47. package/dist-types/commands/GetRecoveryPointRestoreMetadataCommand.d.ts +1 -1
  48. package/dist-types/commands/GetSupportedResourceTypesCommand.d.ts +1 -1
  49. package/dist-types/commands/ListBackupJobsCommand.d.ts +1 -1
  50. package/dist-types/commands/ListBackupPlanTemplatesCommand.d.ts +1 -1
  51. package/dist-types/commands/ListBackupPlanVersionsCommand.d.ts +1 -1
  52. package/dist-types/commands/ListBackupPlansCommand.d.ts +1 -1
  53. package/dist-types/commands/ListBackupSelectionsCommand.d.ts +1 -1
  54. package/dist-types/commands/ListBackupVaultsCommand.d.ts +1 -1
  55. package/dist-types/commands/ListCopyJobsCommand.d.ts +1 -1
  56. package/dist-types/commands/ListFrameworksCommand.d.ts +1 -1
  57. package/dist-types/commands/ListProtectedResourcesCommand.d.ts +1 -1
  58. package/dist-types/commands/ListRecoveryPointsByBackupVaultCommand.d.ts +1 -1
  59. package/dist-types/commands/ListRecoveryPointsByResourceCommand.d.ts +1 -1
  60. package/dist-types/commands/ListReportJobsCommand.d.ts +1 -1
  61. package/dist-types/commands/ListReportPlansCommand.d.ts +1 -1
  62. package/dist-types/commands/ListRestoreJobsCommand.d.ts +1 -1
  63. package/dist-types/commands/ListTagsCommand.d.ts +1 -1
  64. package/dist-types/commands/PutBackupVaultAccessPolicyCommand.d.ts +1 -1
  65. package/dist-types/commands/PutBackupVaultLockConfigurationCommand.d.ts +5 -1
  66. package/dist-types/commands/PutBackupVaultNotificationsCommand.d.ts +1 -1
  67. package/dist-types/commands/StartBackupJobCommand.d.ts +1 -1
  68. package/dist-types/commands/StartCopyJobCommand.d.ts +1 -1
  69. package/dist-types/commands/StartReportJobCommand.d.ts +1 -1
  70. package/dist-types/commands/StartRestoreJobCommand.d.ts +1 -1
  71. package/dist-types/commands/StopBackupJobCommand.d.ts +1 -1
  72. package/dist-types/commands/TagResourceCommand.d.ts +1 -1
  73. package/dist-types/commands/UntagResourceCommand.d.ts +1 -1
  74. package/dist-types/commands/UpdateBackupPlanCommand.d.ts +1 -1
  75. package/dist-types/commands/UpdateFrameworkCommand.d.ts +1 -1
  76. package/dist-types/commands/UpdateGlobalSettingsCommand.d.ts +1 -1
  77. package/dist-types/commands/UpdateRecoveryPointLifecycleCommand.d.ts +1 -1
  78. package/dist-types/commands/UpdateRegionSettingsCommand.d.ts +1 -1
  79. package/dist-types/commands/UpdateReportPlanCommand.d.ts +1 -1
  80. package/dist-types/models/models_0.d.ts +197 -46
  81. package/dist-types/runtimeConfig.browser.d.ts +2 -0
  82. package/dist-types/runtimeConfig.d.ts +2 -0
  83. package/dist-types/runtimeConfig.native.d.ts +2 -0
  84. package/dist-types/ts3.4/BackupClient.d.ts +4 -0
  85. package/dist-types/ts3.4/models/models_0.d.ts +38 -0
  86. package/dist-types/ts3.4/runtimeConfig.browser.d.ts +2 -0
  87. package/dist-types/ts3.4/runtimeConfig.d.ts +2 -0
  88. package/dist-types/ts3.4/runtimeConfig.native.d.ts +2 -0
  89. package/package.json +23 -23
@@ -291,7 +291,8 @@ export declare namespace CopyAction {
291
291
  */
292
292
  export interface BackupRule {
293
293
  /**
294
- * <p>An optional display name for a backup rule.</p>
294
+ * <p>A display name for a backup rule. Must contain 1 to 50 alphanumeric or '-_.'
295
+ * characters.</p>
295
296
  */
296
297
  RuleName: string | undefined;
297
298
  /**
@@ -303,10 +304,11 @@ export interface BackupRule {
303
304
  TargetBackupVaultName: string | undefined;
304
305
  /**
305
306
  * <p>A cron expression in UTC specifying when Backup initiates a backup job. For
306
- * more information about cron expressions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html">Schedule Expressions for Rules</a> in the <i>Amazon CloudWatch Events User
307
- * Guide.</i>. Prior to specifying a value for this parameter, we recommend testing
308
- * your cron expression using one of the many available cron generator and testing
309
- * tools.</p>
307
+ * more information about Amazon Web Services cron expressions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html">Schedule Expressions for Rules</a> in the <i>Amazon CloudWatch Events User
308
+ * Guide.</i>. Two examples of Amazon Web Services cron expressions are <code> 15 * ?
309
+ * * * *</code> (take a backup every hour at 15 minutes past the hour) and <code>0 12 * * ?
310
+ * *</code> (take a backup every day at 12 noon UTC). For a table of examples, click the
311
+ * preceding link and scroll down the page.</p>
310
312
  */
311
313
  ScheduleExpression?: string;
312
314
  /**
@@ -367,7 +369,8 @@ export declare namespace BackupRule {
367
369
  */
368
370
  export interface BackupPlan {
369
371
  /**
370
- * <p>The display name of a backup plan.</p>
372
+ * <p>The display name of a backup plan. Must contain 1 to 50 alphanumeric or '-_.'
373
+ * characters.</p>
371
374
  */
372
375
  BackupPlanName: string | undefined;
373
376
  /**
@@ -391,7 +394,8 @@ export declare namespace BackupPlan {
391
394
  */
392
395
  export interface BackupRuleInput {
393
396
  /**
394
- * <p>An optional display name for a backup rule.</p>
397
+ * <p>A display name for a backup rule. Must contain 1 to 50 alphanumeric or '-_.'
398
+ * characters.</p>
395
399
  */
396
400
  RuleName: string | undefined;
397
401
  /**
@@ -458,7 +462,8 @@ export declare namespace BackupRuleInput {
458
462
  */
459
463
  export interface BackupPlanInput {
460
464
  /**
461
- * <p>The optional display name of a backup plan.</p>
465
+ * <p>The display name of a backup plan. Must contain 1 to 50 alphanumeric or '-_.'
466
+ * characters.</p>
462
467
  */
463
468
  BackupPlanName: string | undefined;
464
469
  /**
@@ -516,7 +521,8 @@ export interface BackupPlansListMember {
516
521
  BackupPlanName?: string;
517
522
  /**
518
523
  * <p>A unique string that identifies the request and allows failed requests to be retried
519
- * without the risk of running the operation twice.</p>
524
+ * without the risk of running the operation twice. This parameter is optional.</p>
525
+ * <p>If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.</p>
520
526
  */
521
527
  CreatorRequestId?: string;
522
528
  /**
@@ -556,28 +562,87 @@ export declare namespace BackupPlanTemplatesListMember {
556
562
  */
557
563
  const filterSensitiveLog: (obj: BackupPlanTemplatesListMember) => any;
558
564
  }
565
+ /**
566
+ * <p>Includes information about tags you define to assign tagged resources to a backup
567
+ * plan.</p>
568
+ */
569
+ export interface ConditionParameter {
570
+ /**
571
+ * <p>The key in a key-value pair. For example, in the tag <code>Department:
572
+ * Accounting</code>, <code>Department</code> is the key.</p>
573
+ */
574
+ ConditionKey?: string;
575
+ /**
576
+ * <p>The value in a key-value pair. For example, in the tag <code>Department:
577
+ * Accounting</code>, <code>Accounting</code> is the value.</p>
578
+ */
579
+ ConditionValue?: string;
580
+ }
581
+ export declare namespace ConditionParameter {
582
+ /**
583
+ * @internal
584
+ */
585
+ const filterSensitiveLog: (obj: ConditionParameter) => any;
586
+ }
587
+ /**
588
+ * <p>Contains information about which resources to include or exclude from a backup plan
589
+ * using their tags. Conditions are case sensitive.</p>
590
+ */
591
+ export interface Conditions {
592
+ /**
593
+ * <p>Filters the values of your tagged resources for only those resources that you tagged
594
+ * with the same value. Also called "exact matching."</p>
595
+ */
596
+ StringEquals?: ConditionParameter[];
597
+ /**
598
+ * <p>Filters the values of your tagged resources for only those resources that you tagged
599
+ * that do not have the same value. Also called "negated matching."</p>
600
+ */
601
+ StringNotEquals?: ConditionParameter[];
602
+ /**
603
+ * <p>Filters the values of your tagged resources for matching tag values with the use of a
604
+ * wildcard character (*) anywhere in the string. For example, "prod*" or "*rod*" matches the
605
+ * tag value "production".</p>
606
+ */
607
+ StringLike?: ConditionParameter[];
608
+ /**
609
+ * <p>Filters the values of your tagged resources for non-matching tag values with the use of
610
+ * a wildcard character (*) anywhere in the string.</p>
611
+ */
612
+ StringNotLike?: ConditionParameter[];
613
+ }
614
+ export declare namespace Conditions {
615
+ /**
616
+ * @internal
617
+ */
618
+ const filterSensitiveLog: (obj: Conditions) => any;
619
+ }
559
620
  export declare enum ConditionType {
560
621
  STRINGEQUALS = "STRINGEQUALS"
561
622
  }
562
623
  /**
563
624
  * <p>Contains an array of triplets made up of a condition type (such as
564
- * <code>StringEquals</code>), a key, and a value. Conditions are used to filter resources
565
- * in a selection that is assigned to a backup plan.</p>
625
+ * <code>StringEquals</code>), a key, and a value. Used to filter resources using their
626
+ * tags and assign them to a backup plan. Case sensitive.</p>
566
627
  */
567
628
  export interface Condition {
568
629
  /**
569
- * <p>An operation, such as <code>StringEquals</code>, that is applied to a key-value pair
570
- * used to filter resources in a selection.</p>
630
+ * <p>An operation applied to a key-value pair used to assign resources to your backup plan.
631
+ * Condition only supports <code>StringEquals</code>. For more flexible assignment options,
632
+ * incluidng <code>StringLike</code> and the ability to exclude resources from your backup
633
+ * plan, use <code>Conditions</code> (with an "s" on the end) for your <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BackupSelection.html">
634
+ * <code>BackupSelection</code>
635
+ * </a>.</p>
571
636
  */
572
637
  ConditionType: ConditionType | string | undefined;
573
638
  /**
574
- * <p>The key in a key-value pair. For example, in <code>"ec2:ResourceTag/Department":
575
- * "accounting"</code>, <code>"ec2:ResourceTag/Department"</code> is the key.</p>
639
+ * <p>The key in a key-value pair. For example, in the tag <code>Department:
640
+ * Accounting</code>, <code>Department</code> is the key.</p>
576
641
  */
577
642
  ConditionKey: string | undefined;
578
643
  /**
579
- * <p>The value in a key-value pair. For example, in <code>"ec2:ResourceTag/Department":
580
- * "accounting"</code>, <code>"accounting"</code> is the value.</p>
644
+ * <p>The value in a key-value pair. For example, in the tag <code>Department:
645
+ * Accounting</code>, <code>Accounting</code> is the value.</p>
581
646
  */
582
647
  ConditionValue: string | undefined;
583
648
  }
@@ -592,7 +657,8 @@ export declare namespace Condition {
592
657
  */
593
658
  export interface BackupSelection {
594
659
  /**
595
- * <p>The display name of a resource selection document.</p>
660
+ * <p>The display name of a resource selection document. Must contain 1 to 50 alphanumeric or
661
+ * '-_.' characters.</p>
596
662
  */
597
663
  SelectionName: string | undefined;
598
664
  /**
@@ -601,17 +667,63 @@ export interface BackupSelection {
601
667
  */
602
668
  IamRoleArn: string | undefined;
603
669
  /**
604
- * <p>An array of strings that contain Amazon Resource Names (ARNs)
605
- *
606
- * of resources to assign to a backup plan.</p>
670
+ * <p>A list of Amazon Resource Names (ARNs) to assign to a backup plan. The maximum number of
671
+ * ARNs is 500 without wildcards, or 30 ARNs with wildcards.</p>
672
+ * <p>If you need to assign many resources to a backup plan, consider a different resource
673
+ * selection strategy, such as assigning all resources of a resource type or refining your
674
+ * resource selection using tags.</p>
607
675
  */
608
676
  Resources?: string[];
609
677
  /**
610
- * <p>An array of conditions used to specify a set of resources to assign to a backup plan;
611
- * for example, <code>"StringEquals": {"ec2:ResourceTag/Department": "accounting"</code>.
612
- * Assigns the backup plan to every resource with at least one matching tag.</p>
678
+ * <p>A list of conditions that you define to assign resources to your backup plans using
679
+ * tags. For example, <code>"StringEquals": {"Department": "accounting"</code>. Condition
680
+ * operators are case sensitive.</p>
681
+ * <p>
682
+ * <code>ListOfTags</code> differs from <code>Conditions</code> as follows:</p>
683
+ * <ul>
684
+ * <li>
685
+ * <p>When you specify more than one condition, you assign all resources that match AT
686
+ * LEAST ONE condition (using OR logic).</p>
687
+ * </li>
688
+ * <li>
689
+ * <p>
690
+ * <code>ListOfTags</code> only supports <code>StringEquals</code>.
691
+ * <code>Conditions</code> supports <code>StringEquals</code>,
692
+ * <code>StringLike</code>, <code>StringNotEquals</code>, and
693
+ * <code>StringNotLike</code>. </p>
694
+ * </li>
695
+ * </ul>
613
696
  */
614
697
  ListOfTags?: Condition[];
698
+ /**
699
+ * <p>A list of Amazon Resource Names (ARNs) to exclude from a backup plan. The maximum number
700
+ * of ARNs is 500 without wildcards, or 30 ARNs with wildcards.</p>
701
+ * <p>If you need to exclude many resources from a backup plan, consider a different resource
702
+ * selection strategy, such as assigning only one or a few resource types or refining your
703
+ * resource selection using tags.</p>
704
+ */
705
+ NotResources?: string[];
706
+ /**
707
+ * <p>A list of conditions that you define to assign resources to your backup plans using
708
+ * tags. For example, <code>"StringEquals": {"Department": "accounting"</code>. Condition
709
+ * operators are case sensitive.</p>
710
+ * <p>
711
+ * <code>Conditions</code> differs from <code>ListOfTags</code> as follows:</p>
712
+ * <ul>
713
+ * <li>
714
+ * <p>When you specify more than one condition, you only assign the resources that match
715
+ * ALL conditions (using AND logic).</p>
716
+ * </li>
717
+ * <li>
718
+ * <p>
719
+ * <code>Conditions</code> supports <code>StringEquals</code>,
720
+ * <code>StringLike</code>, <code>StringNotEquals</code>, and
721
+ * <code>StringNotLike</code>. <code>ListOfTags</code> only supports
722
+ * <code>StringEquals</code>.</p>
723
+ * </li>
724
+ * </ul>
725
+ */
726
+ Conditions?: Conditions;
615
727
  }
616
728
  export declare namespace BackupSelection {
617
729
  /**
@@ -644,7 +756,8 @@ export interface BackupSelectionsListMember {
644
756
  CreationDate?: Date;
645
757
  /**
646
758
  * <p>A unique string that identifies the request and allows failed requests to be retried
647
- * without the risk of running the operation twice.</p>
759
+ * without the risk of running the operation twice. This parameter is optional.</p>
760
+ * <p>If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.</p>
648
761
  */
649
762
  CreatorRequestId?: string;
650
763
  /**
@@ -706,7 +819,8 @@ export interface BackupVaultListMember {
706
819
  EncryptionKeyArn?: string;
707
820
  /**
708
821
  * <p>A unique string that identifies the request and allows failed requests to be retried
709
- * without the risk of running the operation twice.</p>
822
+ * without the risk of running the operation twice. This parameter is optional.</p>
823
+ * <p>If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.</p>
710
824
  */
711
825
  CreatorRequestId?: string;
712
826
  /**
@@ -837,9 +951,10 @@ export declare namespace ControlInputParameter {
837
951
  }
838
952
  /**
839
953
  * <p>A framework consists of one or more controls. Each control has its own control scope.
840
- * The control scope defines what the control will evaluate. Three examples of control scopes
841
- * are: a specific backup plan, all backup plans with a specific tag, or all backup
842
- * plans.</p>
954
+ * The control scope can include one or more resource types, a combination of a tag key and
955
+ * value, or a combination of one resource type and one resource ID. If no scope is specified,
956
+ * evaluations for the rule are triggered when any resource in your recording group changes in
957
+ * configuration.</p>
843
958
  * <note>
844
959
  * <p>To set a control scope that includes all of a particular resource, leave the
845
960
  * <code>ControlScope</code> empty or do not pass it when calling
@@ -858,8 +973,10 @@ export interface ControlScope {
858
973
  */
859
974
  ComplianceResourceTypes?: string[];
860
975
  /**
861
- * <p>Describes whether the control scope includes resources with one or more tags. Each tag
862
- * is a key-value pair.</p>
976
+ * <p>The tag key-value pair applied to those Amazon Web Services resources that you want to
977
+ * trigger an evaluation for a rule. A maximum of one key-value pair can be provided. The tag
978
+ * value is optional, but it cannot be an empty string. The structure to assign a tag is:
979
+ * <code>[{"Key":"string","Value":"string"}]</code>.</p>
863
980
  */
864
981
  Tags?: {
865
982
  [key: string]: string;
@@ -978,6 +1095,7 @@ export interface CreateBackupPlanInput {
978
1095
  * <p>Identifies the request and allows failed requests to be retried without the risk of
979
1096
  * running the operation twice. If the request includes a <code>CreatorRequestId</code> that
980
1097
  * matches an existing backup plan, that plan is returned. This parameter is optional.</p>
1098
+ * <p>If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.</p>
981
1099
  */
982
1100
  CreatorRequestId?: string;
983
1101
  }
@@ -1127,7 +1245,8 @@ export interface CreateBackupSelectionInput {
1127
1245
  BackupSelection: BackupSelection | undefined;
1128
1246
  /**
1129
1247
  * <p>A unique string that identifies the request and allows failed requests to be retried
1130
- * without the risk of running the operation twice.</p>
1248
+ * without the risk of running the operation twice. This parameter is optional.</p>
1249
+ * <p>If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.</p>
1131
1250
  */
1132
1251
  CreatorRequestId?: string;
1133
1252
  }
@@ -1182,7 +1301,8 @@ export interface CreateBackupVaultInput {
1182
1301
  EncryptionKeyArn?: string;
1183
1302
  /**
1184
1303
  * <p>A unique string that identifies the request and allows failed requests to be retried
1185
- * without the risk of running the operation twice.</p>
1304
+ * without the risk of running the operation twice. This parameter is optional.</p>
1305
+ * <p>If used, this parameter must contain 1 to 50 alphanumeric or '-_.' characters.</p>
1186
1306
  */
1187
1307
  CreatorRequestId?: string;
1188
1308
  }
@@ -2259,6 +2379,15 @@ export interface DescribeRegionSettingsOutput {
2259
2379
  ResourceTypeOptInPreference?: {
2260
2380
  [key: string]: boolean;
2261
2381
  };
2382
+ /**
2383
+ * <p>Returns whether a DynamoDB recovery point was taken using
2384
+ * <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html">
2385
+ * Backup's advanced DynamoDB backup features</a>.
2386
+ * </p>
2387
+ */
2388
+ ResourceTypeManagementPreference?: {
2389
+ [key: string]: boolean;
2390
+ };
2262
2391
  }
2263
2392
  export declare namespace DescribeRegionSettingsOutput {
2264
2393
  /**
@@ -4180,19 +4309,31 @@ export interface PutBackupVaultNotificationsInput {
4180
4309
  /**
4181
4310
  * <p>An array of events that indicate the status of jobs to back up resources to the backup
4182
4311
  * vault.</p>
4312
+ * <p>For common use cases and code samples, see <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/sns-notifications.html">Using Amazon SNS to
4313
+ * track Backup events</a>.</p>
4314
+ * <p>The following events are supported:</p>
4315
+ * <ul>
4316
+ * <li>
4317
+ * <p>
4318
+ * <code>BACKUP_JOB_STARTED</code> | <code>BACKUP_JOB_COMPLETED</code>
4319
+ * </p>
4320
+ * </li>
4321
+ * <li>
4322
+ * <p>
4323
+ * <code>COPY_JOB_STARTED</code> | <code>COPY_JOB_SUCCESSFUL</code> |
4324
+ * <code>COPY_JOB_FAILED</code>
4325
+ * </p>
4326
+ * </li>
4327
+ * <li>
4328
+ * <p>
4329
+ * <code>RESTORE_JOB_STARTED</code> | <code>RESTORE_JOB_COMPLETED</code> |
4330
+ * <code>RECOVERY_POINT_MODIFIED</code>
4331
+ * </p>
4332
+ * </li>
4333
+ * </ul>
4183
4334
  * <note>
4184
- * <p>The following events are supported:</p>
4185
- * <p>
4186
- * <code>BACKUP_JOB_STARTED</code>, <code>BACKUP_JOB_COMPLETED</code>,</p>
4187
- * <p>
4188
- * <code>COPY_JOB_STARTED</code>, <code>COPY_JOB_SUCCESSFUL</code>,
4189
- * <code>COPY_JOB_FAILED</code>,</p>
4190
- * <p>
4191
- * <code>RESTORE_JOB_STARTED</code>, <code>RESTORE_JOB_COMPLETED</code>, and
4192
- * <code>RECOVERY_POINT_MODIFIED</code>.</p>
4193
- * <p>To find failed backup jobs, use <code>BACKUP_JOB_COMPLETED</code> and filter using
4194
- * event metadata.</p>
4195
- * <p>Other events in the following list are deprecated.</p>
4335
+ * <p>Ignore the list below because it includes deprecated events. Refer to the list
4336
+ * above.</p>
4196
4337
  * </note>
4197
4338
  */
4198
4339
  BackupVaultEvents: (BackupVaultEvent | string)[] | undefined;
@@ -4541,7 +4682,8 @@ export interface TagResourceInput {
4541
4682
  ResourceArn: string | undefined;
4542
4683
  /**
4543
4684
  * <p>Key-value pairs that are used to help organize your resources. You can assign your own
4544
- * metadata to the resources you create.</p>
4685
+ * metadata to the resources you create. For clarity, this is the structure to assign tags:
4686
+ * <code>[{"Key":"string","Value":"string"}]</code>.</p>
4545
4687
  */
4546
4688
  Tags: {
4547
4689
  [key: string]: string;
@@ -4760,6 +4902,15 @@ export interface UpdateRegionSettingsInput {
4760
4902
  ResourceTypeOptInPreference?: {
4761
4903
  [key: string]: boolean;
4762
4904
  };
4905
+ /**
4906
+ * <p>Enables or disables
4907
+ * <a href="https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html">
4908
+ * Backup's advanced DynamoDB backup features</a> for the
4909
+ * Region.</p>
4910
+ */
4911
+ ResourceTypeManagementPreference?: {
4912
+ [key: string]: boolean;
4913
+ };
4763
4914
  }
4764
4915
  export declare namespace UpdateRegionSettingsInput {
4765
4916
  /**
@@ -16,6 +16,8 @@ export declare const getRuntimeConfig: (config: BackupClientConfig) => {
16
16
  retryMode: string | import("@aws-sdk/types").Provider<string>;
17
17
  sha256: import("@aws-sdk/types").HashConstructor;
18
18
  streamCollector: import("@aws-sdk/types").StreamCollector;
19
+ useDualstackEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
20
+ useFipsEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
19
21
  utf8Decoder: import("@aws-sdk/types").Decoder;
20
22
  utf8Encoder: import("@aws-sdk/types").Encoder;
21
23
  apiVersion: string;
@@ -16,6 +16,8 @@ export declare const getRuntimeConfig: (config: BackupClientConfig) => {
16
16
  retryMode: string | import("@aws-sdk/types").Provider<string>;
17
17
  sha256: import("@aws-sdk/types").HashConstructor;
18
18
  streamCollector: import("@aws-sdk/types").StreamCollector;
19
+ useDualstackEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
20
+ useFipsEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
19
21
  utf8Decoder: import("@aws-sdk/types").Decoder;
20
22
  utf8Encoder: import("@aws-sdk/types").Encoder;
21
23
  apiVersion: string;
@@ -18,6 +18,8 @@ export declare const getRuntimeConfig: (config: BackupClientConfig) => {
18
18
  maxAttempts: number | import("@aws-sdk/types").Provider<number>;
19
19
  retryMode: string | import("@aws-sdk/types").Provider<string>;
20
20
  logger: import("@aws-sdk/types").Logger;
21
+ useDualstackEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
22
+ useFipsEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
21
23
  serviceId: string;
22
24
  region: string | import("@aws-sdk/types").Provider<string> | import("@aws-sdk/types").Provider<any>;
23
25
  credentialDefaultProvider: (input: any) => import("@aws-sdk/types").Provider<import("@aws-sdk/types").Credentials>;
@@ -104,6 +104,10 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
104
104
 
105
105
  logger?: __Logger;
106
106
 
107
+ useDualstackEndpoint?: boolean | __Provider<boolean>;
108
+
109
+ useFipsEndpoint?: boolean | __Provider<boolean>;
110
+
107
111
  serviceId?: string;
108
112
 
109
113
  region?: string | __Provider<string>;
@@ -245,6 +245,32 @@ export declare namespace BackupPlanTemplatesListMember {
245
245
 
246
246
  const filterSensitiveLog: (obj: BackupPlanTemplatesListMember) => any;
247
247
  }
248
+
249
+ export interface ConditionParameter {
250
+
251
+ ConditionKey?: string;
252
+
253
+ ConditionValue?: string;
254
+ }
255
+ export declare namespace ConditionParameter {
256
+
257
+ const filterSensitiveLog: (obj: ConditionParameter) => any;
258
+ }
259
+
260
+ export interface Conditions {
261
+
262
+ StringEquals?: ConditionParameter[];
263
+
264
+ StringNotEquals?: ConditionParameter[];
265
+
266
+ StringLike?: ConditionParameter[];
267
+
268
+ StringNotLike?: ConditionParameter[];
269
+ }
270
+ export declare namespace Conditions {
271
+
272
+ const filterSensitiveLog: (obj: Conditions) => any;
273
+ }
248
274
  export declare enum ConditionType {
249
275
  STRINGEQUALS = "STRINGEQUALS"
250
276
  }
@@ -271,6 +297,10 @@ export interface BackupSelection {
271
297
  Resources?: string[];
272
298
 
273
299
  ListOfTags?: Condition[];
300
+
301
+ NotResources?: string[];
302
+
303
+ Conditions?: Conditions;
274
304
  }
275
305
  export declare namespace BackupSelection {
276
306
 
@@ -1075,6 +1105,10 @@ export interface DescribeRegionSettingsOutput {
1075
1105
  ResourceTypeOptInPreference?: {
1076
1106
  [key: string]: boolean;
1077
1107
  };
1108
+
1109
+ ResourceTypeManagementPreference?: {
1110
+ [key: string]: boolean;
1111
+ };
1078
1112
  }
1079
1113
  export declare namespace DescribeRegionSettingsOutput {
1080
1114
 
@@ -2178,6 +2212,10 @@ export interface UpdateRegionSettingsInput {
2178
2212
  ResourceTypeOptInPreference?: {
2179
2213
  [key: string]: boolean;
2180
2214
  };
2215
+
2216
+ ResourceTypeManagementPreference?: {
2217
+ [key: string]: boolean;
2218
+ };
2181
2219
  }
2182
2220
  export declare namespace UpdateRegionSettingsInput {
2183
2221
 
@@ -14,6 +14,8 @@ export declare const getRuntimeConfig: (config: BackupClientConfig) => {
14
14
  retryMode: string | import("@aws-sdk/types").Provider<string>;
15
15
  sha256: import("@aws-sdk/types").HashConstructor;
16
16
  streamCollector: import("@aws-sdk/types").StreamCollector;
17
+ useDualstackEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
18
+ useFipsEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
17
19
  utf8Decoder: import("@aws-sdk/types").Decoder;
18
20
  utf8Encoder: import("@aws-sdk/types").Encoder;
19
21
  apiVersion: string;
@@ -14,6 +14,8 @@ export declare const getRuntimeConfig: (config: BackupClientConfig) => {
14
14
  retryMode: string | import("@aws-sdk/types").Provider<string>;
15
15
  sha256: import("@aws-sdk/types").HashConstructor;
16
16
  streamCollector: import("@aws-sdk/types").StreamCollector;
17
+ useDualstackEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
18
+ useFipsEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
17
19
  utf8Decoder: import("@aws-sdk/types").Decoder;
18
20
  utf8Encoder: import("@aws-sdk/types").Encoder;
19
21
  apiVersion: string;
@@ -16,6 +16,8 @@ export declare const getRuntimeConfig: (config: BackupClientConfig) => {
16
16
  maxAttempts: number | import("@aws-sdk/types").Provider<number>;
17
17
  retryMode: string | import("@aws-sdk/types").Provider<string>;
18
18
  logger: import("@aws-sdk/types").Logger;
19
+ useDualstackEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
20
+ useFipsEndpoint: boolean | import("@aws-sdk/types").Provider<boolean>;
19
21
  serviceId: string;
20
22
  region: string | import("@aws-sdk/types").Provider<string> | import("@aws-sdk/types").Provider<any>;
21
23
  credentialDefaultProvider: (input: any) => import("@aws-sdk/types").Provider<import("@aws-sdk/types").Credentials>;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-backup",
3
3
  "description": "AWS SDK for JavaScript Backup Client for Node.js, Browser and React Native",
4
- "version": "3.39.0",
4
+ "version": "3.43.0",
5
5
  "scripts": {
6
6
  "build": "yarn build:cjs && yarn build:es && yarn build:types",
7
7
  "build:cjs": "tsc -p tsconfig.json",
@@ -21,32 +21,32 @@
21
21
  "dependencies": {
22
22
  "@aws-crypto/sha256-browser": "2.0.0",
23
23
  "@aws-crypto/sha256-js": "2.0.0",
24
- "@aws-sdk/client-sts": "3.39.0",
25
- "@aws-sdk/config-resolver": "3.39.0",
26
- "@aws-sdk/credential-provider-node": "3.39.0",
27
- "@aws-sdk/fetch-http-handler": "3.38.0",
28
- "@aws-sdk/hash-node": "3.38.0",
29
- "@aws-sdk/invalid-dependency": "3.38.0",
30
- "@aws-sdk/middleware-content-length": "3.38.0",
31
- "@aws-sdk/middleware-host-header": "3.38.0",
32
- "@aws-sdk/middleware-logger": "3.38.0",
33
- "@aws-sdk/middleware-retry": "3.39.0",
34
- "@aws-sdk/middleware-serde": "3.38.0",
35
- "@aws-sdk/middleware-signing": "3.39.0",
36
- "@aws-sdk/middleware-stack": "3.38.0",
37
- "@aws-sdk/middleware-user-agent": "3.38.0",
38
- "@aws-sdk/node-config-provider": "3.39.0",
39
- "@aws-sdk/node-http-handler": "3.38.0",
40
- "@aws-sdk/protocol-http": "3.38.0",
41
- "@aws-sdk/smithy-client": "3.38.0",
42
- "@aws-sdk/types": "3.38.0",
43
- "@aws-sdk/url-parser": "3.38.0",
24
+ "@aws-sdk/client-sts": "3.43.0",
25
+ "@aws-sdk/config-resolver": "3.40.0",
26
+ "@aws-sdk/credential-provider-node": "3.41.0",
27
+ "@aws-sdk/fetch-http-handler": "3.40.0",
28
+ "@aws-sdk/hash-node": "3.40.0",
29
+ "@aws-sdk/invalid-dependency": "3.40.0",
30
+ "@aws-sdk/middleware-content-length": "3.40.0",
31
+ "@aws-sdk/middleware-host-header": "3.40.0",
32
+ "@aws-sdk/middleware-logger": "3.40.0",
33
+ "@aws-sdk/middleware-retry": "3.40.0",
34
+ "@aws-sdk/middleware-serde": "3.40.0",
35
+ "@aws-sdk/middleware-signing": "3.40.0",
36
+ "@aws-sdk/middleware-stack": "3.40.0",
37
+ "@aws-sdk/middleware-user-agent": "3.40.0",
38
+ "@aws-sdk/node-config-provider": "3.40.0",
39
+ "@aws-sdk/node-http-handler": "3.40.0",
40
+ "@aws-sdk/protocol-http": "3.40.0",
41
+ "@aws-sdk/smithy-client": "3.41.0",
42
+ "@aws-sdk/types": "3.40.0",
43
+ "@aws-sdk/url-parser": "3.40.0",
44
44
  "@aws-sdk/util-base64-browser": "3.37.0",
45
45
  "@aws-sdk/util-base64-node": "3.37.0",
46
46
  "@aws-sdk/util-body-length-browser": "3.37.0",
47
47
  "@aws-sdk/util-body-length-node": "3.37.0",
48
- "@aws-sdk/util-user-agent-browser": "3.38.0",
49
- "@aws-sdk/util-user-agent-node": "3.39.0",
48
+ "@aws-sdk/util-user-agent-browser": "3.40.0",
49
+ "@aws-sdk/util-user-agent-node": "3.40.0",
50
50
  "@aws-sdk/util-utf8-browser": "3.37.0",
51
51
  "@aws-sdk/util-utf8-node": "3.37.0",
52
52
  "tslib": "^2.3.0",