@aws-sdk/client-internetmonitor 3.556.0 → 3.563.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 (31) hide show
  1. package/README.md +16 -0
  2. package/dist-cjs/index.js +149 -0
  3. package/dist-es/InternetMonitor.js +4 -0
  4. package/dist-es/commands/GetInternetEventCommand.js +24 -0
  5. package/dist-es/commands/ListInternetEventsCommand.js +24 -0
  6. package/dist-es/commands/index.js +2 -0
  7. package/dist-es/models/models_0.js +8 -0
  8. package/dist-es/pagination/ListInternetEventsPaginator.js +4 -0
  9. package/dist-es/pagination/index.js +1 -0
  10. package/dist-es/protocols/Aws_restJson1.js +93 -0
  11. package/dist-types/InternetMonitor.d.ts +15 -0
  12. package/dist-types/InternetMonitorClient.d.ts +4 -2
  13. package/dist-types/commands/GetHealthEventCommand.d.ts +1 -1
  14. package/dist-types/commands/GetInternetEventCommand.d.ts +91 -0
  15. package/dist-types/commands/ListHealthEventsCommand.d.ts +1 -1
  16. package/dist-types/commands/ListInternetEventsCommand.d.ts +103 -0
  17. package/dist-types/commands/index.d.ts +2 -0
  18. package/dist-types/models/models_0.d.ts +245 -10
  19. package/dist-types/pagination/ListInternetEventsPaginator.d.ts +7 -0
  20. package/dist-types/pagination/index.d.ts +1 -0
  21. package/dist-types/protocols/Aws_restJson1.d.ts +18 -0
  22. package/dist-types/ts3.4/InternetMonitor.d.ts +35 -0
  23. package/dist-types/ts3.4/InternetMonitorClient.d.ts +12 -0
  24. package/dist-types/ts3.4/commands/GetInternetEventCommand.d.ts +38 -0
  25. package/dist-types/ts3.4/commands/ListInternetEventsCommand.d.ts +39 -0
  26. package/dist-types/ts3.4/commands/index.d.ts +2 -0
  27. package/dist-types/ts3.4/models/models_0.d.ts +55 -0
  28. package/dist-types/ts3.4/pagination/ListInternetEventsPaginator.d.ts +11 -0
  29. package/dist-types/ts3.4/pagination/index.d.ts +1 -0
  30. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +24 -0
  31. package/package.json +2 -2
