feat(client-internetmonitor): This update introduces the GetInternetEvent and ListInternetEvents APIs, which provide access to internet events displayed on the Amazon CloudWatch Internet Weather Map.

Author: awstools

clients/client-internetmonitor/README.md

@@ -241,6 +241,14 @@ GetHealthEvent
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/internetmonitor/command/GetHealthEventCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-internetmonitor/Interface/GetHealthEventCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-internetmonitor/Interface/GetHealthEventCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetInternetEvent
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/internetmonitor/command/GetInternetEventCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-internetmonitor/Interface/GetInternetEventCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-internetmonitor/Interface/GetInternetEventCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -273,6 +281,14 @@ ListHealthEvents
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/internetmonitor/command/ListHealthEventsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-internetmonitor/Interface/ListHealthEventsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-internetmonitor/Interface/ListHealthEventsCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListInternetEvents
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/internetmonitor/command/ListInternetEventsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-internetmonitor/Interface/ListInternetEventsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-internetmonitor/Interface/ListInternetEventsCommandOutput/)
+
 </details>
 <details>
 <summary>

clients/client-internetmonitor/src/InternetMonitor.ts

@@ -17,6 +17,11 @@ import {
   GetHealthEventCommandInput,
   GetHealthEventCommandOutput,
 } from "./commands/GetHealthEventCommand";
