@aws-sdk/client-internetmonitor 3.312.0 → 3.316.0

package/dist-types/InternetMonitor.d.ts

@@ -10,114 +10,86 @@ import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/Ta
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import { UpdateMonitorCommandInput, UpdateMonitorCommandOutput } from "./commands/UpdateMonitorCommand";
 import { InternetMonitorClient } from "./InternetMonitorClient";
-/**
- * @public
- * <p>Amazon CloudWatch Internet Monitor provides visibility into how internet issues impact the performance and availability
- * 			between your applications hosted on Amazon Web Services and your end users. It reduces the time it takes for you to diagnose
- * 			internet issues from days to minutes. Internet Monitor uses the connectivity data that Amazon Web Services captures from its global
- * 			networking footprint to calculate a baseline of performance and availability for internet traffic. This
- * 			is the same data that Amazon Web Services uses to monitor internet uptime and availability. With those measurements
- * 			as a baseline, Internet Monitor raises awareness for you when there are significant problems for your
- * 			end users in the different geographic locations where your application runs.</p>
- *          <p>Internet Monitor publishes internet measurements to CloudWatch Logs and CloudWatch Metrics,
- * 			to easily support using CloudWatch tools with health information for geographies and networks specific to your application.
- * 			Internet Monitor sends health events to Amazon EventBridge so that you can set up notifications. If an issue is caused by the Amazon Web Services network,
- * 			you also automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking to mitigate the problem.</p>
- *          <p>To use Internet Monitor, you create a <i>monitor</i> and associate your application's resources
- * 			with it, VPCs, CloudFront distributions, or WorkSpaces directories, to enable Internet Monitor to know
- * 			where your application's internet traffic is. Internet Monitor then provides internet measurements from Amazon Web Services that are specific to
- * 			the locations and networks that communicate with your application.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html">Using Amazon CloudWatch Internet Monitor</a> in the <i>Amazon CloudWatch User Guide</i>.</p>
- */
-export declare class InternetMonitor extends InternetMonitorClient {
+export interface InternetMonitor {
     /**
-     * @public
-     * <p>Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: Amazon Virtual Private Clouds (VPCs),
-     * 			Amazon CloudFront distributions, and WorkSpaces directories. Internet Monitor then publishes internet measurements from Amazon Web Services that are specific to
-     * 			the <i>city-networks</i>, that is, the locations and ASNs (typically internet service providers or ISPs),
-     * 			where clients access your application. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html">Using Amazon CloudWatch Internet Monitor</a> in the <i>Amazon CloudWatch User Guide</i>.</p>
-     *          <p>When you create a monitor, you set a maximum limit for the number of city-networks where client traffic is monitored. The city-network maximum
-     * 			that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. You can change the maximum at any time
-     * 			by updating your monitor. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html">Choosing a city-network maximum value</a> in the <i>Amazon CloudWatch User Guide</i>.</p>
+     * @see {@link CreateMonitorCommand}
      */
     createMonitor(args: CreateMonitorCommandInput, options?: __HttpHandlerOptions): Promise<CreateMonitorCommandOutput>;
     createMonitor(args: CreateMonitorCommandInput, cb: (err: any, data?: CreateMonitorCommandOutput) => void): void;
     createMonitor(args: CreateMonitorCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateMonitorCommandOutput) => void): void;
     /**
-     * @public
-     * <p>Deletes a monitor in Amazon CloudWatch Internet Monitor. </p>
+     * @see {@link DeleteMonitorCommand}
      */
     deleteMonitor(args: DeleteMonitorCommandInput, options?: __HttpHandlerOptions): Promise<DeleteMonitorCommandOutput>;
     deleteMonitor(args: DeleteMonitorCommandInput, cb: (err: any, data?: DeleteMonitorCommandOutput) => void): void;
     deleteMonitor(args: DeleteMonitorCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteMonitorCommandOutput) => void): void;
     /**
-     * @public
-     * <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,
-     * 			and all of the information related to the event by location.</p>
-     *          <p>The information returned includes the performance, availability, and round-trip time impact, information about the network providers, the event type,
-     * 			and so on.</p>
-     *          <p>Information rolled up at the global traffic level is also returned, including the impact type and total traffic impact.</p>
+     * @see {@link GetHealthEventCommand}
      */
     getHealthEvent(args: GetHealthEventCommandInput, options?: __HttpHandlerOptions): Promise<GetHealthEventCommandOutput>;
     getHealthEvent(args: GetHealthEventCommandInput, cb: (err: any, data?: GetHealthEventCommandOutput) => void): void;
     getHealthEvent(args: GetHealthEventCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetHealthEventCommandOutput) => void): void;
     /**
-     * @public
-     * <p>Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name. The information returned includes the Amazon Resource Name (ARN), create time,
-     * 			modified time, resources included in the monitor, and status information.</p>
+     * @see {@link GetMonitorCommand}
      */
     getMonitor(args: GetMonitorCommandInput, options?: __HttpHandlerOptions): Promise<GetMonitorCommandOutput>;
     getMonitor(args: GetMonitorCommandInput, cb: (err: any, data?: GetMonitorCommandOutput) => void): void;
     getMonitor(args: GetMonitorCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetMonitorCommandOutput) => void): void;
     /**
-     * @public
-     * <p>Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns all information for health events including the client location information the network
-     * 			cause and status, event start and end time, percentage of total traffic impacted, and 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>
-     *          </note>
+     * @see {@link ListHealthEventsCommand}
      */
     listHealthEvents(args: ListHealthEventsCommandInput, options?: __HttpHandlerOptions): Promise<ListHealthEventsCommandOutput>;
     listHealthEvents(args: ListHealthEventsCommandInput, cb: (err: any, data?: ListHealthEventsCommandOutput) => void): void;
     listHealthEvents(args: ListHealthEventsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListHealthEventsCommandOutput) => void): void;
     /**
-     * @public
-     * <p>Lists all of your monitors for Amazon CloudWatch Internet Monitor and their statuses, along with the Amazon Resource Name (ARN) and name of each monitor.</p>
+     * @see {@link ListMonitorsCommand}
      */
     listMonitors(args: ListMonitorsCommandInput, options?: __HttpHandlerOptions): Promise<ListMonitorsCommandOutput>;
     listMonitors(args: ListMonitorsCommandInput, cb: (err: any, data?: ListMonitorsCommandOutput) => void): void;
     listMonitors(args: ListMonitorsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListMonitorsCommandOutput) => void): void;
     /**
-     * @public
-     * <p>Lists the tags for a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor.</p>
+     * @see {@link ListTagsForResourceCommand}
      */
     listTagsForResource(args: ListTagsForResourceCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsForResourceCommandOutput>;
     listTagsForResource(args: ListTagsForResourceCommandInput, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
     listTagsForResource(args: ListTagsForResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
     /**
-     * @public
-     * <p>Adds a tag to a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor. You can add a maximum of 50 tags in Internet Monitor.</p>
-     *          <p>A minimum of one tag is required for this call. It returns an error if you use the <code>TagResource</code> request with 0 tags.</p>
+     * @see {@link TagResourceCommand}
      */
     tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
     tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     tagResource(args: TagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     /**
-     * @public
-     * <p>Removes a tag from a resource.</p>
+     * @see {@link UntagResourceCommand}
      */
     untagResource(args: UntagResourceCommandInput, options?: __HttpHandlerOptions): Promise<UntagResourceCommandOutput>;
     untagResource(args: UntagResourceCommandInput, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     /**
-     * @public
-     * <p>Updates a monitor. You can update a monitor to change the maximum number of city-networks (locations and ASNs or
-     * 			internet service providers), to add or remove resources,
-     * 			or to change the status of the monitor. Note that you can't change the name of a monitor.</p>
-     *          <p>The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored.
-     * 			For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html">Choosing a city-network maximum value</a> in the <i>Amazon CloudWatch User Guide</i>.</p>
+     * @see {@link UpdateMonitorCommand}
      */
     updateMonitor(args: UpdateMonitorCommandInput, options?: __HttpHandlerOptions): Promise<UpdateMonitorCommandOutput>;
     updateMonitor(args: UpdateMonitorCommandInput, cb: (err: any, data?: UpdateMonitorCommandOutput) => void): void;
     updateMonitor(args: UpdateMonitorCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateMonitorCommandOutput) => void): void;
 }
+/**
+ * @public
+ * <p>Amazon CloudWatch Internet Monitor provides visibility into how internet issues impact the performance and availability
+ * 			between your applications hosted on Amazon Web Services and your end users. It reduces the time it takes for you to diagnose
+ * 			internet issues from days to minutes. Internet Monitor uses the connectivity data that Amazon Web Services captures from its global
+ * 			networking footprint to calculate a baseline of performance and availability for internet traffic. This
+ * 			is the same data that Amazon Web Services uses to monitor internet uptime and availability. With those measurements
+ * 			as a baseline, Internet Monitor raises awareness for you when there are significant problems for your
+ * 			end users in the different geographic locations where your application runs.</p>
+ *          <p>Internet Monitor publishes internet measurements to CloudWatch Logs and CloudWatch Metrics,
+ * 			to easily support using CloudWatch tools with health information for geographies and networks specific to your application.
+ * 			Internet Monitor sends health events to Amazon EventBridge so that you can set up notifications. If an issue is caused by the Amazon Web Services network,
+ * 			you also automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking to mitigate the problem.</p>
+ *          <p>To use Internet Monitor, you create a <i>monitor</i> and associate your application's resources
+ * 			with it, VPCs, CloudFront distributions, or WorkSpaces directories, to enable Internet Monitor to know
+ * 			where your application's internet traffic is. Internet Monitor then provides internet measurements from Amazon Web Services that are specific to
+ * 			the locations and networks that communicate with your application.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html">Using Amazon CloudWatch Internet Monitor</a> in the <i>Amazon CloudWatch User Guide</i>.</p>
+ */
+export declare class InternetMonitor extends InternetMonitorClient implements InternetMonitor {
+}

package/dist-types/commands/CreateMonitorCommand.d.ts

@@ -41,7 +41,7 @@ export interface CreateMonitorCommandOutput extends CreateMonitorOutput, __Metad
  *   Tags: { // TagMap
  *     "<keys>": "STRING_VALUE",
  *   },
- *   MaxCityNetworksToMonitor: Number("int"), // required
+ *   MaxCityNetworksToMonitor: Number("int"),
  *   InternetMeasurementsLogDelivery: { // InternetMeasurementsLogDelivery
  *     S3Config: { // S3Config
  *       BucketName: "STRING_VALUE",
@@ -49,6 +49,7 @@ export interface CreateMonitorCommandOutput extends CreateMonitorOutput, __Metad
  *       LogDeliveryStatus: "STRING_VALUE",
  *     },
  *   },
+ *   TrafficPercentageToMonitor: Number("int"),
  * };
  * const command = new CreateMonitorCommand(input);
  * const response = await client.send(command);

package/dist-types/commands/UpdateMonitorCommand.d.ts

@@ -48,6 +48,7 @@ export interface UpdateMonitorCommandOutput extends UpdateMonitorOutput, __Metad
  *       LogDeliveryStatus: "STRING_VALUE",
  *     },
  *   },