@@ -0,0 +1,91 @@
1
+ import { Command as $Command } from "@smithy/smithy-client";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import { InternetMonitorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../InternetMonitorClient";
4
+ import { GetInternetEventInput, GetInternetEventOutput } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export { __MetadataBearer, $Command };
9
+ /**
10
+ * @public
11
+ *
12
+ * The input for {@link GetInternetEventCommand}.
13
+ */
14
+ export interface GetInternetEventCommandInput extends GetInternetEventInput {
15
+ }
16
+ /**
17
+ * @public
18
+ *
19
+ * The output of {@link GetInternetEventCommand}.
20
+ */
21
+ export interface GetInternetEventCommandOutput extends GetInternetEventOutput, __MetadataBearer {
22
+ }
23
+ declare const GetInternetEventCommand_base: {
24
+ new (input: GetInternetEventCommandInput): import("@smithy/smithy-client").CommandImpl<GetInternetEventCommandInput, GetInternetEventCommandOutput, InternetMonitorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
25
+ new (__0_0: GetInternetEventCommandInput): import("@smithy/smithy-client").CommandImpl<GetInternetEventCommandInput, GetInternetEventCommandOutput, InternetMonitorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
27
+ };
28
+ /**
29
+ * <p>Gets information that Amazon CloudWatch Internet Monitor has generated about an internet event. Internet Monitor displays information about
30
+ * recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services
31
+ * customers. </p>
32
+ * <p>The information returned here includes the impacted location,
33
+ * when the event started and (if the event is over) ended, the type of event (<code>PERFORMANCE</code> or <code>AVAILABILITY</code>),
34
+ * and the status (<code>ACTIVE</code> or <code>RESOLVED</code>).</p>
35
+ * @example
36
+ * Use a bare-bones client and the command you need to make an API call.
37
+ * ```javascript
38
+ * import { InternetMonitorClient, GetInternetEventCommand } from "@aws-sdk/client-internetmonitor"; // ES Modules import
39
+ * // const { InternetMonitorClient, GetInternetEventCommand } = require("@aws-sdk/client-internetmonitor"); // CommonJS import
40
+ * const client = new InternetMonitorClient(config);
41
+ * const input = { // GetInternetEventInput
42
+ * EventId: "STRING_VALUE", // required
43
+ * };
44
+ * const command = new GetInternetEventCommand(input);
45
+ * const response = await client.send(command);
46
+ * // { // GetInternetEventOutput
47
+ * // EventId: "STRING_VALUE", // required
48
+ * // EventArn: "STRING_VALUE", // required
49
+ * // StartedAt: new Date("TIMESTAMP"), // required
50
+ * // EndedAt: new Date("TIMESTAMP"),
51
+ * // ClientLocation: { // ClientLocation
52
+ * // ASName: "STRING_VALUE", // required
53
+ * // ASNumber: Number("long"), // required
54
+ * // Country: "STRING_VALUE", // required
55
+ * // Subdivision: "STRING_VALUE",
56
+ * // Metro: "STRING_VALUE",
57
+ * // City: "STRING_VALUE", // required
58
+ * // Latitude: Number("double"), // required
59
+ * // Longitude: Number("double"), // required
60
+ * // },
61
+ * // EventType: "STRING_VALUE", // required
62
+ * // EventStatus: "STRING_VALUE", // required
63
+ * // };
64
+ *
65
+ * ```
66
+ *
67
+ * @param GetInternetEventCommandInput - {@link GetInternetEventCommandInput}
68
+ * @returns {@link GetInternetEventCommandOutput}
69
+ * @see {@link GetInternetEventCommandInput} for command's `input` shape.
70
+ * @see {@link GetInternetEventCommandOutput} for command's `response` shape.
71
+ * @see {@link InternetMonitorClientResolvedConfig | config} for InternetMonitorClient's `config` shape.
72
+ *
73
+ * @throws {@link AccessDeniedException} (client fault)
74
+ * <p>You don't have sufficient permission to perform this action.</p>
75
+ *
76
+ * @throws {@link InternalServerException} (server fault)
77
+ * <p>An internal error occurred.</p>
78
+ *
79
+ * @throws {@link ThrottlingException} (client fault)
80
+ * <p>The request was denied due to request throttling.</p>
81
+ *
82
+ * @throws {@link ValidationException} (client fault)
83
+ * <p>Invalid request.</p>
84
+ *
85
+ * @throws {@link InternetMonitorServiceException}
86
+ * <p>Base exception class for all service exceptions from InternetMonitor service.</p>
87
+ *
88
+ * @public
89
+ */
90
+ export declare class GetInternetEventCommand extends GetInternetEventCommand_base {
91
+ }
@@ -26,7 +26,7 @@ declare const ListHealthEventsCommand_base: {
26
26
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
27
27
  };
28
28
  /**
29
- * <p>Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns information for health events including the event start and end time and
29
+ * <p>Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns information for health events including the event start and end times, and
30
30
  * the status.</p>
31
31
  * <note>
32
32
  * <p>Health events that have start times during the time frame that is requested are not included in the list of health events.</p>
@@ -0,0 +1,103 @@
1
+ import { Command as $Command } from "@smithy/smithy-client";
2
+ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import { InternetMonitorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../InternetMonitorClient";
4
+ import { ListInternetEventsInput, ListInternetEventsOutput } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export { __MetadataBearer, $Command };
9
+ /**
10
+ * @public
11
+ *
12
+ * The input for {@link ListInternetEventsCommand}.
13
+ */
14
+ export interface ListInternetEventsCommandInput extends ListInternetEventsInput {
15
+ }
16
+ /**
17
+ * @public
18
+ *
19
+ * The output of {@link ListInternetEventsCommand}.
20
+ */
21
+ export interface ListInternetEventsCommandOutput extends ListInternetEventsOutput, __MetadataBearer {
22
+ }
23
+ declare const ListInternetEventsCommand_base: {
24
+ new (input: ListInternetEventsCommandInput): import("@smithy/smithy-client").CommandImpl<ListInternetEventsCommandInput, ListInternetEventsCommandOutput, InternetMonitorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
25
+ new (...[input]: [] | [ListInternetEventsCommandInput]): import("@smithy/smithy-client").CommandImpl<ListInternetEventsCommandInput, ListInternetEventsCommandOutput, InternetMonitorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
27
+ };
28
+ /**
29
+ * <p>Lists internet events that cause performance or availability issues for client locations. Amazon CloudWatch Internet Monitor displays information about
30
+ * recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services
31
+ * customers. </p>
32
+ * <p>You can constrain the list of internet events returned by providing a start time and end time to define a total
33
+ * time frame for events you want to list. Both start time and end time specify the time when an event started. End time
34
+ * is optional. If you don't include it, the default end time is the current time.</p>
35
+ * <p>You can also limit the events returned to a specific status
36
+ * (<code>ACTIVE</code> or <code>RESOLVED</code>) or type (<code>PERFORMANCE</code> or <code>AVAILABILITY</code>).</p>
37
+ * @example
38
+ * Use a bare-bones client and the command you need to make an API call.
39
+ * ```javascript
40
+ * import { InternetMonitorClient, ListInternetEventsCommand } from "@aws-sdk/client-internetmonitor"; // ES Modules import
41
+ * // const { InternetMonitorClient, ListInternetEventsCommand } = require("@aws-sdk/client-internetmonitor"); // CommonJS import
42
+ * const client = new InternetMonitorClient(config);
43
+ * const input = { // ListInternetEventsInput
44
+ * NextToken: "STRING_VALUE",
45
+ * MaxResults: Number("int"),
46
+ * StartTime: new Date("TIMESTAMP"),
47
+ * EndTime: new Date("TIMESTAMP"),
48
+ * EventStatus: "STRING_VALUE",
49
+ * EventType: "STRING_VALUE",
50
+ * };
51
+ * const command = new ListInternetEventsCommand(input);
52
+ * const response = await client.send(command);
53
+ * // { // ListInternetEventsOutput
54
+ * // InternetEvents: [ // InternetEventsList // required
55
+ * // { // InternetEventSummary
56
+ * // EventId: "STRING_VALUE", // required
57
+ * // EventArn: "STRING_VALUE", // required
58
+ * // StartedAt: new Date("TIMESTAMP"), // required
59
+ * // EndedAt: new Date("TIMESTAMP"),
60
+ * // ClientLocation: { // ClientLocation
61
+ * // ASName: "STRING_VALUE", // required
62
+ * // ASNumber: Number("long"), // required
63
+ * // Country: "STRING_VALUE", // required
64
+ * // Subdivision: "STRING_VALUE",
65
+ * // Metro: "STRING_VALUE",
66
+ * // City: "STRING_VALUE", // required
67
+ * // Latitude: Number("double"), // required
68
+ * // Longitude: Number("double"), // required
69
+ * // },
70
+ * // EventType: "STRING_VALUE", // required
71
+ * // EventStatus: "STRING_VALUE", // required
72
+ * // },
73
+ * // ],
74
+ * // NextToken: "STRING_VALUE",
75
+ * // };
76
+ *
77
+ * ```
78
+ *
79
+ * @param ListInternetEventsCommandInput - {@link ListInternetEventsCommandInput}
80
+ * @returns {@link ListInternetEventsCommandOutput}
81
+ * @see {@link ListInternetEventsCommandInput} for command's `input` shape.
82
+ * @see {@link ListInternetEventsCommandOutput} for command's `response` shape.
83
+ * @see {@link InternetMonitorClientResolvedConfig | config} for InternetMonitorClient's `config` shape.
84
+ *
85
+ * @throws {@link AccessDeniedException} (client fault)
86
+ * <p>You don't have sufficient permission to perform this action.</p>
87
+ *
88
+ * @throws {@link InternalServerException} (server fault)
89
+ * <p>An internal error occurred.</p>
90
+ *
91
+ * @throws {@link ThrottlingException} (client fault)
92
+ * <p>The request was denied due to request throttling.</p>
93
+ *
94
+ * @throws {@link ValidationException} (client fault)
95
+ * <p>Invalid request.</p>
96
+ *
97
+ * @throws {@link InternetMonitorServiceException}
98
+ * <p>Base exception class for all service exceptions from InternetMonitor service.</p>
99
+ *
100
+ * @public
101
+ */
102
+ export declare class ListInternetEventsCommand extends ListInternetEventsCommand_base {
103
+ }
@@ -1,10 +1,12 @@
1
1
  export * from "./CreateMonitorCommand";
2
2
  export * from "./DeleteMonitorCommand";
3
3
  export * from "./GetHealthEventCommand";
4
+ export * from "./GetInternetEventCommand";
4
5
  export * from "./GetMonitorCommand";
5
6
  export * from "./GetQueryResultsCommand";
6
7
  export * from "./GetQueryStatusCommand";
7
8
  export * from "./ListHealthEventsCommand";
9
+ export * from "./ListInternetEventsCommand";
8
10
  export * from "./ListMonitorsCommand";
9
11
  export * from "./ListTagsForResourceCommand";
10
12
  export * from "./StartQueryCommand";
@@ -64,6 +64,56 @@ export declare class BadRequestException extends __BaseException {
64
64
  */
65
65
  constructor(opts: __ExceptionOptionType<BadRequestException, __BaseException>);
66
66
  }
67
+ /**
68
+ * <p>The impacted location, such as a city, that Amazon Web Services clients access application resources from.</p>
69
+ * @public
70
+ */
71
+ export interface ClientLocation {
72
+ /**
73
+ * <p>The name of the internet service provider (ISP) or network (ASN).</p>
74
+ * @public
75
+ */
76
+ ASName: string | undefined;
77
+ /**
78
+ * <p>The Autonomous System Number (ASN) of the network at an impacted location.</p>
79
+ * @public
80
+ */
81
+ ASNumber: number | undefined;
82
+ /**
83
+ * <p>The name of the country where the internet event is located.</p>
84
+ * @public
85
+ */
86
+ Country: string | undefined;
87
+ /**
88
+ * <p>The subdivision location where the health event is located. The subdivision usually maps to states in most countries
89
+ * (including the United States). For United Kingdom, it maps to a country (England, Scotland, Wales) or province (Northern Ireland).</p>
90
+ * @public
91
+ */
92
+ Subdivision?: string;
93
+ /**
94
+ * <p>The metro area where the health event is located.</p>
95
+ * <p>Metro indicates a metropolitan region in the United States, such as the region around New York City. In non-US countries,
96
+ * this is a second-level subdivision. For example, in the United Kingdom, it could be a county, a London borough, a unitary
97
+ * authority, council area, and so on.</p>
98
+ * @public
99
+ */
100
+ Metro?: string;
101
+ /**
102
+ * <p>The name of the city where the internet event is located.</p>
103
+ * @public
104
+ */
105
+ City: string | undefined;
106
+ /**
107
+ * <p>The latitude where the internet event is located.</p>
108
+ * @public
109
+ */
110
+ Latitude: number | undefined;
111
+ /**
112
+ * <p>The longitude where the internet event is located.</p>
113
+ * @public
114
+ */
115
+ Longitude: number | undefined;
116
+ }
67
117
  /**
68
118
  * <p>The requested resource is in use.</p>
69
119
  * @public
@@ -428,18 +478,21 @@ export interface GetHealthEventInput {
428
478
  */
429
479
  EventId: string | undefined;
430
480
  /**
431
- * <p>TBD </p>
481
+ * <p>The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account
482
+ * sharing by using Amazon CloudWatch Observability Access Manager. For more information, see
483
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cwim-cross-account.html">Internet Monitor cross-account
484
+ * observability</a> in the Amazon CloudWatch Internet Monitor User Guide.</p>
432
485
  * @public
433
486
  */
434
487
  LinkedAccountId?: string;
435
488
  }