+import {
+  GetInternetEventCommand,
+  GetInternetEventCommandInput,
+  GetInternetEventCommandOutput,
+} from "./commands/GetInternetEventCommand";
 import { GetMonitorCommand, GetMonitorCommandInput, GetMonitorCommandOutput } from "./commands/GetMonitorCommand";
 import {
   GetQueryResultsCommand,
@@ -33,6 +38,11 @@ import {
   ListHealthEventsCommandInput,
   ListHealthEventsCommandOutput,
 } from "./commands/ListHealthEventsCommand";
+import {
+  ListInternetEventsCommand,
+  ListInternetEventsCommandInput,
+  ListInternetEventsCommandOutput,
+} from "./commands/ListInternetEventsCommand";
 import {
   ListMonitorsCommand,
   ListMonitorsCommandInput,
@@ -62,10 +72,12 @@ const commands = {
   CreateMonitorCommand,
   DeleteMonitorCommand,
   GetHealthEventCommand,
+  GetInternetEventCommand,
   GetMonitorCommand,
   GetQueryResultsCommand,
   GetQueryStatusCommand,
   ListHealthEventsCommand,
+  ListInternetEventsCommand,
   ListMonitorsCommand,
   ListTagsForResourceCommand,
   StartQueryCommand,
@@ -112,6 +124,23 @@ export interface InternetMonitor {
     cb: (err: any, data?: GetHealthEventCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link GetInternetEventCommand}
+   */
+  getInternetEvent(
+    args: GetInternetEventCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<GetInternetEventCommandOutput>;
+  getInternetEvent(
+    args: GetInternetEventCommandInput,
+    cb: (err: any, data?: GetInternetEventCommandOutput) => void
+  ): void;
+  getInternetEvent(
+    args: GetInternetEventCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: GetInternetEventCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link GetMonitorCommand}
    */
@@ -168,6 +197,24 @@ export interface InternetMonitor {
     cb: (err: any, data?: ListHealthEventsCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListInternetEventsCommand}
+   */
+  listInternetEvents(): Promise<ListInternetEventsCommandOutput>;
+  listInternetEvents(
+    args: ListInternetEventsCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListInternetEventsCommandOutput>;
+  listInternetEvents(
+    args: ListInternetEventsCommandInput,
+    cb: (err: any, data?: ListInternetEventsCommandOutput) => void
+  ): void;
+  listInternetEvents(
+    args: ListInternetEventsCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListInternetEventsCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListMonitorsCommand}
    */

clients/client-internetmonitor/src/InternetMonitorClient.ts

@@ -56,10 +56,12 @@ import {
 import { CreateMonitorCommandInput, CreateMonitorCommandOutput } from "./commands/CreateMonitorCommand";
 import { DeleteMonitorCommandInput, DeleteMonitorCommandOutput } from "./commands/DeleteMonitorCommand";
 import { GetHealthEventCommandInput, GetHealthEventCommandOutput } from "./commands/GetHealthEventCommand";
+import { GetInternetEventCommandInput, GetInternetEventCommandOutput } from "./commands/GetInternetEventCommand";
 import { GetMonitorCommandInput, GetMonitorCommandOutput } from "./commands/GetMonitorCommand";
 import { GetQueryResultsCommandInput, GetQueryResultsCommandOutput } from "./commands/GetQueryResultsCommand";
 import { GetQueryStatusCommandInput, GetQueryStatusCommandOutput } from "./commands/GetQueryStatusCommand";
 import { ListHealthEventsCommandInput, ListHealthEventsCommandOutput } from "./commands/ListHealthEventsCommand";
+import { ListInternetEventsCommandInput, ListInternetEventsCommandOutput } from "./commands/ListInternetEventsCommand";
 import { ListMonitorsCommandInput, ListMonitorsCommandOutput } from "./commands/ListMonitorsCommand";
 import {
   ListTagsForResourceCommandInput,
@@ -88,10 +90,12 @@ export type ServiceInputTypes =
   | CreateMonitorCommandInput
   | DeleteMonitorCommandInput
   | GetHealthEventCommandInput
+  | GetInternetEventCommandInput
   | GetMonitorCommandInput
   | GetQueryResultsCommandInput
   | GetQueryStatusCommandInput
   | ListHealthEventsCommandInput
+  | ListInternetEventsCommandInput
   | ListMonitorsCommandInput
   | ListTagsForResourceCommandInput
   | StartQueryCommandInput
@@ -107,10 +111,12 @@ export type ServiceOutputTypes =
   | CreateMonitorCommandOutput
   | DeleteMonitorCommandOutput
   | GetHealthEventCommandOutput
+  | GetInternetEventCommandOutput
   | GetMonitorCommandOutput
   | GetQueryResultsCommandOutput
   | GetQueryStatusCommandOutput
   | ListHealthEventsCommandOutput
+  | ListInternetEventsCommandOutput
   | ListMonitorsCommandOutput
   | ListTagsForResourceCommandOutput
   | StartQueryCommandOutput

clients/client-internetmonitor/src/commands/GetHealthEventCommand.ts

@@ -27,7 +27,7 @@ export interface GetHealthEventCommandInput extends GetHealthEventInput {}
 export interface GetHealthEventCommandOutput extends GetHealthEventOutput, __MetadataBearer {}
 
 /**
- * <p>Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations,
+ * <p>Gets information that Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations,
  * 			and all the information related to the event, by location.</p>
  *          <p>The information returned includes the impact on performance, availability, and round-trip time, information about the network providers (ASNs),
  * 			the event type, and so on.</p>

clients/client-internetmonitor/src/commands/GetInternetEventCommand.ts

@@ -0,0 +1,113 @@
+// smithy-typescript generated code
+import { getEndpointPlugin } from "@smithy/middleware-endpoint";
+import { getSerdePlugin } from "@smithy/middleware-serde";
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+
+import { commonParams } from "../endpoint/EndpointParameters";
+import { InternetMonitorClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../InternetMonitorClient";
+import { GetInternetEventInput, GetInternetEventOutput } from "../models/models_0";
+import { de_GetInternetEventCommand, se_GetInternetEventCommand } from "../protocols/Aws_restJson1";
+
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetInternetEventCommand}.
+ */
+export interface GetInternetEventCommandInput extends GetInternetEventInput {}
+/**
+ * @public
+ *
+ * The output of {@link GetInternetEventCommand}.
+ */
+export interface GetInternetEventCommandOutput extends GetInternetEventOutput, __MetadataBearer {}
+
+/**
+ * <p>Gets information that Amazon CloudWatch Internet Monitor has generated about an internet event. Internet Monitor displays information about
+ * 			recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services
+ * 			customers. </p>
+ *          <p>The information returned here includes the impacted location,
+ * 			when the event started and (if the event is over) ended, the type of event (<code>PERFORMANCE</code> or <code>AVAILABILITY</code>),
+ * 			and the status (<code>ACTIVE</code> or <code>RESOLVED</code>).</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { InternetMonitorClient, GetInternetEventCommand } from "@aws-sdk/client-internetmonitor"; // ES Modules import
+ * // const { InternetMonitorClient, GetInternetEventCommand } = require("@aws-sdk/client-internetmonitor"); // CommonJS import
+ * const client = new InternetMonitorClient(config);
+ * const input = { // GetInternetEventInput
+ *   EventId: "STRING_VALUE", // required
+ * };
+ * const command = new GetInternetEventCommand(input);
+ * const response = await client.send(command);
+ * // { // GetInternetEventOutput
+ * //   EventId: "STRING_VALUE", // required
+ * //   EventArn: "STRING_VALUE", // required
+ * //   StartedAt: new Date("TIMESTAMP"), // required
+ * //   EndedAt: new Date("TIMESTAMP"),
+ * //   ClientLocation: { // ClientLocation
+ * //     ASName: "STRING_VALUE", // required
+ * //     ASNumber: Number("long"), // required
+ * //     Country: "STRING_VALUE", // required
+ * //     Subdivision: "STRING_VALUE",
+ * //     Metro: "STRING_VALUE",
+ * //     City: "STRING_VALUE", // required
+ * //     Latitude: Number("double"), // required
+ * //     Longitude: Number("double"), // required
+ * //   },
+ * //   EventType: "STRING_VALUE", // required
+ * //   EventStatus: "STRING_VALUE", // required
+ * // };
+ *
+ * ```
+ *
+ * @param GetInternetEventCommandInput - {@link GetInternetEventCommandInput}
+ * @returns {@link GetInternetEventCommandOutput}
+ * @see {@link GetInternetEventCommandInput} for command's `input` shape.
+ * @see {@link GetInternetEventCommandOutput} for command's `response` shape.
+ * @see {@link InternetMonitorClientResolvedConfig | config} for InternetMonitorClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have sufficient permission to perform this action.</p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>An internal error occurred.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was denied due to request throttling.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>Invalid request.</p>
+ *
+ * @throws {@link InternetMonitorServiceException}
+ * <p>Base exception class for all service exceptions from InternetMonitor service.</p>
+ *
+ * @public
+ */
+export class GetInternetEventCommand extends $Command
+  .classBuilder<
+    GetInternetEventCommandInput,
+    GetInternetEventCommandOutput,
+    InternetMonitorClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >()
+  .ep({
+    ...commonParams,
+  })
+  .m(function (this: any, Command: any, cs: any, config: InternetMonitorClientResolvedConfig, o: any) {
+    return [
+      getSerdePlugin(config, this.serialize, this.deserialize),
+      getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+    ];
+  })
+  .s("InternetMonitor20210603", "GetInternetEvent", {})
+  .n("InternetMonitorClient", "GetInternetEventCommand")
+  .f(void 0, void 0)
+  .ser(se_GetInternetEventCommand)
+  .de(de_GetInternetEventCommand)
+  .build() {}

clients/client-internetmonitor/src/commands/ListHealthEventsCommand.ts

@@ -27,7 +27,7 @@ export interface ListHealthEventsCommandInput extends ListHealthEventsInput {}
 export interface ListHealthEventsCommandOutput extends ListHealthEventsOutput, __MetadataBearer {}
 
 /**
- * <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
+ * <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
  * 			the status.</p>
  *          <note>
  *             <p>Health events that have start times during the time frame that is requested are not included in the list of health events.</p>