+ *   TrafficPercentageToMonitor: Number("int"),
  * };
  * const command = new UpdateMonitorCommand(input);
  * const response = await client.send(command);

package/dist-types/models/models_0.d.ts

@@ -104,8 +104,7 @@ export interface S3Config {
 }
 /**
  * @public
- * <p>Configuration information for other locations that you choose to publish Amazon CloudWatch Internet Monitor internet measurements to, such as Amazon S3.
- * 			The measurements are also published to Amazon CloudWatch Logs.</p>
+ * <p>Publish internet measurements to an Amazon S3 bucket in addition to CloudWatch Logs.</p>
  */
 export interface InternetMeasurementsLogDelivery {
     /**
@@ -147,11 +146,15 @@ export interface CreateMonitorInput {
      *          <p>To learn more, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html">Choosing a city-network maximum value
      * 		</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
-    MaxCityNetworksToMonitor: number | undefined;
+    MaxCityNetworksToMonitor?: number;
     /**
-     * <p>Publish internet measurements for Internet Monitor to another location, such as an Amazon S3 bucket. The measurements are also published to Amazon CloudWatch Logs.</p>
+     * <p>Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs.</p>
      */
     InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
+    /**
+     * <p>The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.</p>
+     */
+    TrafficPercentageToMonitor?: number;
 }
 /**
  * @public
@@ -602,11 +605,15 @@ export interface GetMonitorOutput {
      *          <p>To learn more, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html">Choosing a city-network maximum value
      * 		</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
-    MaxCityNetworksToMonitor: number | undefined;
+    MaxCityNetworksToMonitor?: number;
     /**
      * <p>Publish internet measurements for Internet Monitor to another location, such as an Amazon S3 bucket. The measurements are also published to Amazon CloudWatch Logs.</p>
      */
     InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