436
489
  /**
437
- * <p>An internet service provider (ISP) or network in Amazon CloudWatch Internet Monitor.</p>
490
+ * <p>An internet service provider (ISP) or network (ASN) in Amazon CloudWatch Internet Monitor.</p>
438
491
  * @public
439
492
  */
440
493
  export interface Network {
441
494
  /**
442
- * <p>The internet provider name or network name.</p>
495
+ * <p>The name of the internet service provider (ISP) or network (ASN).</p>
443
496
  * @public
444
497
  */
445
498
  ASName: string | undefined;
@@ -477,7 +530,7 @@ export interface NetworkImpairment {
477
530
  */
478
531
  AsPath: Network[] | undefined;
479
532
  /**
480
- * <p>Type of network impairment.</p>
533
+ * <p>The type of network impairment.</p>
481
534
  * @public
482
535
  */
483
536
  NetworkEventType: TriangulationEventType | undefined;
@@ -599,7 +652,7 @@ export type HealthEventStatus = (typeof HealthEventStatus)[keyof typeof HealthEv
599
652
  */
600
653
  export interface ImpactedLocation {
601
654
  /**
602
- * <p>The name of the network at an impacted location.</p>
655
+ * <p>The name of the internet service provider (ISP) or network (ASN).</p>
603
656
  * @public
604
657
  */
605
658
  ASName: string | undefined;
@@ -759,6 +812,80 @@ export interface GetHealthEventOutput {
759
812
  */
760
813
  HealthScoreThreshold?: number;
761
814
  }
815
+ /**
816
+ * @public
817
+ */
818
+ export interface GetInternetEventInput {
819
+ /**
820
+ * <p>The <code>EventId</code> of the internet event to return information for. </p>
821
+ * @public
822
+ */
823
+ EventId: string | undefined;
824
+ }
825
+ /**
826
+ * @public
827
+ * @enum
828
+ */
829
+ export declare const InternetEventStatus: {
830
+ readonly ACTIVE: "ACTIVE";
831
+ readonly RESOLVED: "RESOLVED";
832
+ };
833
+ /**
834
+ * @public
835
+ */
836
+ export type InternetEventStatus = (typeof InternetEventStatus)[keyof typeof InternetEventStatus];
837
+ /**
838
+ * @public
839
+ * @enum
840
+ */
841
+ export declare const InternetEventType: {
842
+ readonly AVAILABILITY: "AVAILABILITY";
843
+ readonly PERFORMANCE: "PERFORMANCE";
844
+ };
845
+ /**
846
+ * @public
847
+ */
848
+ export type InternetEventType = (typeof InternetEventType)[keyof typeof InternetEventType];
849
+ /**
850
+ * @public
851
+ */
852
+ export interface GetInternetEventOutput {
853
+ /**
854
+ * <p>The internally-generated identifier of an internet event.</p>
855
+ * @public
856
+ */
857
+ EventId: string | undefined;
858
+ /**
859
+ * <p>The Amazon Resource Name (ARN) of the internet event.</p>
860
+ * @public
861
+ */
862
+ EventArn: string | undefined;
863
+ /**
864
+ * <p>The time when the internet event started.</p>
865
+ * @public
866
+ */
867
+ StartedAt: Date | undefined;
868
+ /**
869
+ * <p>The time when the internet event ended. If the event hasn't ended yet, this value is empty.</p>
870
+ * @public
871
+ */
872
+ EndedAt?: Date;
873
+ /**
874
+ * <p>The impacted location, such as a city, where clients access Amazon Web Services application resources.</p>
875
+ * @public
876
+ */
877
+ ClientLocation: ClientLocation | undefined;
878
+ /**
879
+ * <p>The type of network impairment.</p>
880
+ * @public
881
+ */
882
+ EventType: InternetEventType | undefined;
883
+ /**
884
+ * <p>The status of the internet event.</p>
885
+ * @public
886
+ */
887
+ EventStatus: InternetEventStatus | undefined;
888
+ }
762
889
  /**
763
890
  * @public
764
891
  */
@@ -769,7 +896,10 @@ export interface GetMonitorInput {
769
896
  */
770
897
  MonitorName: string | undefined;
771
898
  /**
772
- * <p>TBD </p>
899
+ * <p>The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account
900
+ * sharing by using Amazon CloudWatch Observability Access Manager. For more information, see
901
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cwim-cross-account.html">Internet Monitor cross-account
902
+ * observability</a> in the Amazon CloudWatch Internet Monitor User Guide.</p>
773
903
  * @public
774
904
  */
775
905
  LinkedAccountId?: string;
@@ -1019,7 +1149,7 @@ export interface HealthEvent {
1019
1149
  */
1020
1150
  ImpactedLocations: ImpactedLocation[] | undefined;
1021
1151
  /**
1022
- * <p>Health event list member.</p>
1152
+ * <p>The status of a health event.</p>
1023
1153
  * @public
1024
1154
  */
1025
1155
  Status: HealthEventStatus | undefined;
@@ -1076,7 +1206,10 @@ export interface ListHealthEventsInput {
1076
1206
  */
1077
1207
  EventStatus?: HealthEventStatus;
1078
1208
  /**
1079
- * <p>TBD </p>
1209
+ * <p>The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account
1210
+ * sharing by using Amazon CloudWatch Observability Access Manager. For more information, see
1211
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cwim-cross-account.html">Internet Monitor cross-account
1212
+ * observability</a> in the Amazon CloudWatch Internet Monitor User Guide.</p>
1080
1213
  * @public
1081
1214
  */
1082
1215
  LinkedAccountId?: string;
@@ -1109,6 +1242,101 @@ export declare class InternalServerErrorException extends __BaseException {
1109
1242
  */
1110
1243
  constructor(opts: __ExceptionOptionType<InternalServerErrorException, __BaseException>);
1111
1244
  }
1245
+ /**
1246
+ * @public
1247
+ */
1248
+ export interface ListInternetEventsInput {
1249
+ /**
1250
+ * <p>The token for the next set of results. You receive this token from a previous call.</p>
1251
+ * @public
1252
+ */
1253
+ NextToken?: string;
1254
+ /**
1255
+ * <p>The number of query results that you want to return with this call.</p>
1256
+ * @public
1257
+ */
1258
+ MaxResults?: number;
1259
+ /**
1260
+ * <p>The start time of the time window that you want to get a list of internet events for.</p>
1261
+ * @public
1262
+ */
1263
+ StartTime?: Date;
1264
+ /**
1265
+ * <p>The end time of the time window that you want to get a list of internet events for.</p>
1266
+ * @public
1267
+ */
1268
+ EndTime?: Date;
1269
+ /**
1270
+ * <p>The status of an internet event.</p>
1271
+ * @public
1272
+ */
1273
+ EventStatus?: string;
1274
+ /**
1275
+ * <p>The type of network impairment.</p>
1276
+ * @public
1277
+ */
1278
+ EventType?: string;
1279
+ }
1280
+ /**
1281
+ * <p>A summary of information about an internet event in Amazon CloudWatch Internet Monitor. Internet events are issues that cause performance degradation
1282
+ * or availability problems for impacted Amazon Web Services client locations. Internet Monitor displays information about
1283
+ * recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services
1284
+ * customers. </p>
1285
+ * @public
1286
+ */
1287
+ export interface InternetEventSummary {
1288
+ /**
1289
+ * <p>The internally-generated identifier of an internet event.</p>
1290
+ * @public
1291
+ */
1292
+ EventId: string | undefined;
1293
+ /**
1294
+ * <p>The Amazon Resource Name (ARN) of the internet event.</p>
1295
+ * @public
1296
+ */
1297
+ EventArn: string | undefined;
1298
+ /**
1299
+ * <p>The time when an internet event started.</p>
1300
+ * @public
1301
+ */
1302
+ StartedAt: Date | undefined;
1303
+ /**
1304
+ * <p>The time when an internet event ended. If the event hasn't ended yet, this value
1305
+ * is empty.</p>
1306
+ * @public
1307
+ */
1308
+ EndedAt?: Date;
1309
+ /**
1310
+ * <p>The impacted location, such as a city, that Amazon Web Services clients access application resources from.</p>
1311
+ * @public
1312
+ */
1313
+ ClientLocation: ClientLocation | undefined;
1314
+ /**
1315
+ * <p>The type of network impairment.</p>
1316
+ * @public
1317
+ */
1318
+ EventType: InternetEventType | undefined;
1319
+ /**
1320
+ * <p>The status of an internet event.</p>
1321
+ * @public
1322
+ */
1323
+ EventStatus: InternetEventStatus | undefined;
1324
+ }
1325
+ /**
1326
+ * @public
1327
+ */
1328
+ export interface ListInternetEventsOutput {
1329
+ /**
1330
+ * <p>A set of internet events returned for the list operation.</p>
1331
+ * @public
1332
+ */
1333
+ InternetEvents: InternetEventSummary[] | undefined;
1334
+ /**
1335
+ * <p>The token for the next set of results. You receive this token from a previous call.</p>
1336
+ * @public
1337
+ */
1338
+ NextToken?: string;
1339
+ }
1112
1340
  /**
1113
1341
  * @public
1114
1342
  */
@@ -1178,7 +1406,11 @@ export interface ListMonitorsInput {
1178
1406
  */
1179
1407
  MonitorStatus?: string;
1180
1408
  /**
1181
- * <p>TBD </p>
1409
+ * <p>A boolean option that you can set to <code>TRUE</code> to include monitors for linked accounts in a list of
1410
+ * monitors, when you've set up cross-account sharing in Amazon CloudWatch Internet Monitor. You configure cross-account
1411
+ * sharing by using Amazon CloudWatch Observability Access Manager. For more information, see
1412
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cwim-cross-account.html">Internet Monitor cross-account
1413
+ * observability</a> in the Amazon CloudWatch Internet Monitor User Guide.</p>
1182
1414
  * @public
1183
1415
  */
1184
1416
  IncludeLinkedAccounts?: boolean;
@@ -1292,7 +1524,10 @@ export interface StartQueryInput {
1292
1524
  */
1293
1525
  FilterParameters?: FilterParameter[];
1294
1526
  /**
1295
- * <p>TBD </p>
1527
+ * <p>The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account
1528
+ * sharing by using Amazon CloudWatch Observability Access Manager. For more information, see
1529
+ * <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cwim-cross-account.html">Internet Monitor cross-account
1530
+ * observability</a> in the Amazon CloudWatch Internet Monitor User Guide.</p>
1296
1531
  * @public
1297
1532
  */
1298
1533
  LinkedAccountId?: string;
@@ -0,0 +1,7 @@
1
+ import { Paginator } from "@smithy/types";
2
+ import { ListInternetEventsCommandInput, ListInternetEventsCommandOutput } from "../commands/ListInternetEventsCommand";
3
+ import { InternetMonitorPaginationConfiguration } from "./Interfaces";
4
+ /**
5
+ * @public
6
+ */
7
+ export declare const paginateListInternetEvents: (config: InternetMonitorPaginationConfiguration, input: ListInternetEventsCommandInput, ...rest: any[]) => Paginator<ListInternetEventsCommandOutput>;
@@ -1,4 +1,5 @@
1
1
  export * from "./GetQueryResultsPaginator";
2
2
  export * from "./Interfaces";
3
3
  export * from "./ListHealthEventsPaginator";
4
+ export * from "./ListInternetEventsPaginator";
4
5
  export * from "./ListMonitorsPaginator";
@@ -3,10 +3,12 @@ import { SerdeContext as __SerdeContext } from "@smithy/types";
3
3
  import { CreateMonitorCommandInput, CreateMonitorCommandOutput } from "../commands/CreateMonitorCommand";
4
4
  import { DeleteMonitorCommandInput, DeleteMonitorCommandOutput } from "../commands/DeleteMonitorCommand";
5
5
  import { GetHealthEventCommandInput, GetHealthEventCommandOutput } from "../commands/GetHealthEventCommand";
6
+ import { GetInternetEventCommandInput, GetInternetEventCommandOutput } from "../commands/GetInternetEventCommand";
6
7
  import { GetMonitorCommandInput, GetMonitorCommandOutput } from "../commands/GetMonitorCommand";
7
8
  import { GetQueryResultsCommandInput, GetQueryResultsCommandOutput } from "../commands/GetQueryResultsCommand";
8
9
  import { GetQueryStatusCommandInput, GetQueryStatusCommandOutput } from "../commands/GetQueryStatusCommand";
9
10
  import { ListHealthEventsCommandInput, ListHealthEventsCommandOutput } from "../commands/ListHealthEventsCommand";
11
+ import { ListInternetEventsCommandInput, ListInternetEventsCommandOutput } from "../commands/ListInternetEventsCommand";
10
12
  import { ListMonitorsCommandInput, ListMonitorsCommandOutput } from "../commands/ListMonitorsCommand";
11
13
  import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "../commands/ListTagsForResourceCommand";
12
14
  import { StartQueryCommandInput, StartQueryCommandOutput } from "../commands/StartQueryCommand";
@@ -26,6 +28,10 @@ export declare const se_DeleteMonitorCommand: (input: DeleteMonitorCommandInput,
26
28
  * serializeAws_restJson1GetHealthEventCommand
27
29
  */
28
30
  export declare const se_GetHealthEventCommand: (input: GetHealthEventCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
31
+ /**
32
+ * serializeAws_restJson1GetInternetEventCommand
33
+ */
34
+ export declare const se_GetInternetEventCommand: (input: GetInternetEventCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
29
35
  /**
30
36
  * serializeAws_restJson1GetMonitorCommand
31
37
  */
@@ -42,6 +48,10 @@ export declare const se_GetQueryStatusCommand: (input: GetQueryStatusCommandInpu
42
48
  * serializeAws_restJson1ListHealthEventsCommand
43
49
  */
44
50
  export declare const se_ListHealthEventsCommand: (input: ListHealthEventsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
51
+ /**
52
+ * serializeAws_restJson1ListInternetEventsCommand
53
+ */
54
+ export declare const se_ListInternetEventsCommand: (input: ListInternetEventsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
45
55
  /**
46
56
  * serializeAws_restJson1ListMonitorsCommand
47
57
  */
@@ -82,6 +92,10 @@ export declare const de_DeleteMonitorCommand: (output: __HttpResponse, context:
82
92
  * deserializeAws_restJson1GetHealthEventCommand
83
93
  */
84
94
  export declare const de_GetHealthEventCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<GetHealthEventCommandOutput>;
95
+ /**
96
+ * deserializeAws_restJson1GetInternetEventCommand
97
+ */
98
+ export declare const de_GetInternetEventCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<GetInternetEventCommandOutput>;
85
99
  /**
86
100
  * deserializeAws_restJson1GetMonitorCommand
87
101
  */
@@ -98,6 +112,10 @@ export declare const de_GetQueryStatusCommand: (output: __HttpResponse, context:
98
112
  * deserializeAws_restJson1ListHealthEventsCommand
99
113
  */
100
114
  export declare const de_ListHealthEventsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListHealthEventsCommandOutput>;
115
+ /**
116
+ * deserializeAws_restJson1ListInternetEventsCommand
117
+ */
118
+ export declare const de_ListInternetEventsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListInternetEventsCommandOutput>;
101
119
  /**
102
120
  * deserializeAws_restJson1ListMonitorsCommand
103
121
  */