@aws-sdk/client-synthetics 3.533.0 → 3.535.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 (47) hide show
  1. package/dist-types/Synthetics.d.ts +5 -1
  2. package/dist-types/SyntheticsClient.d.ts +1 -1
  3. package/dist-types/commands/AssociateResourceCommand.d.ts +2 -1
  4. package/dist-types/commands/CreateCanaryCommand.d.ts +2 -1
  5. package/dist-types/commands/CreateGroupCommand.d.ts +2 -1
  6. package/dist-types/commands/DeleteCanaryCommand.d.ts +2 -1
  7. package/dist-types/commands/DeleteGroupCommand.d.ts +2 -1
  8. package/dist-types/commands/DescribeCanariesCommand.d.ts +2 -1
  9. package/dist-types/commands/DescribeCanariesLastRunCommand.d.ts +2 -1
  10. package/dist-types/commands/DescribeRuntimeVersionsCommand.d.ts +2 -1
  11. package/dist-types/commands/DisassociateResourceCommand.d.ts +2 -1
  12. package/dist-types/commands/GetCanaryCommand.d.ts +2 -1
  13. package/dist-types/commands/GetCanaryRunsCommand.d.ts +2 -1
  14. package/dist-types/commands/GetGroupCommand.d.ts +2 -1
  15. package/dist-types/commands/ListAssociatedGroupsCommand.d.ts +2 -1
  16. package/dist-types/commands/ListGroupResourcesCommand.d.ts +2 -1
  17. package/dist-types/commands/ListGroupsCommand.d.ts +2 -1
  18. package/dist-types/commands/ListTagsForResourceCommand.d.ts +2 -1
  19. package/dist-types/commands/StartCanaryCommand.d.ts +2 -1
  20. package/dist-types/commands/StopCanaryCommand.d.ts +2 -1
  21. package/dist-types/commands/TagResourceCommand.d.ts +2 -1
  22. package/dist-types/commands/UntagResourceCommand.d.ts +2 -1
  23. package/dist-types/commands/UpdateCanaryCommand.d.ts +2 -1
  24. package/dist-types/models/models_0.d.ts +196 -196
  25. package/dist-types/ts3.4/Synthetics.d.ts +4 -0
  26. package/dist-types/ts3.4/commands/AssociateResourceCommand.d.ts +9 -0
  27. package/dist-types/ts3.4/commands/CreateCanaryCommand.d.ts +9 -0
  28. package/dist-types/ts3.4/commands/CreateGroupCommand.d.ts +9 -0
  29. package/dist-types/ts3.4/commands/DeleteCanaryCommand.d.ts +9 -0
  30. package/dist-types/ts3.4/commands/DeleteGroupCommand.d.ts +9 -0
  31. package/dist-types/ts3.4/commands/DescribeCanariesCommand.d.ts +9 -0
  32. package/dist-types/ts3.4/commands/DescribeCanariesLastRunCommand.d.ts +9 -0
  33. package/dist-types/ts3.4/commands/DescribeRuntimeVersionsCommand.d.ts +9 -0
  34. package/dist-types/ts3.4/commands/DisassociateResourceCommand.d.ts +9 -0
  35. package/dist-types/ts3.4/commands/GetCanaryCommand.d.ts +9 -0
  36. package/dist-types/ts3.4/commands/GetCanaryRunsCommand.d.ts +9 -0
  37. package/dist-types/ts3.4/commands/GetGroupCommand.d.ts +9 -0
  38. package/dist-types/ts3.4/commands/ListAssociatedGroupsCommand.d.ts +9 -0
  39. package/dist-types/ts3.4/commands/ListGroupResourcesCommand.d.ts +9 -0
  40. package/dist-types/ts3.4/commands/ListGroupsCommand.d.ts +9 -0
  41. package/dist-types/ts3.4/commands/ListTagsForResourceCommand.d.ts +9 -0
  42. package/dist-types/ts3.4/commands/StartCanaryCommand.d.ts +9 -0
  43. package/dist-types/ts3.4/commands/StopCanaryCommand.d.ts +9 -0
  44. package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +9 -0
  45. package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +9 -0
  46. package/dist-types/ts3.4/commands/UpdateCanaryCommand.d.ts +9 -0
  47. package/package.json +40 -40
