@aws-sdk/client-synthetics 3.529.1 → 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.
- package/dist-types/Synthetics.d.ts +5 -1
- package/dist-types/SyntheticsClient.d.ts +1 -1
- package/dist-types/commands/AssociateResourceCommand.d.ts +2 -1
- package/dist-types/commands/CreateCanaryCommand.d.ts +3 -2
- package/dist-types/commands/CreateGroupCommand.d.ts +2 -1
- package/dist-types/commands/DeleteCanaryCommand.d.ts +2 -1
- package/dist-types/commands/DeleteGroupCommand.d.ts +2 -1
- package/dist-types/commands/DescribeCanariesCommand.d.ts +2 -1
- package/dist-types/commands/DescribeCanariesLastRunCommand.d.ts +2 -1
- package/dist-types/commands/DescribeRuntimeVersionsCommand.d.ts +2 -1
- package/dist-types/commands/DisassociateResourceCommand.d.ts +2 -1
- package/dist-types/commands/GetCanaryCommand.d.ts +2 -1
- package/dist-types/commands/GetCanaryRunsCommand.d.ts +2 -1
- package/dist-types/commands/GetGroupCommand.d.ts +2 -1
- package/dist-types/commands/ListAssociatedGroupsCommand.d.ts +2 -1
- package/dist-types/commands/ListGroupResourcesCommand.d.ts +2 -1
- package/dist-types/commands/ListGroupsCommand.d.ts +2 -1
- package/dist-types/commands/ListTagsForResourceCommand.d.ts +2 -1
- package/dist-types/commands/StartCanaryCommand.d.ts +2 -1
- package/dist-types/commands/StopCanaryCommand.d.ts +2 -1
- package/dist-types/commands/TagResourceCommand.d.ts +2 -1
- package/dist-types/commands/UntagResourceCommand.d.ts +2 -1
- package/dist-types/commands/UpdateCanaryCommand.d.ts +3 -2
- package/dist-types/models/models_0.d.ts +196 -196
- package/dist-types/runtimeConfig.browser.d.ts +2 -2
- package/dist-types/runtimeConfig.d.ts +2 -2
- package/dist-types/runtimeConfig.native.d.ts +2 -2
- package/dist-types/runtimeConfig.shared.d.ts +2 -2
- package/dist-types/ts3.4/Synthetics.d.ts +4 -0
- package/dist-types/ts3.4/commands/AssociateResourceCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/CreateCanaryCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/CreateGroupCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/DeleteCanaryCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/DeleteGroupCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/DescribeCanariesCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/DescribeCanariesLastRunCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/DescribeRuntimeVersionsCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/DisassociateResourceCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/GetCanaryCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/GetCanaryRunsCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/GetGroupCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/ListAssociatedGroupsCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/ListGroupResourcesCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/ListGroupsCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/ListTagsForResourceCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/StartCanaryCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/StopCanaryCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +9 -0
- package/dist-types/ts3.4/commands/UpdateCanaryCommand.d.ts +9 -0
- package/dist-types/ts3.4/runtimeConfig.browser.d.ts +2 -2
- package/dist-types/ts3.4/runtimeConfig.d.ts +2 -2
- package/dist-types/ts3.4/runtimeConfig.native.d.ts +2 -2
- package/dist-types/ts3.4/runtimeConfig.shared.d.ts +2 -2
- 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
|
}
|