@aws-sdk/client-backup 3.42.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.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,17 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # [3.43.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.42.0...v3.43.0) (2021-11-29)
7
+
8
+
9
+ ### Features
10
+
11
+ * **clients:** update clients as of 11/28/2021 ([#3072](https://github.com/aws/aws-sdk-js-v3/issues/3072)) ([2ad1622](https://github.com/aws/aws-sdk-js-v3/commit/2ad1622ba8586b926fe508055211803bb29e3976))
12
+
13
+
14
+
15
+
16
+
6
17
  # [3.42.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.41.0...v3.42.0) (2021-11-19)
7
18
 
8
19
  **Note:** Version bump only for package @aws-sdk/client-backup
@@ -1890,6 +1890,10 @@ const serializeAws_restJson1UpdateRegionSettingsCommand = async (input, context)
1890
1890
  const resolvedPath = `${(basePath === null || basePath === void 0 ? void 0 : basePath.endsWith("/")) ? basePath.slice(0, -1) : basePath || ""}` + "/account-settings";
1891
1891
  let body;
1892
1892
  body = JSON.stringify({
1893
+ ...(input.ResourceTypeManagementPreference !== undefined &&
1894
+ input.ResourceTypeManagementPreference !== null && {
1895
+ ResourceTypeManagementPreference: serializeAws_restJson1ResourceTypeManagementPreference(input.ResourceTypeManagementPreference, context),
1896
+ }),
1893
1897
  ...(input.ResourceTypeOptInPreference !== undefined &&
1894
1898
  input.ResourceTypeOptInPreference !== null && {
1895
1899
  ResourceTypeOptInPreference: serializeAws_restJson1ResourceTypeOptInPreference(input.ResourceTypeOptInPreference, context),
@@ -3802,9 +3806,13 @@ const deserializeAws_restJson1DescribeRegionSettingsCommand = async (output, con
3802
3806
  }
3803
3807
  const contents = {
3804
3808
  $metadata: deserializeMetadata(output),
3809
+ ResourceTypeManagementPreference: undefined,
3805
3810
  ResourceTypeOptInPreference: undefined,
3806
3811
  };
3807
3812
  const data = smithy_client_1.expectNonNull(smithy_client_1.expectObject(await parseBody(output.body, context)), "body");
3813
+ if (data.ResourceTypeManagementPreference !== undefined && data.ResourceTypeManagementPreference !== null) {
3814
+ contents.ResourceTypeManagementPreference = deserializeAws_restJson1ResourceTypeManagementPreference(data.ResourceTypeManagementPreference, context);
3815
+ }
3808
3816
  if (data.ResourceTypeOptInPreference !== undefined && data.ResourceTypeOptInPreference !== null) {
3809
3817
  contents.ResourceTypeOptInPreference = deserializeAws_restJson1ResourceTypeOptInPreference(data.ResourceTypeOptInPreference, context);
3810
3818
  }
@@ -7012,6 +7020,14 @@ const deserializeAws_restJson1UpdateRecoveryPointLifecycleCommandError = async (
7012
7020
  $metadata: deserializeMetadata(output),
7013
7021
  };
7014
7022
  break;
7023
+ case "InvalidRequestException":
7024
+ case "com.amazonaws.backup#InvalidRequestException":
7025
+ response = {
7026
+ ...(await deserializeAws_restJson1InvalidRequestExceptionResponse(parsedOutput, context)),
7027
+ name: errorCode,
7028
+ $metadata: deserializeMetadata(output),
7029
+ };
7030
+ break;
7015
7031
  case "MissingParameterValueException":
7016
7032
  case "com.amazonaws.backup#MissingParameterValueException":
7017
7033
  response = {
@@ -7772,6 +7788,17 @@ const serializeAws_restJson1ResourceTypeList = (input, context) => {
7772
7788
  return entry;
7773
7789
  });
7774
7790
  };
7791
+ const serializeAws_restJson1ResourceTypeManagementPreference = (input, context) => {
7792
+ return Object.entries(input).reduce((acc, [key, value]) => {
7793
+ if (value === null) {
7794
+ return acc;
7795
+ }
7796
+ return {
7797
+ ...acc,
7798
+ [key]: value,
7799
+ };
7800
+ }, {});
7801
+ };
7775
7802
  const serializeAws_restJson1ResourceTypeOptInPreference = (input, context) => {
7776
7803
  return Object.entries(input).reduce((acc, [key, value]) => {
7777
7804
  if (value === null) {
@@ -8509,6 +8536,17 @@ const deserializeAws_restJson1ResourceTypeList = (output, context) => {
8509
8536
  return smithy_client_1.expectString(entry);
8510
8537
  });
8511
8538
  };
8539
+ const deserializeAws_restJson1ResourceTypeManagementPreference = (output, context) => {
8540
+ return Object.entries(output).reduce((acc, [key, value]) => {
8541
+ if (value === null) {
8542
+ return acc;
8543
+ }
8544
+ return {
8545
+ ...acc,
8546
+ [key]: smithy_client_1.expectBoolean(value),
8547
+ };
8548
+ }, {});
8549
+ };
8512
8550
  const deserializeAws_restJson1ResourceTypeOptInPreference = (output, context) => {
8513
8551
  return Object.entries(output).reduce((acc, [key, value]) => {
8514
8552
  if (value === null) {
@@ -2062,7 +2062,10 @@ export var serializeAws_restJson1UpdateRegionSettingsCommand = function (input,
2062
2062
  "content-type": "application/json",
2063
2063
  };
2064
2064
  resolvedPath = "" + ((basePath === null || basePath === void 0 ? void 0 : basePath.endsWith("/")) ? basePath.slice(0, -1) : basePath || "") + "/account-settings";
2065
- body = JSON.stringify(__assign({}, (input.ResourceTypeOptInPreference !== undefined &&
2065
+ body = JSON.stringify(__assign(__assign({}, (input.ResourceTypeManagementPreference !== undefined &&
2066
+ input.ResourceTypeManagementPreference !== null && {
2067
+ ResourceTypeManagementPreference: serializeAws_restJson1ResourceTypeManagementPreference(input.ResourceTypeManagementPreference, context),
2068
+ })), (input.ResourceTypeOptInPreference !== undefined &&
2066
2069
  input.ResourceTypeOptInPreference !== null && {
2067
2070
  ResourceTypeOptInPreference: serializeAws_restJson1ResourceTypeOptInPreference(input.ResourceTypeOptInPreference, context),
2068
2071
  })));
@@ -4256,6 +4259,7 @@ export var deserializeAws_restJson1DescribeRegionSettingsCommand = function (out
4256
4259
  }
4257
4260
  contents = {
4258
4261
  $metadata: deserializeMetadata(output),
4262
+ ResourceTypeManagementPreference: undefined,
4259
4263
  ResourceTypeOptInPreference: undefined,
4260
4264
  };
4261
4265
  _a = __expectNonNull;
@@ -4263,6 +4267,9 @@ export var deserializeAws_restJson1DescribeRegionSettingsCommand = function (out
4263
4267
  return [4, parseBody(output.body, context)];
4264
4268
  case 1:
4265
4269
  data = _a.apply(void 0, [_b.apply(void 0, [_c.sent()]), "body"]);
4270
+ if (data.ResourceTypeManagementPreference !== undefined && data.ResourceTypeManagementPreference !== null) {
4271
+ contents.ResourceTypeManagementPreference = deserializeAws_restJson1ResourceTypeManagementPreference(data.ResourceTypeManagementPreference, context);
4272
+ }
4266
4273
  if (data.ResourceTypeOptInPreference !== undefined && data.ResourceTypeOptInPreference !== null) {
4267
4274
  contents.ResourceTypeOptInPreference = deserializeAws_restJson1ResourceTypeOptInPreference(data.ResourceTypeOptInPreference, context);
4268
4275
  }
@@ -8027,60 +8034,68 @@ export var deserializeAws_restJson1UpdateRecoveryPointLifecycleCommand = functio
8027
8034
  });
8028
8035
  }); };
8029
8036
  var deserializeAws_restJson1UpdateRecoveryPointLifecycleCommandError = function (output, context) { return __awaiter(void 0, void 0, void 0, function () {
8030
- var parsedOutput, _a, response, errorCode, _b, _c, _d, _e, _f, parsedBody, message;
8031
- var _g;
8032
- return __generator(this, function (_h) {
8033
- switch (_h.label) {
8037
+ var parsedOutput, _a, response, errorCode, _b, _c, _d, _e, _f, _g, parsedBody, message;
8038
+ var _h;
8039
+ return __generator(this, function (_j) {
8040
+ switch (_j.label) {
8034
8041
  case 0:
8035
8042
  _a = [__assign({}, output)];
8036
- _g = {};
8043
+ _h = {};
8037
8044
  return [4, parseBody(output.body, context)];
8038
8045
  case 1:
8039
- parsedOutput = __assign.apply(void 0, _a.concat([(_g.body = _h.sent(), _g)]));
8046
+ parsedOutput = __assign.apply(void 0, _a.concat([(_h.body = _j.sent(), _h)]));
8040
8047
  errorCode = "UnknownError";
8041
8048
  errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
8042
8049
  _b = errorCode;
8043
8050
  switch (_b) {
8044
8051
  case "InvalidParameterValueException": return [3, 2];
8045
8052
  case "com.amazonaws.backup#InvalidParameterValueException": return [3, 2];
8046
- case "MissingParameterValueException": return [3, 4];
8047
- case "com.amazonaws.backup#MissingParameterValueException": return [3, 4];
8048
- case "ResourceNotFoundException": return [3, 6];
8049
- case "com.amazonaws.backup#ResourceNotFoundException": return [3, 6];
8050
- case "ServiceUnavailableException": return [3, 8];
8051
- case "com.amazonaws.backup#ServiceUnavailableException": return [3, 8];
8053
+ case "InvalidRequestException": return [3, 4];
8054
+ case "com.amazonaws.backup#InvalidRequestException": return [3, 4];
8055
+ case "MissingParameterValueException": return [3, 6];
8056
+ case "com.amazonaws.backup#MissingParameterValueException": return [3, 6];
8057
+ case "ResourceNotFoundException": return [3, 8];
8058
+ case "com.amazonaws.backup#ResourceNotFoundException": return [3, 8];
8059
+ case "ServiceUnavailableException": return [3, 10];
8060
+ case "com.amazonaws.backup#ServiceUnavailableException": return [3, 10];
8052
8061
  }
8053
- return [3, 10];
8062
+ return [3, 12];
8054
8063
  case 2:
8055
8064
  _c = [{}];
8056
8065
  return [4, deserializeAws_restJson1InvalidParameterValueExceptionResponse(parsedOutput, context)];
8057
8066
  case 3:
8058
- response = __assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_h.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8059
- return [3, 11];
8067
+ response = __assign.apply(void 0, [__assign.apply(void 0, _c.concat([(_j.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8068
+ return [3, 13];
8060
8069
  case 4:
8061
8070
  _d = [{}];
8062
- return [4, deserializeAws_restJson1MissingParameterValueExceptionResponse(parsedOutput, context)];
8071
+ return [4, deserializeAws_restJson1InvalidRequestExceptionResponse(parsedOutput, context)];
8063
8072
  case 5:
8064
- response = __assign.apply(void 0, [__assign.apply(void 0, _d.concat([(_h.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8065
- return [3, 11];
8073
+ response = __assign.apply(void 0, [__assign.apply(void 0, _d.concat([(_j.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8074
+ return [3, 13];
8066
8075
  case 6:
8067
8076
  _e = [{}];
8068
- return [4, deserializeAws_restJson1ResourceNotFoundExceptionResponse(parsedOutput, context)];
8077
+ return [4, deserializeAws_restJson1MissingParameterValueExceptionResponse(parsedOutput, context)];
8069
8078
  case 7:
8070
- response = __assign.apply(void 0, [__assign.apply(void 0, _e.concat([(_h.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8071
- return [3, 11];
8079
+ response = __assign.apply(void 0, [__assign.apply(void 0, _e.concat([(_j.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8080
+ return [3, 13];
8072
8081
  case 8:
8073
8082
  _f = [{}];
8074
- return [4, deserializeAws_restJson1ServiceUnavailableExceptionResponse(parsedOutput, context)];
8083
+ return [4, deserializeAws_restJson1ResourceNotFoundExceptionResponse(parsedOutput, context)];
8075
8084
  case 9:
8076
- response = __assign.apply(void 0, [__assign.apply(void 0, _f.concat([(_h.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8077
- return [3, 11];
8085
+ response = __assign.apply(void 0, [__assign.apply(void 0, _f.concat([(_j.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8086
+ return [3, 13];
8078
8087
  case 10:
8088
+ _g = [{}];
8089
+ return [4, deserializeAws_restJson1ServiceUnavailableExceptionResponse(parsedOutput, context)];
8090
+ case 11:
8091
+ response = __assign.apply(void 0, [__assign.apply(void 0, _g.concat([(_j.sent())])), { name: errorCode, $metadata: deserializeMetadata(output) }]);
8092
+ return [3, 13];
8093
+ case 12:
8079
8094
  parsedBody = parsedOutput.body;
8080
8095
  errorCode = parsedBody.code || parsedBody.Code || errorCode;
8081
8096
  response = __assign(__assign({}, parsedBody), { name: "" + errorCode, message: parsedBody.message || parsedBody.Message || errorCode, $fault: "client", $metadata: deserializeMetadata(output) });
8082
- _h.label = 11;
8083
- case 11:
8097
+ _j.label = 13;
8098
+ case 13:
8084
8099
  message = response.message || response.Message || errorCode;
8085
8100
  response.message = message;
8086
8101
  delete response.Message;
@@ -8800,6 +8815,16 @@ var serializeAws_restJson1ResourceTypeList = function (input, context) {
8800
8815
  return entry;
8801
8816
  });
8802
8817
  };
8818
+ var serializeAws_restJson1ResourceTypeManagementPreference = function (input, context) {
8819
+ return Object.entries(input).reduce(function (acc, _a) {
8820
+ var _b;
8821
+ var _c = __read(_a, 2), key = _c[0], value = _c[1];
8822
+ if (value === null) {
8823
+ return acc;
8824
+ }
8825
+ return __assign(__assign({}, acc), (_b = {}, _b[key] = value, _b));
8826
+ }, {});
8827
+ };
8803
8828
  var serializeAws_restJson1ResourceTypeOptInPreference = function (input, context) {
8804
8829
  return Object.entries(input).reduce(function (acc, _a) {
8805
8830
  var _b;
@@ -9531,6 +9556,16 @@ var deserializeAws_restJson1ResourceTypeList = function (output, context) {
9531
9556
  return __expectString(entry);
9532
9557
  });
9533
9558
  };
9559
+ var deserializeAws_restJson1ResourceTypeManagementPreference = function (output, context) {
9560
+ return Object.entries(output).reduce(function (acc, _a) {
9561
+ var _b;
9562
+ var _c = __read(_a, 2), key = _c[0], value = _c[1];
9563
+ if (value === null) {
9564
+ return acc;
9565
+ }
9566
+ return __assign(__assign({}, acc), (_b = {}, _b[key] = __expectBoolean(value), _b));
9567
+ }, {});
9568
+ };
9534
9569
  var deserializeAws_restJson1ResourceTypeOptInPreference = function (output, context) {
9535
9570
  return Object.entries(output).reduce(function (acc, _a) {
9536
9571
  var _b;
@@ -86,46 +86,8 @@ export declare class Backup extends BackupClient {
86
86
  createBackupPlan(args: CreateBackupPlanCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateBackupPlanCommandOutput) => void): void;
87
87
  /**
88
88
  * <p>Creates a JSON document that specifies a set of resources to assign to a backup plan.
89
- * Resources can be included by specifying patterns for a <code>ListOfTags</code> and selected
90
- * <code>Resources</code>. </p>
91
- * <p>For example, consider the following patterns:</p>
92
- * <ul>
93
- * <li>
94
- * <p>
95
- * <code>Resources: "arn:aws:ec2:region:account-id:volume/volume-id"</code>
96
- * </p>
97
- * </li>
98
- * <li>
99
- * <p>
100
- * <code>ConditionKey:"department"</code>
101
- * </p>
102
- * <p>
103
- * <code>ConditionValue:"finance"</code>
104
- * </p>
105
- * <p>
106
- * <code>ConditionType:"StringEquals"</code>
107
- * </p>
108
- * </li>
109
- * <li>
110
- * <p>
111
- * <code>ConditionKey:"importance"</code>
112
- * </p>
113
- * <p>
114
- * <code>ConditionValue:"critical"</code>
115
- * </p>
116
- * <p>
117
- * <code>ConditionType:"StringEquals"</code>
118
- * </p>
119
- * </li>
120
- * </ul>
121
- * <p>Using these patterns would back up all Amazon Elastic Block Store (Amazon EBS)
122
- * volumes that are tagged as <code>"department=finance"</code>,
123
- * <code>"importance=critical"</code>, in addition to an EBS volume with the specified
124
- * volume ID.</p>
125
- * <p>Resources and conditions are additive in that all resources that match the pattern are
126
- * selected. This shouldn't be confused with a logical AND, where all conditions must match.
127
- * The matching patterns are logically put together using the OR operator.
128
- * In other words, all patterns that match are selected for backup.</p>
89
+ * For examples, see <a href="https://docs.aws.amazon.com/assigning-resources.html#assigning-resources-json">Assigning resources
90
+ * programmatically</a>. </p>
129
91
  */
130
92
  createBackupSelection(args: CreateBackupSelectionCommandInput, options?: __HttpHandlerOptions): Promise<CreateBackupSelectionCommandOutput>;
131
93
  createBackupSelection(args: CreateBackupSelectionCommandInput, cb: (err: any, data?: CreateBackupSelectionCommandOutput) => void): void;
@@ -494,6 +456,10 @@ export declare class Backup extends BackupClient {
494
456
  * attempts to update the lifecycle policy that controls the retention period of any recovery
495
457
  * point currently stored in a backup vault. If specified, Vault Lock enforces a minimum and
496
458
  * maximum retention period for future backup and copy jobs that target a backup vault.</p>
459
+ * <note>
460
+ * <p>Backup Vault Lock has yet to receive a third-party assessment for SEC
461
+ * 17a-4(f) and CFTC.</p>
462
+ * </note>
497
463
  */
498
464
  putBackupVaultLockConfiguration(args: PutBackupVaultLockConfigurationCommandInput, options?: __HttpHandlerOptions): Promise<PutBackupVaultLockConfigurationCommandOutput>;
499
465
  putBackupVaultLockConfiguration(args: PutBackupVaultLockConfigurationCommandInput, cb: (err: any, data?: PutBackupVaultLockConfigurationCommandOutput) => void): void;
@@ -8,46 +8,8 @@ export interface CreateBackupSelectionCommandOutput extends CreateBackupSelectio
8
8
  }
9
9
  /**
10
10
  * <p>Creates a JSON document that specifies a set of resources to assign to a backup plan.
11
- * Resources can be included by specifying patterns for a <code>ListOfTags</code> and selected
12
- * <code>Resources</code>. </p>
13
- * <p>For example, consider the following patterns:</p>
14
- * <ul>
15
- * <li>
16
- * <p>
17
- * <code>Resources: "arn:aws:ec2:region:account-id:volume/volume-id"</code>
18
- * </p>
19
- * </li>
20
- * <li>
21
- * <p>
22
- * <code>ConditionKey:"department"</code>
23
- * </p>
24
- * <p>
25
- * <code>ConditionValue:"finance"</code>
26
- * </p>
27
- * <p>
28
- * <code>ConditionType:"StringEquals"</code>
29
- * </p>
30
- * </li>
31
- * <li>
32
- * <p>
33
- * <code>ConditionKey:"importance"</code>
34
- * </p>
35
- * <p>
36
- * <code>ConditionValue:"critical"</code>
37
- * </p>
38
- * <p>
39
- * <code>ConditionType:"StringEquals"</code>
40
- * </p>
41
- * </li>
42
- * </ul>
43
- * <p>Using these patterns would back up all Amazon Elastic Block Store (Amazon EBS)
44
- * volumes that are tagged as <code>"department=finance"</code>,
45
- * <code>"importance=critical"</code>, in addition to an EBS volume with the specified
46
- * volume ID.</p>
47
- * <p>Resources and conditions are additive in that all resources that match the pattern are
48
- * selected. This shouldn't be confused with a logical AND, where all conditions must match.
49
- * The matching patterns are logically put together using the OR operator.
50
- * In other words, all patterns that match are selected for backup.</p>
11
+ * For examples, see <a href="https://docs.aws.amazon.com/assigning-resources.html#assigning-resources-json">Assigning resources
12
+ * programmatically</a>. </p>
51
13
  * @example
52
14
  * Use a bare-bones client and the command you need to make an API call.
53
15
  * ```javascript
@@ -12,6 +12,10 @@ export interface PutBackupVaultLockConfigurationCommandOutput extends __Metadata
12
12
  * attempts to update the lifecycle policy that controls the retention period of any recovery
13
13
  * point currently stored in a backup vault. If specified, Vault Lock enforces a minimum and
14
14
  * maximum retention period for future backup and copy jobs that target a backup vault.</p>
15
+ * <note>
16
+ * <p>Backup Vault Lock has yet to receive a third-party assessment for SEC
17
+ * 17a-4(f) and CFTC.</p>
18
+ * </note>
15
19
  * @example
16
20
  * Use a bare-bones client and the command you need to make an API call.
17
21
  * ```javascript
@@ -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,8 +562,20 @@ 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
+ */
559
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
+ */
560
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
+ */
561
579
  ConditionValue?: string;
562
580
  }
563
581
  export declare namespace ConditionParameter {
@@ -566,10 +584,31 @@ export declare namespace ConditionParameter {
566
584
  */
567
585
  const filterSensitiveLog: (obj: ConditionParameter) => any;
568
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
+ */
569
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
+ */
570
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
+ */
571
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
+ */
572
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
+ */
573
612
  StringNotLike?: ConditionParameter[];
574
613
  }
575
614
  export declare namespace Conditions {
@@ -583,23 +622,27 @@ export declare enum ConditionType {
583
622
  }
584
623
  /**
585
624
  * <p>Contains an array of triplets made up of a condition type (such as
586
- * <code>StringEquals</code>), a key, and a value. Conditions are used to filter resources
587
- * 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>
588
627
  */
589
628
  export interface Condition {
590
629
  /**
591
- * <p>An operation, such as <code>StringEquals</code>, that is applied to a key-value pair
592
- * 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>
593
636
  */
594
637
  ConditionType: ConditionType | string | undefined;
595
638
  /**
596
- * <p>The key in a key-value pair. For example, in <code>"ec2:ResourceTag/Department":
597
- * "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>
598
641
  */
599
642
  ConditionKey: string | undefined;
600
643
  /**
601
- * <p>The value in a key-value pair. For example, in <code>"ec2:ResourceTag/Department":
602
- * "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>
603
646
  */
604
647
  ConditionValue: string | undefined;
605
648
  }
@@ -614,7 +657,8 @@ export declare namespace Condition {
614
657
  */
615
658
  export interface BackupSelection {
616
659
  /**
617
- * <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>
618
662
  */
619
663
  SelectionName: string | undefined;
620
664
  /**
@@ -623,18 +667,62 @@ export interface BackupSelection {
623
667
  */
624
668
  IamRoleArn: string | undefined;
625
669
  /**
626
- * <p>An array of strings that contain Amazon Resource Names (ARNs)
627
- *
628
- * 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>
629
675
  */
630
676
  Resources?: string[];
631
677
  /**
632
- * <p>An array of conditions used to specify a set of resources to assign to a backup plan;
633
- * for example, <code>"StringEquals": {"ec2:ResourceTag/Department": "accounting"</code>.
634
- * 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>
635
696
  */
636
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
+ */
637
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
+ */
638
726
  Conditions?: Conditions;
639
727
  }
640
728
  export declare namespace BackupSelection {
@@ -668,7 +756,8 @@ export interface BackupSelectionsListMember {
668
756
  CreationDate?: Date;
669
757
  /**
670
758
  * <p>A unique string that identifies the request and allows failed requests to be retried
671
- * 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>
672
761
  */
673
762
  CreatorRequestId?: string;
674
763
  /**
@@ -730,7 +819,8 @@ export interface BackupVaultListMember {
730
819
  EncryptionKeyArn?: string;
731
820
  /**
732
821
  * <p>A unique string that identifies the request and allows failed requests to be retried
733
- * 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>
734
824
  */
735
825
  CreatorRequestId?: string;
736
826
  /**
@@ -861,9 +951,10 @@ export declare namespace ControlInputParameter {
861
951
  }
862
952
  /**
863
953
  * <p>A framework consists of one or more controls. Each control has its own control scope.
864
- * The control scope defines what the control will evaluate. Three examples of control scopes
865
- * are: a specific backup plan, all backup plans with a specific tag, or all backup
866
- * 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>
867
958
  * <note>
868
959
  * <p>To set a control scope that includes all of a particular resource, leave the
869
960
  * <code>ControlScope</code> empty or do not pass it when calling
@@ -882,8 +973,10 @@ export interface ControlScope {
882
973
  */
883
974
  ComplianceResourceTypes?: string[];
884
975
  /**
885
- * <p>Describes whether the control scope includes resources with one or more tags. Each tag
886
- * 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>
887
980
  */
888
981
  Tags?: {
889
982
  [key: string]: string;
@@ -1002,6 +1095,7 @@ export interface CreateBackupPlanInput {
1002
1095
  * <p>Identifies the request and allows failed requests to be retried without the risk of
1003
1096
  * running the operation twice. If the request includes a <code>CreatorRequestId</code> that
1004
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>
1005
1099
  */
1006
1100
  CreatorRequestId?: string;
1007
1101
  }
@@ -1151,7 +1245,8 @@ export interface CreateBackupSelectionInput {
1151
1245
  BackupSelection: BackupSelection | undefined;
1152
1246
  /**
1153
1247
  * <p>A unique string that identifies the request and allows failed requests to be retried
1154
- * 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>
1155
1250
  */
1156
1251
  CreatorRequestId?: string;
1157
1252
  }
@@ -1206,7 +1301,8 @@ export interface CreateBackupVaultInput {
1206
1301
  EncryptionKeyArn?: string;
1207
1302
  /**
1208
1303
  * <p>A unique string that identifies the request and allows failed requests to be retried
1209
- * 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>
1210
1306
  */
1211
1307
  CreatorRequestId?: string;
1212
1308
  }
@@ -2283,6 +2379,15 @@ export interface DescribeRegionSettingsOutput {
2283
2379
  ResourceTypeOptInPreference?: {
2284
2380
  [key: string]: boolean;
2285
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
+ };
2286
2391
  }
2287
2392
  export declare namespace DescribeRegionSettingsOutput {
2288
2393
  /**
@@ -4204,19 +4309,31 @@ export interface PutBackupVaultNotificationsInput {
4204
4309
  /**
4205
4310
  * <p>An array of events that indicate the status of jobs to back up resources to the backup
4206
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>
4207
4334
  * <note>
4208
- * <p>The following events are supported:</p>
4209
- * <p>
4210
- * <code>BACKUP_JOB_STARTED</code>, <code>BACKUP_JOB_COMPLETED</code>,</p>
4211
- * <p>
4212
- * <code>COPY_JOB_STARTED</code>, <code>COPY_JOB_SUCCESSFUL</code>,
4213
- * <code>COPY_JOB_FAILED</code>,</p>
4214
- * <p>
4215
- * <code>RESTORE_JOB_STARTED</code>, <code>RESTORE_JOB_COMPLETED</code>, and
4216
- * <code>RECOVERY_POINT_MODIFIED</code>.</p>
4217
- * <p>To find failed backup jobs, use <code>BACKUP_JOB_COMPLETED</code> and filter using
4218
- * event metadata.</p>
4219
- * <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>
4220
4337
  * </note>
4221
4338
  */
4222
4339
  BackupVaultEvents: (BackupVaultEvent | string)[] | undefined;
@@ -4565,7 +4682,8 @@ export interface TagResourceInput {
4565
4682
  ResourceArn: string | undefined;
4566
4683
  /**
4567
4684
  * <p>Key-value pairs that are used to help organize your resources. You can assign your own
4568
- * 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>
4569
4687
  */
4570
4688
  Tags: {
4571
4689
  [key: string]: string;
@@ -4784,6 +4902,15 @@ export interface UpdateRegionSettingsInput {
4784
4902
  ResourceTypeOptInPreference?: {
4785
4903
  [key: string]: boolean;
4786
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
+ };
4787
4914
  }
4788
4915
  export declare namespace UpdateRegionSettingsInput {
4789
4916
  /**
@@ -245,18 +245,26 @@ export declare namespace BackupPlanTemplatesListMember {
245
245
 
246
246
  const filterSensitiveLog: (obj: BackupPlanTemplatesListMember) => any;
247
247
  }
248
+
248
249
  export interface ConditionParameter {
250
+
249
251
  ConditionKey?: string;
252
+
250
253
  ConditionValue?: string;
251
254
  }
252
255
  export declare namespace ConditionParameter {
253
256
 
254
257
  const filterSensitiveLog: (obj: ConditionParameter) => any;
255
258
  }
259
+
256
260
  export interface Conditions {
261
+
257
262
  StringEquals?: ConditionParameter[];
263
+
258
264
  StringNotEquals?: ConditionParameter[];
265
+
259
266
  StringLike?: ConditionParameter[];
267
+
260
268
  StringNotLike?: ConditionParameter[];
261
269
  }
262
270
  export declare namespace Conditions {
@@ -289,7 +297,9 @@ export interface BackupSelection {
289
297
  Resources?: string[];
290
298
 
291
299
  ListOfTags?: Condition[];
300
+
292
301
  NotResources?: string[];
302
+
293
303
  Conditions?: Conditions;
294
304
  }
295
305
  export declare namespace BackupSelection {
@@ -1095,6 +1105,10 @@ export interface DescribeRegionSettingsOutput {
1095
1105
  ResourceTypeOptInPreference?: {
1096
1106
  [key: string]: boolean;
1097
1107
  };
1108
+
1109
+ ResourceTypeManagementPreference?: {
1110
+ [key: string]: boolean;
1111
+ };
1098
1112
  }
1099
1113
  export declare namespace DescribeRegionSettingsOutput {
1100
1114
 
@@ -2198,6 +2212,10 @@ export interface UpdateRegionSettingsInput {
2198
2212
  ResourceTypeOptInPreference?: {
2199
2213
  [key: string]: boolean;
2200
2214
  };
2215
+
2216
+ ResourceTypeManagementPreference?: {
2217
+ [key: string]: boolean;
2218
+ };
2201
2219
  }
2202
2220
  export declare namespace UpdateRegionSettingsInput {
2203
2221
 
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.42.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,7 +21,7 @@
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.42.0",
24
+ "@aws-sdk/client-sts": "3.43.0",
25
25
  "@aws-sdk/config-resolver": "3.40.0",
26
26
  "@aws-sdk/credential-provider-node": "3.41.0",
27
27
  "@aws-sdk/fetch-http-handler": "3.40.0",