@@ -13,58 +13,58 @@ export declare const EncryptionMode: {
13
13
  */
14
14
  export type EncryptionMode = (typeof EncryptionMode)[keyof typeof EncryptionMode];
15
15
  /**
16
- * @public
17
16
  * <p>A structure that contains the configuration of encryption-at-rest settings for canary artifacts that the canary
18
17
  * uploads to Amazon S3. </p>
19
18
  * <p>For more information, see
20
19
  * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_artifact_encryption.html">Encrypting canary artifacts</a>
21
20
  * </p>
21
+ * @public
22
22
  */
23
23
  export interface S3EncryptionConfig {
24
24
  /**
25
- * @public
26
25
  * <p> The encryption method to use for artifacts created by this canary. Specify <code>SSE_S3</code> to use
27
26
  * server-side encryption (SSE) with an Amazon S3-managed
28
27
  * key. Specify <code>SSE-KMS</code> to use server-side encryption with a customer-managed KMS key.</p>
29
28
  * <p>If you omit this parameter, an
30
29
  * Amazon Web Services-managed KMS key is used.
31
30
  * </p>
31
+ * @public
32
32
  */
33
33
  EncryptionMode?: EncryptionMode;
34
34
  /**
35
- * @public
36
35
  * <p>The ARN of the customer-managed KMS key to use, if you specify <code>SSE-KMS</code>
37
36
  * for <code>EncryptionMode</code>
38
37
  * </p>
38
+ * @public
39
39
  */
40
40
  KmsKeyArn?: string;
41
41
  }
42
42
  /**
43
- * @public
44
43
  * <p>A structure that contains the configuration for canary artifacts, including the
45
44
  * encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.</p>
45
+ * @public
46
46
  */
47
47
  export interface ArtifactConfigInput {
48
48
  /**
49
- * @public
50
49
  * <p>A structure that contains the configuration of the encryption-at-rest settings for artifacts that the canary uploads
51
50
  * to Amazon S3.
52
51
  * Artifact encryption functionality is available only for canaries that use Synthetics runtime version
53
52
  * syn-nodejs-puppeteer-3.3 or later. For more information, see
54
53
  * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_artifact_encryption.html">Encrypting canary artifacts</a>
55
54
  * </p>
55
+ * @public
56
56
  */
57
57
  S3Encryption?: S3EncryptionConfig;
58
58
  }
59
59
  /**
60
- * @public
61
60
  * <p>A structure that contains the configuration for canary artifacts, including
62
61
  * the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.</p>
62
+ * @public
63
63
  */
64
64
  export interface ArtifactConfigOutput {
65
65
  /**
66
- * @public
67
66
  * <p>A structure that contains the configuration of encryption settings for canary artifacts that are stored in Amazon S3. </p>
67
+ * @public
68
68
  */
69
69
  S3Encryption?: S3EncryptionConfig;
70
70
  }
@@ -73,14 +73,14 @@ export interface ArtifactConfigOutput {
73
73
  */
74
74
  export interface AssociateResourceRequest {
75
75
  /**
76
- * @public
77
76
  * <p>Specifies the group. You can specify the group name, the ARN, or the
78
77
  * group ID as the <code>GroupIdentifier</code>.</p>
78
+ * @public
79
79
  */
80
80
  GroupIdentifier: string | undefined;
81
81
  /**
82
- * @public
83
82
  * <p>The ARN of the canary that you want to associate with the specified group.</p>
83
+ * @public
84
84
  */
85
85
  ResourceArn: string | undefined;
86
86
  }
@@ -90,8 +90,8 @@ export interface AssociateResourceRequest {
90
90
  export interface AssociateResourceResponse {
91
91
  }
92
92
  /**
93
- * @public
94
93
  * <p>A conflicting operation is already in progress.</p>
94
+ * @public
95
95
  */
96
96
  export declare class ConflictException extends __BaseException {
97
97
  readonly name: "ConflictException";
@@ -103,8 +103,8 @@ export declare class ConflictException extends __BaseException {
103
103
  constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
104
104
  }
105
105
  /**
106
- * @public
107
106
  * <p>An unknown internal error occurred.</p>
107
+ * @public
108
108
  */
109
109
  export declare class InternalServerException extends __BaseException {
110
110
  readonly name: "InternalServerException";
@@ -116,8 +116,8 @@ export declare class InternalServerException extends __BaseException {
116
116
  constructor(opts: __ExceptionOptionType<InternalServerException, __BaseException>);
117
117
  }
118
118
  /**
119
- * @public
120
119
  * <p>One of the specified resources was not found.</p>
120
+ * @public
121
121
  */
122
122
  export declare class ResourceNotFoundException extends __BaseException {
123
123
  readonly name: "ResourceNotFoundException";
@@ -129,8 +129,8 @@ export declare class ResourceNotFoundException extends __BaseException {
129
129
  constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
130
130
  }
131
131
  /**
132
- * @public
133
132
  * <p>The request exceeded a service quota value.</p>
133
+ * @public
134
134
  */
135
135
  export declare class ServiceQuotaExceededException extends __BaseException {
136
136
  readonly name: "ServiceQuotaExceededException";
@@ -142,8 +142,8 @@ export declare class ServiceQuotaExceededException extends __BaseException {
142
142
  constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
143
143
  }
144
144
  /**
145
- * @public
146
145
  * <p>A parameter could not be validated.</p>
146
+ * @public
147
147
  */
148
148
  export declare class ValidationException extends __BaseException {
149
149
  readonly name: "ValidationException";
@@ -155,8 +155,8 @@ export declare class ValidationException extends __BaseException {
155
155
  constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
156
156
  }
157
157
  /**
158
- * @public
159
158
  * <p>The request was not valid.</p>
159
+ * @public
160
160
  */
161
161
  export declare class BadRequestException extends __BaseException {
162
162
  readonly name: "BadRequestException";
@@ -168,74 +168,73 @@ export declare class BadRequestException extends __BaseException {
168
168
  constructor(opts: __ExceptionOptionType<BadRequestException, __BaseException>);
169
169
  }
170
170
  /**
171
- * @public
172
171
  * <p>A structure representing a screenshot that is used as a baseline during visual monitoring comparisons made by the canary.</p>
172
+ * @public
173
173
  */
174
174
  export interface BaseScreenshot {
175
175
  /**
176
- * @public
177
176
  * <p>The name of the screenshot. This is generated the first time the canary is run after the <code>UpdateCanary</code> operation that
178
177
  * specified for this canary to perform visual monitoring.</p>
178
+ * @public
179
179
  */
180
180
  ScreenshotName: string | undefined;
181
181
  /**
182
- * @public
183
182
  * <p>Coordinates that define the part of a screen to ignore during screenshot comparisons. To obtain the
184
183
  * coordinates to use here, use the
185
184
  * CloudWatch console to draw the boundaries on the screen. For more information, see
186
185
  * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/synthetics_canaries_deletion.html">
187
186
  * Editing or deleting a canary</a>
188
187
  * </p>
188
+ * @public
189
189
  */
190
190
  IgnoreCoordinates?: string[];
191
191
  }
192
192
  /**
193
- * @public
194
193
  * <p>This structure contains information about the canary's Lambda handler and
195
194
  * where its code is stored by CloudWatch Synthetics.</p>
195
+ * @public
196
196
  */
197
197
  export interface CanaryCodeOutput {
198
198
  /**
199
- * @public
200
199
  * <p>The ARN of the Lambda layer where Synthetics stores the canary script code.</p>
200
+ * @public
201
201
  */
202
202
  SourceLocationArn?: string;
203
203
  /**
204
- * @public
205
204
  * <p>The entry point to use for the source code when running the canary.</p>
205
+ * @public
206
206
  */
207
207
  Handler?: string;
208
208
  }
209
209
  /**
210
- * @public
211
210
  * <p>A structure that contains information about a canary run.</p>
211
+ * @public
212
212
  */
213
213
  export interface CanaryRunConfigOutput {
214
214
  /**
215
- * @public
216
215
  * <p>How long the canary is allowed to run before it must stop.</p>
216
+ * @public
217
217
  */
218
218
  TimeoutInSeconds?: number;
219
219
  /**
220
- * @public
221
220
  * <p>The maximum amount of memory available to the canary while it is running, in MB. This value
222
221
  * must be a multiple of 64.</p>
222
+ * @public
223
223
  */
224
224
  MemoryInMB?: number;
225
225
  /**
226
- * @public
227
226
  * <p>Displays whether this canary run used active X-Ray tracing. </p>
227
+ * @public
228
228
  */
229
229
  ActiveTracing?: boolean;
230
230
  }
231
231
  /**
232
- * @public
233
232
  * <p>How long, in seconds, for the canary to continue making regular runs according to the schedule in the
234
233
  * <code>Expression</code> value.</p>
234
+ * @public
235
235
  */
236
236
  export interface CanaryScheduleOutput {
237
237
  /**
238
- * @public
239
238
  * <p>A <code>rate</code> expression or a <code>cron</code> expression that defines how often the canary is to run.</p>
240
239
  * <p>For a rate expression, The syntax is
241
240
  * <code>rate(<i>number unit</i>)</code>. <i>unit</i>
@@ -250,13 +249,14 @@ export interface CanaryScheduleOutput {
250
249
  * expression. For information about the syntax for cron expressions, see
251
250
  * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_cron.html">
252
251
  * Scheduling canary runs using cron</a>.</p>
252
+ * @public
253
253
  */
254
254
  Expression?: string;
255
255
  /**
256
- * @public
257
256
  * <p>How long, in seconds, for the canary to continue making regular runs after it
258
257
  * was created. The runs are performed according to the schedule in the
259
258
  * <code>Expression</code> value.</p>
259
+ * @public
260
260
  */
261
261
  DurationInSeconds?: number;
262
262
  }
@@ -302,196 +302,196 @@ export declare const CanaryStateReasonCode: {
302
302
  */
303
303
  export type CanaryStateReasonCode = (typeof CanaryStateReasonCode)[keyof typeof CanaryStateReasonCode];
304
304
  /**
305
- * @public
306
305
  * <p>A structure that contains the current state of the canary.</p>
306
+ * @public
307
307
  */
308
308
  export interface CanaryStatus {
309
309
  /**
310
- * @public
311
310
  * <p>The current state of the canary.</p>
311
+ * @public
312
312
  */
313
313
  State?: CanaryState;
314
314
  /**
315
- * @public
316
315
  * <p>If the canary has insufficient permissions to run, this field provides more details.</p>
316
+ * @public
317
317
  */
318
318
  StateReason?: string;
319
319
  /**
320
- * @public
321
320
  * <p>If the canary cannot run or has failed, this field displays the reason.</p>
321
+ * @public
322
322
  */
323
323
  StateReasonCode?: CanaryStateReasonCode;
324
324
  }
325
325
  /**
326
- * @public
327
326
  * <p>This structure contains information about when the canary was created and modified.</p>
327
+ * @public
328
328
  */
329
329
  export interface CanaryTimeline {
330
330
  /**
331
- * @public
332
331
  * <p>The date and time the canary was created.</p>
332
+ * @public
333
333
  */
334
334
  Created?: Date;
335
335
  /**
336
- * @public
337
336
  * <p>The date and time the canary was most recently modified.</p>
337
+ * @public
338
338
  */
339
339
  LastModified?: Date;
340
340
  /**
341
- * @public
342
341
  * <p>The date and time that the canary's most recent run started.</p>
342
+ * @public
343
343
  */
344
344
  LastStarted?: Date;
345
345
  /**
346
- * @public
347
346
  * <p>The date and time that the canary's most recent run ended.</p>
347
+ * @public
348
348
  */
349
349
  LastStopped?: Date;
350
350
  }
351
351
  /**
352
- * @public
353
352
  * <p>If this canary performs visual monitoring by comparing screenshots, this structure contains the ID of the canary run that is used as the baseline for screenshots, and the coordinates
354
353
  * of any parts of those screenshots that are ignored during visual monitoring comparison.</p>
355
354
  * <p>Visual monitoring is supported only on canaries running the <b>syn-puppeteer-node-3.2</b> runtime or later.</p>
355
+ * @public
356
356
  */
357
357
  export interface VisualReferenceOutput {
358
358
  /**
359
- * @public
360
359
  * <p>An array of screenshots that are used as the baseline for comparisons during visual monitoring.</p>
360
+ * @public
361
361
  */
362
362
  BaseScreenshots?: BaseScreenshot[];
363
363
  /**
364
- * @public
365
364
  * <p>The ID of the canary run that produced the baseline screenshots
366
365
  * that are used for visual monitoring comparisons by this canary.</p>
366
+ * @public
367
367
  */
368
368
  BaseCanaryRunId?: string;
369
369
  }
370
370
  /**
371
- * @public
372
371
  * <p>If this canary is to test an endpoint in a VPC, this structure contains
373
372
  * information about the subnets and security groups of the VPC endpoint.
374
373
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html">
375
374
  * Running a Canary in a VPC</a>.</p>
375
+ * @public
376
376
  */
377
377
  export interface VpcConfigOutput {
378
378
  /**
379
- * @public
380
379
  * <p>The IDs of the VPC where this canary is to run.</p>
380
+ * @public
381
381
  */
382
382
  VpcId?: string;
383
383
  /**
384
- * @public
385
384
  * <p>The IDs of the subnets where this canary is to run.</p>
385
+ * @public
386
386
  */
387
387
  SubnetIds?: string[];
388
388
  /**
389
- * @public
390
389
  * <p>The IDs of the security groups for this canary.</p>
390
+ * @public
391
391
  */
392
392
  SecurityGroupIds?: string[];
393
393
  }
394
394
  /**
395
- * @public
396
395
  * <p>This structure contains all information about one canary in your account.</p>
396
+ * @public
397
397
  */
398
398
  export interface Canary {
399
399
  /**
400
- * @public
401
400
  * <p>The unique ID of this canary.</p>
401
+ * @public
402
402
  */
403
403
  Id?: string;
404
404
  /**
405
- * @public
406
405
  * <p>The name of the canary.</p>
406
+ * @public
407
407
  */
408
408
  Name?: string;
409
409
  /**
410
- * @public
411
410
  * <p>This structure contains information about the canary's Lambda handler and
412
411
  * where its code is stored by CloudWatch Synthetics.</p>
412
+ * @public
413
413
  */
414
414
  Code?: CanaryCodeOutput;
415
415
  /**
416
- * @public
417
416
  * <p>The ARN of the IAM role used to run the canary. This role must include <code>lambda.amazonaws.com</code> as a principal in the trust
418
417
  * policy.</p>
418
+ * @public
419
419
  */
420
420
  ExecutionRoleArn?: string;
421
421
  /**
422
- * @public
423
422
  * <p>A structure that contains information about how often the canary is to run, and when
424
423
  * these runs are to stop.</p>
424
+ * @public
425
425
  */
426
426
  Schedule?: CanaryScheduleOutput;
427
427
  /**
428
- * @public
429
428
  * <p>A structure that contains information about a canary run.</p>
429
+ * @public
430
430
  */
431
431
  RunConfig?: CanaryRunConfigOutput;
432
432
  /**
433
- * @public
434
433
  * <p>The number of days to retain data about successful runs of this canary.</p>
434
+ * @public
435
435
  */
436
436
  SuccessRetentionPeriodInDays?: number;
437
437
  /**
438
- * @public
439
438
  * <p>The number of days to retain data about failed runs of this canary.</p>
439
+ * @public
440
440
  */
441
441
  FailureRetentionPeriodInDays?: number;
442
442
  /**
443
- * @public
444
443
  * <p>A structure that contains information about the canary's status.</p>
444
+ * @public
445
445
  */
446
446
  Status?: CanaryStatus;
447
447
  /**
448
- * @public
449
448
  * <p>A structure that contains information about when the canary was created, modified, and
450
449
  * most recently run.</p>
450
+ * @public
451
451
  */
452
452
  Timeline?: CanaryTimeline;
453
453
  /**
454
- * @public
455
454
  * <p>The location in Amazon S3 where Synthetics stores artifacts from the runs of this
456
455
  * canary. Artifacts include the log file, screenshots, and HAR files.</p>
456
+ * @public
457
457
  */
458
458
  ArtifactS3Location?: string;
459
459
  /**
460
- * @public
461
460
  * <p>The ARN of the Lambda function that is used as your canary's engine. For more information
462
461
  * about Lambda ARN format, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-api-permissions-ref.html">Resources and Conditions for Lambda Actions</a>.</p>
462
+ * @public
463
463
  */
464
464
  EngineArn?: string;
465
465
  /**
466
- * @public
467
466
  * <p>Specifies the runtime version to use for the canary. For more information about
468
467
  * runtime versions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html">
469
468
  * Canary Runtime Versions</a>.</p>
469
+ * @public
470
470
  */
471
471
  RuntimeVersion?: string;
472
472
  /**
473
- * @public
474
473
  * <p>If this canary is to test an endpoint in a VPC, this structure contains
475
474
  * information about the subnets and security groups of the VPC endpoint.
476
475
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html">
477
476
  * Running a Canary in a VPC</a>.</p>
477
+ * @public
478
478
  */
479
479
  VpcConfig?: VpcConfigOutput;
480
480
  /**
481
- * @public
482
481
  * <p>If this canary performs visual monitoring by comparing screenshots, this structure contains the ID of the canary run to use as the baseline for screenshots, and the coordinates
483
482
  * of any parts of the screen to ignore during the visual monitoring comparison.</p>
483
+ * @public
484
484
  */
485
485
  VisualReference?: VisualReferenceOutput;
486
486
  /**
487
- * @public
488
487
  * <p>The list of key-value pairs that are associated with the canary.</p>
488
+ * @public
489
489
  */
490
490
  Tags?: Record<string, string>;
491
491
  /**
492
- * @public
493
492
  * <p>A structure that contains the configuration for canary artifacts, including
494
493
  * the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.</p>
494
+ * @public
495
495
  */
496
496
  ArtifactConfig?: ArtifactConfigOutput;
497
497
  }
@@ -521,128 +521,127 @@ export declare const CanaryRunStateReasonCode: {
521
521
  */
522
522
  export type CanaryRunStateReasonCode = (typeof CanaryRunStateReasonCode)[keyof typeof CanaryRunStateReasonCode];
523
523
  /**
524
- * @public
525
524
  * <p>This structure contains the status information about a canary run.</p>
525
+ * @public
526
526
  */
527
527
  export interface CanaryRunStatus {
528
528
  /**
529
- * @public
530
529
  * <p>The current state of the run.</p>
530
+ * @public
531
531
  */
532
532
  State?: CanaryRunState;
533
533
  /**
534
- * @public
535
534
  * <p>If run of the canary failed, this field contains the reason for the error.</p>
535
+ * @public
536
536
  */
537
537
  StateReason?: string;
538
538
  /**
539
- * @public
540
539
  * <p>If this value is <code>CANARY_FAILURE</code>, an exception occurred in the
541
540
  * canary code. If this value is <code>EXECUTION_FAILURE</code>, an exception occurred in
542
541
  * CloudWatch Synthetics.</p>
542
+ * @public
543
543
  */
544
544
  StateReasonCode?: CanaryRunStateReasonCode;
545
545
  }
546
546
  /**
547
- * @public
548
547
  * <p>This structure contains the start and end times of a single canary run.</p>
548
+ * @public
549
549
  */
550
550
  export interface CanaryRunTimeline {
551
551
  /**
552
- * @public
553
552
  * <p>The start time of the run.</p>
553
+ * @public
554
554
  */
555
555
  Started?: Date;
556
556
  /**
557
- * @public
558
557
  * <p>The end time of the run.</p>
558
+ * @public
559
559
  */
560
560
  Completed?: Date;
561
561
  }
562
562
  /**
563
- * @public
564
563
  * <p>This structure contains the details about one run of one canary.</p>
564
+ * @public
565
565
  */
566
566
  export interface CanaryRun {
567
567
  /**
568
- * @public
569
568
  * <p>A unique ID that identifies this canary run.</p>
569
+ * @public
570
570
  */
571
571
  Id?: string;
572
572
  /**
573
- * @public
574
573
  * <p>The name of the canary.</p>
574
+ * @public
575
575
  */
576
576
  Name?: string;
577
577
  /**
578
- * @public
579
578
  * <p>The status of this run.</p>
579
+ * @public
580
580
  */
581
581
  Status?: CanaryRunStatus;
582
582
  /**
583
- * @public
584
583
  * <p>A structure that contains the start and end times of this run.</p>
584
+ * @public
585
585
  */
586
586
  Timeline?: CanaryRunTimeline;
587
587
  /**
588
- * @public
589
588
  * <p>The location where the canary stored artifacts from the run. Artifacts include
590
589
  * the log file, screenshots, and HAR files.</p>
590
+ * @public
591
591
  */
592
592
  ArtifactS3Location?: string;
593
593
  }
594
594
  /**
595
- * @public
596
595
  * <p>This structure contains information about the most recent run of a single canary.</p>
596
+ * @public
597
597
  */
598
598
  export interface CanaryLastRun {
599
599
  /**
600
- * @public
601
600
  * <p>The name of the canary.</p>
601
+ * @public
602
602
  */
603
603
  CanaryName?: string;
604
604
  /**
605
- * @public
606
605
  * <p>The results from this canary's most recent run.</p>
606
+ * @public
607
607
  */
608
608
  LastRun?: CanaryRun;
609
609
  }
610
610
  /**
611
- * @public
612
611
  * <p>Use this structure to input your script code for the canary. This structure contains the
613
612
  * Lambda handler with the location where the canary should start running the script. If the
614
613
  * script is stored in an S3 bucket, the bucket name, key, and version are also included. If
615
614
  * the script was passed into the canary directly, the script code is contained in the value
616
615
  * of <code>Zipfile</code>. </p>
616
+ * @public
617
617
  */
618
618
  export interface CanaryCodeInput {
619
619
  /**
620
- * @public
621
620
  * <p>If your canary script is located in S3, specify the bucket name here. Do not include <code>s3://</code> as the
622
621
  * start of the bucket name.</p>
622
+ * @public
623
623
  */
624
624
  S3Bucket?: string;
625
625
  /**
626
- * @public
627
626
  * <p>The S3 key of your script. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingObjects.html">Working with Amazon S3 Objects</a>.</p>
627
+ * @public
628
628
  */
629
629
  S3Key?: string;
630
630
  /**
631
- * @public
632
631
  * <p>The S3 version ID of your script.</p>
632
+ * @public
633
633
  */
634
634
  S3Version?: string;
635
635
  /**
636
- * @public
637
636
  * <p>If you input your canary script directly into the canary instead of referring to an S3
638
637
  * location, the value of this parameter is the base64-encoded contents of the .zip file that
639
638
  * contains the script. It must be smaller than 225 Kb.</p>
640
639
  * <p>For large canary scripts, we recommend that you use an S3 location instead of inputting it
641
640
  * directly with this parameter.</p>
641
+ * @public
642
642
  */
643
643
  ZipFile?: Uint8Array;
644
644
  /**
645
- * @public
646
645
  * <p>The entry point to use for the source code when running the canary. For canaries that use the
647
646
  * <code>syn-python-selenium-1.0</code> runtime
648
647
  * or a <code>syn-nodejs.puppeteer</code> runtime earlier than <code>syn-nodejs.puppeteer-3.4</code>,
@@ -656,29 +655,29 @@ export interface CanaryCodeInput {
656
655
  * <code>
657
656
  * <i>folder</i>/<i>fileName</i>.<i>functionName</i>
658
657
  * </code>.</p>
658
+ * @public
659
659
  */
660
660
  Handler: string | undefined;
661
661
  }
662
662
  /**
663
- * @public
664
663
  * <p>A structure that contains input information for a canary run.</p>
664
+ * @public
665
665
  */
666
666
  export interface CanaryRunConfigInput {
667
667
  /**
668
- * @public
669
668
  * <p>How long the canary is allowed to run before it must stop. You can't set this time to be longer
670
669
  * than the frequency of the runs of this canary.</p>
671
670
  * <p>If you omit this field, the
672
671
  * frequency of the canary is used as this value, up to a maximum of 14 minutes.</p>
672
+ * @public
673
673
  */
674
674
  TimeoutInSeconds?: number;
675
675
  /**
676
- * @public
677
676
  * <p>The maximum amount of memory available to the canary while it is running, in MB. This value must be a multiple of 64.</p>
677
+ * @public
678
678
  */
679
679
  MemoryInMB?: number;
680
680
  /**
681
- * @public
682
681
  * <p>Specifies whether this canary is to use active X-Ray tracing when it runs. Active tracing
683
682
  * enables
684
683
  * this canary run to be displayed in the ServiceLens and X-Ray service maps even if the canary does
@@ -687,10 +686,10 @@ export interface CanaryRunConfigInput {
687
686
  * Canaries and X-Ray tracing</a>.</p>
688
687
  * <p>You can enable active tracing only for canaries that use version <code>syn-nodejs-2.0</code>
689
688
  * or later for their canary runtime.</p>
689
+ * @public
690
690
  */
691
691
  ActiveTracing?: boolean;
692
692
  /**
693
- * @public
694
693
  * <p>Specifies the keys and values to use for any environment variables
695
694
  * used in the canary script. Use the following format:</p>
696
695
  * <p>\{ "key1" : "value1", "key2" : "value2", ...\}</p>
@@ -703,17 +702,17 @@ export interface CanaryRunConfigInput {
703
702
  * <p>The environment variables keys and values are not encrypted. Do not store sensitive information
704
703
  * in this field.</p>
705
704
  * </important>
705
+ * @public
706
706
  */
707
707
  EnvironmentVariables?: Record<string, string>;
708
708
  }
709
709
  /**
710
- * @public
711
710
  * <p>This structure specifies how often a canary is to make runs and the date and time
712
711
  * when it should stop making runs.</p>
712
+ * @public
713
713
  */
714
714
  export interface CanaryScheduleInput {
715
715
  /**
716
- * @public
717
716
  * <p>A <code>rate</code> expression or a <code>cron</code> expression that defines how often the canary is to run.</p>
718
717
  * <p>For a rate expression, The syntax is
719
718
  * <code>rate(<i>number unit</i>)</code>. <i>unit</i>
@@ -728,32 +727,33 @@ export interface CanaryScheduleInput {
728
727
  * expression. You can't schedule a canary to wait for more than a year before running. For information about the syntax for cron expressions, see
729
728
  * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_cron.html">
730
729
  * Scheduling canary runs using cron</a>.</p>
730
+ * @public
731
731
  */
732
732
  Expression: string | undefined;
733
733
  /**
734
- * @public
735
734
  * <p>How long, in seconds, for the canary to continue making regular runs according to
736
735
  * the schedule in the <code>Expression</code> value. If you specify 0, the canary continues
737
736
  * making runs until you stop it. If you omit this field, the default of 0 is used.</p>
737
+ * @public
738
738
  */
739
739
  DurationInSeconds?: number;
740
740
  }
741
741
  /**
742
- * @public
743
742
  * <p>If this canary is to test an endpoint in a VPC, this structure contains
744
743
  * information about the subnets and security groups of the VPC endpoint.
745
744
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html">
746
745
  * Running a Canary in a VPC</a>.</p>
746
+ * @public
747
747
  */
748
748
  export interface VpcConfigInput {
749
749
  /**
750
- * @public
751
750
  * <p>The IDs of the subnets where this canary is to run.</p>
751
+ * @public
752
752
  */
753
753
  SubnetIds?: string[];
754
754
  /**
755
- * @public
756
755
  * <p>The IDs of the security groups for this canary.</p>
756
+ * @public
757
757
  */
758
758
  SecurityGroupIds?: string[];
759
759
  }
@@ -762,32 +762,31 @@ export interface VpcConfigInput {
762
762
  */
763
763
  export interface CreateCanaryRequest {
764
764
  /**
765
- * @public
766
765
  * <p>The name for this canary. Be sure to give it a descriptive name
767
766
  * that distinguishes it from other canaries in your account.</p>
768
767
  * <p>Do not include secrets or proprietary information in your canary names. The canary name
769
768
  * makes up part of the canary ARN, and the ARN is included in outbound calls over the
770
769
  * internet. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/servicelens_canaries_security.html">Security
771
770
  * Considerations for Synthetics Canaries</a>.</p>
771
+ * @public
772
772
  */
773
773
  Name: string | undefined;
774
774
  /**
775
- * @public
776
775
  * <p>A structure that includes the entry point from which the canary should start
777
776
  * running your script. If the script is stored in
778
777
  * an S3 bucket, the bucket name, key, and version are also included.
779
778
  * </p>
779
+ * @public
780
780
  */
781
781
  Code: CanaryCodeInput | undefined;
782
782
  /**
783
- * @public
784
783
  * <p>The location in Amazon S3 where Synthetics stores artifacts from the test runs of this
785
784
  * canary. Artifacts include the log file, screenshots, and HAR files. The name of the
786
785
  * S3 bucket can't include a period (.).</p>
786
+ * @public
787
787
  */
788
788
  ArtifactS3Location: string | undefined;
789
789
  /**
790
- * @public
791
790
  * <p>The ARN of the IAM role to be used to run the canary. This role must already exist,
792
791
  * and must include <code>lambda.amazonaws.com</code> as a principal in the trust
793
792
  * policy. The role must also have the following permissions:</p>
@@ -828,66 +827,67 @@ export interface CreateCanaryRequest {
828
827
  * </p>
829
828
  * </li>
830
829
  * </ul>
830
+ * @public
831
831
  */
832
832
  ExecutionRoleArn: string | undefined;
833
833
  /**
834
- * @public
835
834
  * <p>A structure that contains information about how often the canary is to run and when
836
835
  * these test runs are to stop.</p>
836
+ * @public
837
837
  */
838
838
  Schedule: CanaryScheduleInput | undefined;
839
839
  /**
840
- * @public
841
840
  * <p>A structure that contains the configuration for individual canary runs,
842
841
  * such as timeout value and environment variables.</p>
843
842
  * <important>
844
843
  * <p>The environment variables keys and values are not encrypted. Do not store sensitive information
845
844
  * in this field.</p>
846
845
  * </important>
846
+ * @public
847
847
  */
848
848
  RunConfig?: CanaryRunConfigInput;
849
849
  /**
850
- * @public
851
850
  * <p>The number of days to retain data about successful runs of this canary. If you omit
852
851
  * this field, the default of 31 days is used. The valid range is 1 to 455 days.</p>
852
+ * @public
853
853
  */
854
854
  SuccessRetentionPeriodInDays?: number;
855
855
  /**
856
- * @public
857
856
  * <p>The number of days to retain data about failed runs of this canary. If you omit
858
857
  * this field, the default of 31 days is used. The valid range is 1 to 455 days.</p>
858
+ * @public
859
859
  */
860
860
  FailureRetentionPeriodInDays?: number;
861
861
  /**
862
- * @public
863
862
  * <p>Specifies the runtime version to use for the canary. For a list of valid
864
863
  * runtime versions and more information about
865
864
  * runtime versions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html">
866
865
  * Canary Runtime Versions</a>.</p>
866
+ * @public
867
867
  */
868
868
  RuntimeVersion: string | undefined;
869
869
  /**
870
- * @public
871
870
  * <p>If this canary is to test an endpoint in a VPC, this structure contains
872
871
  * information about the subnet and security groups of the VPC endpoint.
873
872
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html">
874
873
  * Running a Canary in a VPC</a>.</p>
874
+ * @public
875
875
  */
876
876
  VpcConfig?: VpcConfigInput;
877
877
  /**
878
- * @public
879
878
  * <p>A list of key-value pairs to associate with the canary.
880
879
  * You can associate as many as 50 tags with a canary.</p>
881
880
  * <p>Tags can help you organize and categorize your
882
881
  * resources. You can also use them to scope user permissions, by
883
882
  * granting a user permission to access or change only the resources that have
884
883
  * certain tag values.</p>
884
+ * @public
885
885
  */
886
886
  Tags?: Record<string, string>;
887
887
  /**
888
- * @public
889
888
  * <p>A structure that contains the configuration for canary artifacts, including
890
889
  * the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.</p>
890
+ * @public
891
891
  */
892
892
  ArtifactConfig?: ArtifactConfigInput;
893
893
  }
@@ -896,14 +896,14 @@ export interface CreateCanaryRequest {
896
896
  */
897
897
  export interface CreateCanaryResponse {
898
898
  /**
899
- * @public
900
899
  * <p>The full details about the canary you have created.</p>
900
+ * @public
901
901
  */
902
902
  Canary?: Canary;
903
903
  }
904
904
  /**
905
- * @public
906
905
  * <p>One of the input resources is larger than is allowed.</p>
906
+ * @public
907
907
  */
908
908
  export declare class RequestEntityTooLargeException extends __BaseException {
909
909
  readonly name: "RequestEntityTooLargeException";
@@ -919,55 +919,55 @@ export declare class RequestEntityTooLargeException extends __BaseException {
919
919
  */
920
920
  export interface CreateGroupRequest {
921
921
  /**
922
- * @public
923
922
  * <p>The name for the group. It can include any Unicode characters.</p>
924
923
  * <p>The names for all groups in your account, across all Regions, must be unique.</p>
924
+ * @public
925
925
  */
926
926
  Name: string | undefined;
927
927
  /**
928
- * @public
929
928
  * <p>A list of key-value pairs to associate with the group.
930
929
  * You can associate as many as 50 tags with a group.</p>
931
930
  * <p>Tags can help you organize and categorize your
932
931
  * resources. You can also use them to scope user permissions, by
933
932
  * granting a user permission to access or change only the resources that have
934
933
  * certain tag values.</p>
934
+ * @public
935
935
  */
936
936
  Tags?: Record<string, string>;
937
937
  }
938
938
  /**
939
- * @public
940
939
  * <p>This structure contains information about one group.</p>
940
+ * @public
941
941
  */
942
942
  export interface Group {
943
943
  /**
944
- * @public
945
944
  * <p>The unique ID of the group.</p>
945
+ * @public
946
946
  */
947
947
  Id?: string;
948
948
  /**
949
- * @public
950
949
  * <p>The name of the group.</p>
950
+ * @public
951
951
  */
952
952
  Name?: string;
953
953
  /**
954
- * @public
955
954
  * <p>The ARN of the group.</p>
955
+ * @public
956
956
  */
957
957
  Arn?: string;
958
958
  /**
959
- * @public
960
959
  * <p>The list of key-value pairs that are associated with the canary.</p>
960
+ * @public
961
961
  */
962
962
  Tags?: Record<string, string>;
963
963
  /**
964
- * @public
965
964
  * <p>The date and time that the group was created.</p>
965
+ * @public
966
966
  */
967
967
  CreatedTime?: Date;
968
968
  /**
969
- * @public
970
969
  * <p>The date and time that the group was most recently updated.</p>
970
+ * @public
971
971
  */
972
972
  LastModifiedTime?: Date;
973
973
  }
@@ -976,8 +976,8 @@ export interface Group {
976
976
  */
977
977
  export interface CreateGroupResponse {
978
978
  /**
979
- * @public
980
979
  * <p>A structure that contains information about the group that was just created.</p>
980
+ * @public
981
981
  */
982
982
  Group?: Group;
983
983
  }
@@ -986,15 +986,15 @@ export interface CreateGroupResponse {
986
986
  */
987
987
  export interface DeleteCanaryRequest {
988
988
  /**
989
- * @public
990
989
  * <p>The name of the canary that you want to delete. To find the names of your canaries, use <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DescribeCanaries.html">DescribeCanaries</a>.</p>
990
+ * @public
991
991
  */
992
992
  Name: string | undefined;
993
993
  /**
994
- * @public
995
994
  * <p>Specifies whether to also delete the Lambda functions and layers used by this canary. The default
996
995
  * is false.</p>
997
996
  * <p>Type: Boolean</p>
997
+ * @public
998
998
  */
999
999
  DeleteLambda?: boolean;
1000
1000
  }
@@ -1008,9 +1008,9 @@ export interface DeleteCanaryResponse {
1008
1008
  */
1009
1009
  export interface DeleteGroupRequest {
1010
1010
  /**
1011
- * @public
1012
1011
  * <p>Specifies which group to delete. You can specify the group name, the ARN, or the
1013
1012
  * group ID as the <code>GroupIdentifier</code>.</p>
1013
+ * @public
1014
1014
  */
1015
1015
  GroupIdentifier: string | undefined;
1016
1016
  }
@@ -1024,20 +1024,19 @@ export interface DeleteGroupResponse {
1024
1024
  */
1025
1025
  export interface DescribeCanariesRequest {
1026
1026
  /**
1027
- * @public
1028
1027
  * <p>A token that indicates that there is more data
1029
1028
  * available. You can use this token in a subsequent operation to retrieve the next
1030
1029
  * set of results.</p>
1030
+ * @public
1031
1031
  */
1032
1032
  NextToken?: string;
1033
1033
  /**
1034
- * @public
1035
1034
  * <p>Specify this parameter to limit how many canaries are returned each time you use
1036
1035
  * the <code>DescribeCanaries</code> operation. If you omit this parameter, the default of 100 is used.</p>
1036
+ * @public
1037
1037
  */
1038
1038
  MaxResults?: number;
1039
1039
  /**
1040
- * @public
1041
1040
  * <p>Use this parameter to return only canaries that match the names that you specify here. You can
1042
1041
  * specify as many as five canary names.</p>
1043
1042
  * <p>If you specify this parameter, the operation is successful only if you have authorization to view
@@ -1047,6 +1046,7 @@ export interface DescribeCanariesRequest {
1047
1046
  * IAM policy that restricts which canaries that you are allowed to view. For more information,
1048
1047
  * see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Restricted.html">
1049
1048
  * Limiting a user to viewing specific canaries</a>.</p>
1049
+ * @public
1050
1050
  */
1051
1051
  Names?: string[];
1052
1052
  }
@@ -1055,16 +1055,16 @@ export interface DescribeCanariesRequest {
1055
1055
  */
1056
1056
  export interface DescribeCanariesResponse {
1057
1057
  /**
1058
- * @public
1059
1058
  * <p>Returns an array. Each item in the array contains the full information about
1060
1059
  * one canary.</p>
1060
+ * @public
1061
1061
  */
1062
1062
  Canaries?: Canary[];
1063
1063
  /**
1064
- * @public
1065
1064
  * <p>A token that indicates that there is more data
1066
1065
  * available. You can use this token in a subsequent <code>DescribeCanaries</code> operation to retrieve the next
1067
1066
  * set of results.</p>
1067
+ * @public
1068
1068
  */
1069
1069
  NextToken?: string;
1070
1070
  }
@@ -1073,20 +1073,19 @@ export interface DescribeCanariesResponse {
1073
1073
  */
1074
1074
  export interface DescribeCanariesLastRunRequest {
1075
1075
  /**
1076
- * @public
1077
1076
  * <p>A token that indicates that there is more data
1078
1077
  * available. You can use this token in a subsequent <code>DescribeCanariesLastRun</code> operation to retrieve the next
1079
1078
  * set of results.</p>
1079
+ * @public
1080
1080
  */
1081
1081
  NextToken?: string;
1082
1082
  /**
1083
- * @public
1084
1083
  * <p>Specify this parameter to limit how many runs are returned each time you use
1085
1084
  * the <code>DescribeLastRun</code> operation. If you omit this parameter, the default of 100 is used.</p>
1085
+ * @public
1086
1086
  */
1087
1087
  MaxResults?: number;
1088
1088
  /**
1089
- * @public
1090
1089
  * <p>Use this parameter to return only canaries that match the names that you specify here. You can
1091
1090
  * specify as many as five canary names.</p>
1092
1091
  * <p>If you specify this parameter, the operation is successful only if you have authorization to view
@@ -1096,6 +1095,7 @@ export interface DescribeCanariesLastRunRequest {
1096
1095
  * IAM policy that restricts which canaries that you are allowed to view. For more information,
1097
1096
  * see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Restricted.html">
1098
1097
  * Limiting a user to viewing specific canaries</a>.</p>
1098
+ * @public
1099
1099
  */
1100
1100
  Names?: string[];
1101
1101
  }
@@ -1104,16 +1104,16 @@ export interface DescribeCanariesLastRunRequest {
1104
1104
  */
1105
1105
  export interface DescribeCanariesLastRunResponse {
1106
1106
  /**
1107
- * @public
1108
1107
  * <p>An array that contains the information from the most recent run of each
1109
1108
  * canary.</p>
1109
+ * @public
1110
1110
  */
1111
1111
  CanariesLastRun?: CanaryLastRun[];
1112
1112
  /**
1113
- * @public
1114
1113
  * <p>A token that indicates that there is more data
1115
1114
  * available. You can use this token in a subsequent <code>DescribeCanariesLastRun</code> operation to retrieve the next
1116
1115
  * set of results.</p>
1116
+ * @public
1117
1117
  */
1118
1118
  NextToken?: string;
1119
1119
  }
@@ -1122,46 +1122,46 @@ export interface DescribeCanariesLastRunResponse {
1122
1122
  */
1123
1123
  export interface DescribeRuntimeVersionsRequest {
1124
1124
  /**
1125
- * @public
1126
1125
  * <p>A token that indicates that there is more data
1127
1126
  * available. You can use this token in a subsequent <code>DescribeRuntimeVersions</code> operation to retrieve the next
1128
1127
  * set of results.</p>
1128
+ * @public
1129
1129
  */
1130
1130
  NextToken?: string;
1131
1131
  /**
1132
- * @public
1133
1132
  * <p>Specify this parameter to limit how many runs are returned each time you use
1134
1133
  * the <code>DescribeRuntimeVersions</code> operation. If you omit this parameter, the default of 100 is used.</p>
1134
+ * @public
1135
1135
  */
1136
1136
  MaxResults?: number;
1137
1137
  }
1138
1138
  /**
1139
- * @public
1140
1139
  * <p>This structure contains information about one canary runtime version. For more information about
1141
1140
  * runtime versions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html">
1142
1141
  * Canary Runtime Versions</a>.</p>
1142
+ * @public
1143
1143
  */
1144
1144
  export interface RuntimeVersion {
1145
1145
  /**
1146
- * @public
1147
1146
  * <p>The name of the runtime version. For a list of valid runtime versions,
1148
1147
  * see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html">
1149
1148
  * Canary Runtime Versions</a>.</p>
1149
+ * @public
1150
1150
  */
1151
1151
  VersionName?: string;
1152
1152
  /**
1153
- * @public
1154
1153
  * <p>A description of the runtime version, created by Amazon.</p>
1154
+ * @public
1155
1155
  */
1156
1156
  Description?: string;
1157
1157
  /**
1158
- * @public
1159
1158
  * <p>The date that the runtime version was released.</p>
1159
+ * @public
1160
1160
  */
1161
1161
  ReleaseDate?: Date;
1162
1162
  /**
1163
- * @public
1164
1163
  * <p>If this runtime version is deprecated, this value is the date of deprecation.</p>
1164
+ * @public
1165
1165
  */
1166
1166
  DeprecationDate?: Date;
1167
1167
  }
@@ -1170,16 +1170,16 @@ export interface RuntimeVersion {
1170
1170
  */
1171
1171
  export interface DescribeRuntimeVersionsResponse {
1172
1172
  /**
1173
- * @public
1174
1173
  * <p>An array of objects that display the details about each Synthetics canary runtime
1175
1174
  * version.</p>
1175
+ * @public
1176
1176
  */
1177
1177
  RuntimeVersions?: RuntimeVersion[];
1178
1178
  /**
1179
- * @public
1180
1179
  * <p>A token that indicates that there is more data
1181
1180
  * available. You can use this token in a subsequent <code>DescribeRuntimeVersions</code> operation to retrieve the next
1182
1181
  * set of results.</p>
1182
+ * @public
1183
1183
  */
1184
1184
  NextToken?: string;
1185
1185
  }
@@ -1188,14 +1188,14 @@ export interface DescribeRuntimeVersionsResponse {
1188
1188
  */
1189
1189
  export interface DisassociateResourceRequest {
1190
1190
  /**
1191
- * @public
1192
1191
  * <p>Specifies the group. You can specify the group name, the ARN, or the
1193
1192
  * group ID as the <code>GroupIdentifier</code>.</p>
1193
+ * @public
1194
1194
  */
1195
1195
  GroupIdentifier: string | undefined;
1196
1196
  /**
1197
- * @public
1198
1197
  * <p>The ARN of the canary that you want to remove from the specified group.</p>
1198
+ * @public
1199
1199
  */
1200
1200
  ResourceArn: string | undefined;
1201
1201
  }
@@ -1209,8 +1209,8 @@ export interface DisassociateResourceResponse {
1209
1209
  */
1210
1210
  export interface GetCanaryRequest {
1211
1211
  /**
1212
- * @public
1213
1212
  * <p>The name of the canary that you want details for.</p>
1213
+ * @public
1214
1214
  */
1215
1215
  Name: string | undefined;
1216
1216
  }
@@ -1219,8 +1219,8 @@ export interface GetCanaryRequest {
1219
1219
  */
1220
1220
  export interface GetCanaryResponse {
1221
1221
  /**
1222
- * @public
1223
1222
  * <p>A structure that contains the full information about the canary.</p>
1223
+ * @public
1224
1224
  */
1225
1225
  Canary?: Canary;
1226
1226
  }
@@ -1229,21 +1229,21 @@ export interface GetCanaryResponse {
1229
1229
  */
1230
1230
  export interface GetCanaryRunsRequest {
1231
1231
  /**
1232
- * @public
1233
1232
  * <p>The name of the canary that you want to see runs for.</p>
1233
+ * @public
1234
1234
  */
1235
1235
  Name: string | undefined;
1236
1236
  /**
1237
- * @public
1238
1237
  * <p>A token that indicates that there is more data
1239
1238
  * available. You can use this token in a subsequent <code>GetCanaryRuns</code> operation to retrieve the next
1240
1239
  * set of results.</p>
1240
+ * @public
1241
1241
  */
1242
1242
  NextToken?: string;
1243
1243
  /**
1244
- * @public
1245
1244
  * <p>Specify this parameter to limit how many runs are returned each time you use
1246
1245
  * the <code>GetCanaryRuns</code> operation. If you omit this parameter, the default of 100 is used.</p>
1246
+ * @public
1247
1247
  */
1248
1248
  MaxResults?: number;
1249
1249
  }
@@ -1252,17 +1252,17 @@ export interface GetCanaryRunsRequest {
1252
1252
  */
1253
1253
  export interface GetCanaryRunsResponse {
1254
1254
  /**
1255
- * @public
1256
1255
  * <p>An array of structures. Each structure contains the details of one of the
1257
1256
  * retrieved canary runs.</p>
1257
+ * @public
1258
1258
  */
1259
1259
  CanaryRuns?: CanaryRun[];
1260
1260
  /**
1261
- * @public
1262
1261
  * <p>A token that indicates that there is more data
1263
1262
  * available. You can use this token in a subsequent <code>GetCanaryRuns</code>
1264
1263
  * operation to retrieve the next
1265
1264
  * set of results.</p>
1265
+ * @public
1266
1266
  */
1267
1267
  NextToken?: string;
1268
1268
  }
@@ -1271,9 +1271,9 @@ export interface GetCanaryRunsResponse {
1271
1271
  */
1272
1272
  export interface GetGroupRequest {
1273
1273
  /**
1274
- * @public
1275
1274
  * <p>Specifies the group to return information for. You can specify the group name, the ARN, or the
1276
1275
  * group ID as the <code>GroupIdentifier</code>.</p>
1276
+ * @public
1277
1277
  */
1278
1278
  GroupIdentifier: string | undefined;
1279
1279
  }
@@ -1282,35 +1282,35 @@ export interface GetGroupRequest {
1282
1282
  */
1283
1283
  export interface GetGroupResponse {
1284
1284
  /**
1285
- * @public
1286
1285
  * <p>A structure that contains information about the group.</p>
1286
+ * @public
1287
1287
  */
1288
1288
  Group?: Group;
1289
1289
  }
1290
1290
  /**
1291
- * @public
1292
1291
  * <p>A structure containing some information about a group.</p>
1292
+ * @public
1293
1293
  */
1294
1294
  export interface GroupSummary {
1295
1295
  /**
1296
- * @public
1297
1296
  * <p>The unique ID of the group.</p>
1297
+ * @public
1298
1298
  */
1299
1299
  Id?: string;
1300
1300
  /**
1301
- * @public
1302
1301
  * <p>The name of the group.</p>
1302
+ * @public
1303
1303
  */
1304
1304
  Name?: string;
1305
1305
  /**
1306
- * @public
1307
1306
  * <p>The ARN of the group.</p>
1307
+ * @public
1308
1308
  */
1309
1309
  Arn?: string;
1310
1310
  }
1311
1311
  /**
1312
- * @public
1313
1312
  * <p>An internal failure occurred. Try the operation again.</p>
1313
+ * @public
1314
1314
  */
1315
1315
  export declare class InternalFailureException extends __BaseException {
1316
1316
  readonly name: "InternalFailureException";
@@ -1326,21 +1326,21 @@ export declare class InternalFailureException extends __BaseException {
1326
1326
  */
1327
1327
  export interface ListAssociatedGroupsRequest {
1328
1328
  /**
1329
- * @public
1330
1329
  * <p>A token that indicates that there is more data
1331
1330
  * available. You can use this token in a subsequent operation to retrieve the next
1332
1331
  * set of results.</p>
1332
+ * @public
1333
1333
  */
1334
1334
  NextToken?: string;
1335
1335
  /**
1336
- * @public
1337
1336
  * <p>Specify this parameter to limit how many groups are returned each time you use
1338
1337
  * the <code>ListAssociatedGroups</code> operation. If you omit this parameter, the default of 20 is used.</p>
1338
+ * @public
1339
1339
  */
1340
1340
  MaxResults?: number;
1341
1341
  /**
1342
- * @public
1343
1342
  * <p>The ARN of the canary that you want to view groups for.</p>
1343
+ * @public
1344
1344
  */
1345
1345
  ResourceArn: string | undefined;
1346
1346
  }
@@ -1349,15 +1349,15 @@ export interface ListAssociatedGroupsRequest {
1349
1349
  */
1350
1350
  export interface ListAssociatedGroupsResponse {
1351
1351
  /**
1352
- * @public
1353
1352
  * <p>An array of structures that contain information about the groups that this canary is associated with.</p>
1353
+ * @public
1354
1354
  */
1355
1355
  Groups?: GroupSummary[];
1356
1356
  /**
1357
- * @public
1358
1357
  * <p>A token that indicates that there is more data
1359
1358
  * available. You can use this token in a subsequent <code>ListAssociatedGroups</code> operation to retrieve the next
1360
1359
  * set of results.</p>
1360
+ * @public
1361
1361
  */
1362
1362
  NextToken?: string;
1363
1363
  }
@@ -1366,22 +1366,22 @@ export interface ListAssociatedGroupsResponse {
1366
1366
  */
1367
1367
  export interface ListGroupResourcesRequest {
1368
1368
  /**
1369
- * @public
1370
1369
  * <p>A token that indicates that there is more data
1371
1370
  * available. You can use this token in a subsequent operation to retrieve the next
1372
1371
  * set of results.</p>
1372
+ * @public
1373
1373
  */
1374
1374
  NextToken?: string;
1375
1375
  /**
1376
- * @public
1377
1376
  * <p>Specify this parameter to limit how many canary ARNs are returned each time you use
1378
1377
  * the <code>ListGroupResources</code> operation. If you omit this parameter, the default of 20 is used.</p>
1378
+ * @public
1379
1379
  */
1380
1380
  MaxResults?: number;
1381
1381
  /**
1382
- * @public
1383
1382
  * <p>Specifies the group to return information for. You can specify the group name, the ARN, or the
1384
1383
  * group ID as the <code>GroupIdentifier</code>.</p>
1384
+ * @public
1385
1385
  */
1386
1386
  GroupIdentifier: string | undefined;
1387
1387
  }
@@ -1390,15 +1390,15 @@ export interface ListGroupResourcesRequest {
1390
1390
  */
1391
1391
  export interface ListGroupResourcesResponse {
1392
1392
  /**
1393
- * @public
1394
1393
  * <p>An array of ARNs. These ARNs are for the canaries that are associated with the group.</p>
1394
+ * @public
1395
1395
  */
1396
1396
  Resources?: string[];
1397
1397
  /**
1398
- * @public
1399
1398
  * <p>A token that indicates that there is more data
1400
1399
  * available. You can use this token in a subsequent <code>ListGroupResources</code> operation to retrieve the next
1401
1400
  * set of results.</p>
1401
+ * @public
1402
1402
  */
1403
1403
  NextToken?: string;
1404
1404
  }
@@ -1407,16 +1407,16 @@ export interface ListGroupResourcesResponse {
1407
1407
  */
1408
1408
  export interface ListGroupsRequest {
1409
1409
  /**
1410
- * @public
1411
1410
  * <p>A token that indicates that there is more data
1412
1411
  * available. You can use this token in a subsequent operation to retrieve the next
1413
1412
  * set of results.</p>
1413
+ * @public
1414
1414
  */
1415
1415
  NextToken?: string;
1416
1416
  /**
1417
- * @public
1418
1417
  * <p>Specify this parameter to limit how many groups are returned each time you use
1419
1418
  * the <code>ListGroups</code> operation. If you omit this parameter, the default of 20 is used.</p>
1419
+ * @public
1420
1420
  */
1421
1421
  MaxResults?: number;
1422
1422
  }
@@ -1425,15 +1425,15 @@ export interface ListGroupsRequest {
1425
1425
  */
1426
1426
  export interface ListGroupsResponse {
1427
1427
  /**
1428
- * @public
1429
1428
  * <p>An array of structures that each contain information about one group.</p>
1429
+ * @public
1430
1430
  */
1431
1431
  Groups?: GroupSummary[];
1432
1432
  /**
1433
- * @public
1434
1433
  * <p>A token that indicates that there is more data
1435
1434
  * available. You can use this token in a subsequent <code>ListGroups</code> operation to retrieve the next
1436
1435
  * set of results.</p>
1436
+ * @public
1437
1437
  */
1438
1438
  NextToken?: string;
1439
1439
  }
@@ -1442,7 +1442,6 @@ export interface ListGroupsResponse {
1442
1442
  */
1443
1443
  export interface ListTagsForResourceRequest {
1444
1444
  /**
1445
- * @public
1446
1445
  * <p>The ARN of the canary or group that you want to view tags for.</p>
1447
1446
  * <p>The ARN format of a canary is
1448
1447
  * <code>arn:aws:synthetics:<i>Region</i>:<i>account-id</i>:canary:<i>canary-name</i>
@@ -1451,6 +1450,7 @@ export interface ListTagsForResourceRequest {
1451
1450
  * <code>arn:aws:synthetics:<i>Region</i>:<i>account-id</i>:group:<i>group-name</i>
1452
1451
  * </code>
1453
1452
  * </p>
1453
+ * @public
1454
1454
  */
1455
1455
  ResourceArn: string | undefined;
1456
1456
  }
@@ -1459,14 +1459,14 @@ export interface ListTagsForResourceRequest {
1459
1459
  */
1460
1460
  export interface ListTagsForResourceResponse {
1461
1461
  /**
1462
- * @public
1463
1462
  * <p>The list of tag keys and values associated with the resource that you specified.</p>
1463
+ * @public
1464
1464
  */
1465
1465
  Tags?: Record<string, string>;
1466
1466
  }
1467
1467
  /**
1468
- * @public
1469
1468
  * <p>The specified resource was not found.</p>
1469
+ * @public
1470
1470
  */
1471
1471
  export declare class NotFoundException extends __BaseException {
1472
1472
  readonly name: "NotFoundException";
@@ -1478,8 +1478,8 @@ export declare class NotFoundException extends __BaseException {
1478
1478
  constructor(opts: __ExceptionOptionType<NotFoundException, __BaseException>);
1479
1479
  }
1480
1480
  /**
1481
- * @public
1482
1481
  * <p>There were too many simultaneous requests. Try the operation again.</p>
1482
+ * @public
1483
1483
  */
1484
1484
  export declare class TooManyRequestsException extends __BaseException {
1485
1485
  readonly name: "TooManyRequestsException";
@@ -1495,9 +1495,9 @@ export declare class TooManyRequestsException extends __BaseException {
1495
1495
  */
1496
1496
  export interface StartCanaryRequest {
1497
1497
  /**
1498
- * @public
1499
1498
  * <p>The name of the canary that you want to run. To find
1500
1499
  * canary names, use <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DescribeCanaries.html">DescribeCanaries</a>.</p>
1500
+ * @public
1501
1501
  */
1502
1502
  Name: string | undefined;
1503
1503
  }
@@ -1511,9 +1511,9 @@ export interface StartCanaryResponse {
1511
1511
  */
1512
1512
  export interface StopCanaryRequest {
1513
1513
  /**
1514
- * @public
1515
1514
  * <p>The name of the canary that you want to stop. To find the names of your
1516
1515
  * canaries, use <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DescribeCanaries.html">ListCanaries</a>.</p>
1516
+ * @public
1517
1517
  */
1518
1518
  Name: string | undefined;
1519
1519
  }
@@ -1527,7 +1527,6 @@ export interface StopCanaryResponse {
1527
1527
  */
1528
1528
  export interface TagResourceRequest {
1529
1529
  /**
1530
- * @public
1531
1530
  * <p>The ARN of the canary or group that you're adding tags to.</p>
1532
1531
  * <p>The ARN format of a canary is
1533
1532
  * <code>arn:aws:synthetics:<i>Region</i>:<i>account-id</i>:canary:<i>canary-name</i>
@@ -1536,11 +1535,12 @@ export interface TagResourceRequest {
1536
1535
  * <code>arn:aws:synthetics:<i>Region</i>:<i>account-id</i>:group:<i>group-name</i>
1537
1536
  * </code>
1538
1537
  * </p>
1538
+ * @public
1539
1539
  */
1540
1540
  ResourceArn: string | undefined;
1541
1541
  /**
1542
- * @public
1543
1542
  * <p>The list of key-value pairs to associate with the resource.</p>
1543
+ * @public
1544
1544
  */
1545
1545
  Tags: Record<string, string> | undefined;
1546
1546
  }
@@ -1554,7 +1554,6 @@ export interface TagResourceResponse {
1554
1554
  */
1555
1555
  export interface UntagResourceRequest {
1556
1556
  /**
1557
- * @public
1558
1557
  * <p>The ARN of the canary or group that you're removing tags from.</p>
1559
1558
  * <p>The ARN format of a canary is
1560
1559
  * <code>arn:aws:synthetics:<i>Region</i>:<i>account-id</i>:canary:<i>canary-name</i>
@@ -1563,11 +1562,12 @@ export interface UntagResourceRequest {
1563
1562
  * <code>arn:aws:synthetics:<i>Region</i>:<i>account-id</i>:group:<i>group-name</i>
1564
1563
  * </code>
1565
1564
  * </p>
1565
+ * @public
1566
1566
  */
1567
1567
  ResourceArn: string | undefined;
1568
1568
  /**
1569
- * @public
1570
1569
  * <p>The list of tag keys to remove from the resource.</p>
1570
+ * @public
1571
1571
  */
1572
1572
  TagKeys: string[] | undefined;
1573
1573
  }
@@ -1577,7 +1577,6 @@ export interface UntagResourceRequest {
1577
1577
  export interface UntagResourceResponse {
1578
1578
  }
1579
1579
  /**
1580
- * @public
1581
1580
  * <p>An object that specifies what screenshots to use as a baseline for visual monitoring by this canary. It can
1582
1581
  * optionally also specify parts of the screenshots to ignore during the visual monitoring comparison.</p>
1583
1582
  * <p>Visual monitoring is supported only on canaries running the <b>syn-puppeteer-node-3.2</b>
@@ -1585,20 +1584,21 @@ export interface UntagResourceResponse {
1585
1584
  * Visual monitoring</a> and <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Blueprints_VisualTesting.html">
1586
1585
  * Visual monitoring blueprint</a>
1587
1586
  * </p>
1587
+ * @public
1588
1588
  */
1589
1589
  export interface VisualReferenceInput {
1590
1590
  /**
1591
- * @public
1592
1591
  * <p>An array of screenshots that will be used as the baseline for visual monitoring in future runs of this canary. If there is a screenshot that you don't want to be used for
1593
1592
  * visual monitoring, remove it from this array.</p>
1593
+ * @public
1594
1594
  */
1595
1595
  BaseScreenshots?: BaseScreenshot[];
1596
1596
  /**
1597
- * @public
1598
1597
  * <p>Specifies which canary run to use the screenshots from as the baseline for future visual monitoring with this canary. Valid values are
1599
1598
  * <code>nextrun</code> to use the screenshots from the next run after this update is made, <code>lastrun</code> to use the screenshots from the most recent run
1600
1599
  * before this update was made, or the value of <code>Id</code> in the <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_CanaryRun.html">
1601
1600
  * CanaryRun</a> from any past run of this canary.</p>
1601
+ * @public
1602
1602
  */
1603
1603
  BaseCanaryRunId: string | undefined;
1604
1604
  }
@@ -1607,22 +1607,21 @@ export interface VisualReferenceInput {
1607
1607
  */
1608
1608
  export interface UpdateCanaryRequest {
1609
1609
  /**
1610
- * @public
1611
1610
  * <p>The name of the canary that you want to update. To find the names of your
1612
1611
  * canaries, use <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DescribeCanaries.html">DescribeCanaries</a>.</p>
1613
1612
  * <p>You cannot change the name of a canary that has already been created.</p>
1613
+ * @public
1614
1614
  */
1615
1615
  Name: string | undefined;
1616
1616
  /**
1617
- * @public
1618
1617
  * <p>A structure that includes the entry point from which the canary should start
1619
1618
  * running your script. If the script is stored in
1620
1619
  * an S3 bucket, the bucket name, key, and version are also included.
1621
1620
  * </p>
1621
+ * @public
1622
1622
  */
1623
1623
  Code?: CanaryCodeInput;
1624
1624
  /**
1625
- * @public
1626
1625
  * <p>The ARN of the IAM role to be used to run the canary. This role must already exist,
1627
1626
  * and must include <code>lambda.amazonaws.com</code> as a principal in the trust
1628
1627
  * policy. The role must also have the following permissions:</p>
@@ -1663,52 +1662,52 @@ export interface UpdateCanaryRequest {
1663
1662
  * </p>
1664
1663
  * </li>
1665
1664
  * </ul>
1665
+ * @public
1666
1666
  */
1667
1667
  ExecutionRoleArn?: string;
1668
1668
  /**
1669
- * @public
1670
1669
  * <p>Specifies the runtime version to use for the canary.
1671
1670
  * For a list of valid runtime versions and for more information about
1672
1671
  * runtime versions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html">
1673
1672
  * Canary Runtime Versions</a>.</p>
1673
+ * @public
1674
1674
  */
1675
1675
  RuntimeVersion?: string;
1676
1676
  /**
1677
- * @public
1678
1677
  * <p>A structure that contains information about how often the canary is to run, and when
1679
1678
  * these runs are to stop.</p>
1679
+ * @public
1680
1680
  */
1681
1681
  Schedule?: CanaryScheduleInput;
1682
1682
  /**
1683
- * @public
1684
1683
  * <p>A structure that contains the timeout value that is used for each individual run of the
1685
1684
  * canary.</p>
1686
1685
  * <important>
1687
1686
  * <p>The environment variables keys and values are not encrypted. Do not store sensitive information
1688
1687
  * in this field.</p>
1689
1688
  * </important>
1689
+ * @public
1690
1690
  */
1691
1691
  RunConfig?: CanaryRunConfigInput;
1692
1692
  /**
1693
- * @public
1694
1693
  * <p>The number of days to retain data about successful runs of this canary.</p>
1694
+ * @public
1695
1695
  */
1696
1696
  SuccessRetentionPeriodInDays?: number;
1697
1697
  /**
1698
- * @public
1699
1698
  * <p>The number of days to retain data about failed runs of this canary.</p>
1699
+ * @public
1700
1700
  */
1701
1701
  FailureRetentionPeriodInDays?: number;
1702
1702
  /**
1703
- * @public
1704
1703
  * <p>If this canary is to test an endpoint in a VPC, this structure contains
1705
1704
  * information about the subnet and security groups of the VPC endpoint.
1706
1705
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html">
1707
1706
  * Running a Canary in a VPC</a>.</p>
1707
+ * @public
1708
1708
  */
1709
1709
  VpcConfig?: VpcConfigInput;
1710
1710
  /**
1711
- * @public
1712
1711
  * <p>Defines the screenshots to use as the baseline for comparisons during visual monitoring comparisons during future runs of this canary. If you omit this
1713
1712
  * parameter, no changes are made to any baseline screenshots that the canary might be using already.</p>
1714
1713
  * <p>Visual monitoring is supported only on canaries running the <b>syn-puppeteer-node-3.2</b>
@@ -1716,20 +1715,21 @@ export interface UpdateCanaryRequest {
1716
1715
  * Visual monitoring</a> and <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Blueprints_VisualTesting.html">
1717
1716
  * Visual monitoring blueprint</a>
1718
1717
  * </p>
1718
+ * @public
1719
1719
  */
1720
1720
  VisualReference?: VisualReferenceInput;
1721
1721
  /**
1722
- * @public
1723
1722
  * <p>The location in Amazon S3 where Synthetics stores artifacts from the test runs of this canary.
1724
1723
  * Artifacts include the log file, screenshots, and HAR files. The name of the
1725
1724
  * S3 bucket can't include a period (.).</p>
1725
+ * @public
1726
1726
  */
1727
1727
  ArtifactS3Location?: string;
1728
1728
  /**
1729
- * @public
1730
1729
  * <p>A structure that contains the configuration for canary artifacts,
1731
1730
  * including the encryption-at-rest settings for artifacts that
1732
1731
  * the canary uploads to Amazon S3.</p>
1732
+ * @public
1733
1733
  */
1734
1734
  ArtifactConfig?: ArtifactConfigInput;
1735
1735
  }