+    /**
+     * <p>The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.</p>
+     */
+    TrafficPercentageToMonitor?: number;
 }
 /**
  * @public
@@ -862,6 +869,10 @@ export interface UpdateMonitorInput {
      * <p>Publish internet measurements for Internet Monitor to another location, such as an Amazon S3 bucket. The measurements are also published to Amazon CloudWatch Logs.</p>
      */
     InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
+    /**
+     * <p>The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.</p>
+     */
+    TrafficPercentageToMonitor?: number;
 }
 /**
  * @public

package/dist-types/ts3.4/InternetMonitor.d.ts

@@ -40,7 +40,7 @@ import {
   UpdateMonitorCommandOutput,
 } from "./commands/UpdateMonitorCommand";
 import { InternetMonitorClient } from "./InternetMonitorClient";
-export declare class InternetMonitor extends InternetMonitorClient {
+export interface InternetMonitor {
   createMonitor(
     args: CreateMonitorCommandInput,
     options?: __HttpHandlerOptions
@@ -172,3 +172,6 @@ export declare class InternetMonitor extends InternetMonitorClient {
     cb: (err: any, data?: UpdateMonitorCommandOutput) => void
   ): void;
 }
+export declare class InternetMonitor
+  extends InternetMonitorClient
+  implements InternetMonitor {}

package/dist-types/ts3.4/models/models_0.d.ts

@@ -43,8 +43,9 @@ export interface CreateMonitorInput {
   Resources?: string[];
   ClientToken?: string;
   Tags?: Record<string, string>;
-  MaxCityNetworksToMonitor: number | undefined;
+  MaxCityNetworksToMonitor?: number;
   InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
+  TrafficPercentageToMonitor?: number;
 }
 export declare const MonitorConfigState: {
   readonly ACTIVE: "ACTIVE";
@@ -191,8 +192,9 @@ export interface GetMonitorOutput {
   ProcessingStatus?: MonitorProcessingStatusCode | string;
   ProcessingStatusInfo?: string;
   Tags?: Record<string, string>;
-  MaxCityNetworksToMonitor: number | undefined;
+  MaxCityNetworksToMonitor?: number;
   InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
+  TrafficPercentageToMonitor?: number;
 }
 export interface HealthEvent {
   EventArn: string | undefined;
@@ -277,6 +279,7 @@ export interface UpdateMonitorInput {
   ClientToken?: string;
   MaxCityNetworksToMonitor?: number;
   InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
+  TrafficPercentageToMonitor?: number;
 }
 export interface UpdateMonitorOutput {
   MonitorArn: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-internetmonitor",
   "description": "AWS SDK for JavaScript Internetmonitor Client for Node.js, Browser and React Native",
-  "version": "3.312.0",
+  "version": "3.316.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,9 +21,9 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.312.0",
+    "@aws-sdk/client-sts": "3.316.0",
     "@aws-sdk/config-resolver": "3.310.0",
-    "@aws-sdk/credential-provider-node": "3.310.0",
+    "@aws-sdk/credential-provider-node": "3.316.0",
     "@aws-sdk/fetch-http-handler": "3.310.0",
     "@aws-sdk/hash-node": "3.310.0",
     "@aws-sdk/invalid-dependency": "3.310.0",
@@ -40,14 +40,14 @@
     "@aws-sdk/node-config-provider": "3.310.0",
     "@aws-sdk/node-http-handler": "3.310.0",
     "@aws-sdk/protocol-http": "3.310.0",
-    "@aws-sdk/smithy-client": "3.310.0",
+    "@aws-sdk/smithy-client": "3.316.0",
     "@aws-sdk/types": "3.310.0",
     "@aws-sdk/url-parser": "3.310.0",
     "@aws-sdk/util-base64": "3.310.0",
     "@aws-sdk/util-body-length-browser": "3.310.0",
     "@aws-sdk/util-body-length-node": "3.310.0",
-    "@aws-sdk/util-defaults-mode-browser": "3.310.0",
-    "@aws-sdk/util-defaults-mode-node": "3.310.0",
+    "@aws-sdk/util-defaults-mode-browser": "3.316.0",
+    "@aws-sdk/util-defaults-mode-node": "3.316.0",
     "@aws-sdk/util-endpoints": "3.310.0",
     "@aws-sdk/util-retry": "3.310.0",
     "@aws-sdk/util-user-agent-browser": "3.310.0",