@aws-sdk/client-internetmonitor 3.303.0 → 3.304.0

package/README.md

@@ -9,17 +9,22 @@
 
 AWS SDK for JavaScript InternetMonitor Client for Node.js, Browser and React Native.
 
-<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, reducing the time it takes for you to diagnose these issues, from days to minutes. You can explore internet measurements for different time frames
-and at different geographic granularities, and quickly visualize the impact of issues, and then take action to improve your end users' experience, for
-example, by switching to other Amazon Web Services services or rerouting traffic to your workload through differentAmazon Web Services Regions.</p>
-<p> If the issue is caused by the Amazon Web Services network, you'll automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking
-to mitigate the problem. To support integrating health information for geographies and networks specific to your application, Internet Monitor delivers measurements
-to CloudWatch Logs and CloudWatch Metrics. Internet Monitor also sends health events to Amazon EventBridge, so you can set up notifications. Internet Monitor monitors internet connectivity
-for your application through Amazon Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and Amazon WorkSpaces directories.</p>
-<p>To use Internet Monitor, you create a <i>monitor</i> and add resources to it, Virtual Private Clouds (VPCs), Amazon CloudFront distributions, or WorkSpaces
-directories that show 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. 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 Amazon CloudWatch User Guide.</p>
+<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>
 
 ## Installing
 

package/dist-cjs/models/models_0.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceNotFoundException = exports.TooManyRequestsException = exports.NotFoundException = exports.InternalServerErrorException = exports.MonitorProcessingStatusCode = exports.HealthEventImpactType = exports.HealthEventStatus = exports.TriangulationEventType = exports.ValidationException = exports.ThrottlingException = exports.LimitExceededException = exports.InternalServerException = exports.MonitorConfigState = exports.ConflictException = exports.BadRequestException = exports.AccessDeniedException = void 0;
+exports.ResourceNotFoundException = exports.TooManyRequestsException = exports.NotFoundException = exports.InternalServerErrorException = exports.MonitorProcessingStatusCode = exports.HealthEventImpactType = exports.HealthEventStatus = exports.TriangulationEventType = exports.ValidationException = exports.ThrottlingException = exports.LimitExceededException = exports.InternalServerException = exports.MonitorConfigState = exports.LogDeliveryStatus = exports.ConflictException = exports.BadRequestException = exports.AccessDeniedException = void 0;
 const InternetMonitorServiceException_1 = require("./InternetMonitorServiceException");
 class AccessDeniedException extends InternetMonitorServiceException_1.InternetMonitorServiceException {
     constructor(opts) {
@@ -41,6 +41,10 @@ class ConflictException extends InternetMonitorServiceException_1.InternetMonito
     }
 }
 exports.ConflictException = ConflictException;
+exports.LogDeliveryStatus = {
+    DISABLED: "DISABLED",
+    ENABLED: "ENABLED",
+};
 exports.MonitorConfigState = {
     ACTIVE: "ACTIVE",
     ERROR: "ERROR",

package/dist-cjs/protocols/Aws_restJson1.js

@@ -15,6 +15,9 @@ const serializeAws_restJson1CreateMonitorCommand = async (input, context) => {
     let body;
     body = JSON.stringify({
         ClientToken: input.ClientToken ?? (0, uuid_1.v4)(),
+        ...(input.InternetMeasurementsLogDelivery != null && {
+            InternetMeasurementsLogDelivery: serializeAws_restJson1InternetMeasurementsLogDelivery(input.InternetMeasurementsLogDelivery, context),
+        }),
         ...(input.MaxCityNetworksToMonitor != null && { MaxCityNetworksToMonitor: input.MaxCityNetworksToMonitor }),
         ...(input.MonitorName != null && { MonitorName: input.MonitorName }),
         ...(input.Resources != null && { Resources: serializeAws_restJson1SetOfARNs(input.Resources, context) }),
@@ -208,6 +211,9 @@ const serializeAws_restJson1UpdateMonitorCommand = async (input, context) => {
     let body;
     body = JSON.stringify({
         ClientToken: input.ClientToken ?? (0, uuid_1.v4)(),
+        ...(input.InternetMeasurementsLogDelivery != null && {
+            InternetMeasurementsLogDelivery: serializeAws_restJson1InternetMeasurementsLogDelivery(input.InternetMeasurementsLogDelivery, context),
+        }),
         ...(input.MaxCityNetworksToMonitor != null && { MaxCityNetworksToMonitor: input.MaxCityNetworksToMonitor }),
         ...(input.ResourcesToAdd != null && {
             ResourcesToAdd: serializeAws_restJson1SetOfARNs(input.ResourcesToAdd, context),
@@ -401,6 +407,9 @@ const deserializeAws_restJson1GetMonitorCommand = async (output, context) => {
     if (data.CreatedAt != null) {
         contents.CreatedAt = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseRfc3339DateTimeWithOffset)(data.CreatedAt));
     }
+    if (data.InternetMeasurementsLogDelivery != null) {
+        contents.InternetMeasurementsLogDelivery = deserializeAws_restJson1InternetMeasurementsLogDelivery(data.InternetMeasurementsLogDelivery, context);
+    }
     if (data.MaxCityNetworksToMonitor != null) {
         contents.MaxCityNetworksToMonitor = (0, smithy_client_1.expectInt32)(data.MaxCityNetworksToMonitor);
     }
@@ -869,6 +878,18 @@ const deserializeAws_restJson1ValidationExceptionResponse = async (parsedOutput,
     });
     return (0, smithy_client_1.decorateServiceException)(exception, parsedOutput.body);
 };
+const serializeAws_restJson1InternetMeasurementsLogDelivery = (input, context) => {
+    return {
+        ...(input.S3Config != null && { S3Config: serializeAws_restJson1S3Config(input.S3Config, context) }),
+    };
+};
+const serializeAws_restJson1S3Config = (input, context) => {
+    return {
+        ...(input.BucketName != null && { BucketName: input.BucketName }),
+        ...(input.BucketPrefix != null && { BucketPrefix: input.BucketPrefix }),
+        ...(input.LogDeliveryStatus != null && { LogDeliveryStatus: input.LogDeliveryStatus }),
+    };
+};
 const serializeAws_restJson1SetOfARNs = (input, context) => {
     return input
         .filter((e) => e != null)
@@ -962,6 +983,11 @@ const deserializeAws_restJson1InternetHealth = (output, context) => {
             : undefined,
     };
 };
+const deserializeAws_restJson1InternetMeasurementsLogDelivery = (output, context) => {
+    return {
+        S3Config: output.S3Config != null ? deserializeAws_restJson1S3Config(output.S3Config, context) : undefined,
+    };
+};
 const deserializeAws_restJson1Monitor = (output, context) => {
     return {
         MonitorArn: (0, smithy_client_1.expectString)(output.MonitorArn),
@@ -1020,6 +1046,13 @@ const deserializeAws_restJson1RoundTripTime = (output, context) => {
         P95: (0, smithy_client_1.limitedParseDouble)(output.P95),
     };
 };
+const deserializeAws_restJson1S3Config = (output, context) => {
+    return {
+        BucketName: (0, smithy_client_1.expectString)(output.BucketName),
+        BucketPrefix: (0, smithy_client_1.expectString)(output.BucketPrefix),
+        LogDeliveryStatus: (0, smithy_client_1.expectString)(output.LogDeliveryStatus),
+    };
+};
 const deserializeAws_restJson1SetOfARNs = (output, context) => {
     const retVal = (output || [])
         .filter((e) => e != null)

package/dist-es/models/models_0.js

@@ -35,6 +35,10 @@ export class ConflictException extends __BaseException {
         Object.setPrototypeOf(this, ConflictException.prototype);
     }
 }
+export const LogDeliveryStatus = {
+    DISABLED: "DISABLED",
+    ENABLED: "ENABLED",
+};
 export const MonitorConfigState = {
     ACTIVE: "ACTIVE",
     ERROR: "ERROR",

package/dist-es/protocols/Aws_restJson1.js

@@ -12,6 +12,9 @@ export const serializeAws_restJson1CreateMonitorCommand = async (input, context)
     let body;
     body = JSON.stringify({
         ClientToken: input.ClientToken ?? generateIdempotencyToken(),
+        ...(input.InternetMeasurementsLogDelivery != null && {
+            InternetMeasurementsLogDelivery: serializeAws_restJson1InternetMeasurementsLogDelivery(input.InternetMeasurementsLogDelivery, context),
+        }),
         ...(input.MaxCityNetworksToMonitor != null && { MaxCityNetworksToMonitor: input.MaxCityNetworksToMonitor }),
         ...(input.MonitorName != null && { MonitorName: input.MonitorName }),
         ...(input.Resources != null && { Resources: serializeAws_restJson1SetOfARNs(input.Resources, context) }),
@@ -196,6 +199,9 @@ export const serializeAws_restJson1UpdateMonitorCommand = async (input, context)
     let body;
     body = JSON.stringify({
         ClientToken: input.ClientToken ?? generateIdempotencyToken(),
+        ...(input.InternetMeasurementsLogDelivery != null && {
+            InternetMeasurementsLogDelivery: serializeAws_restJson1InternetMeasurementsLogDelivery(input.InternetMeasurementsLogDelivery, context),
+        }),
         ...(input.MaxCityNetworksToMonitor != null && { MaxCityNetworksToMonitor: input.MaxCityNetworksToMonitor }),
         ...(input.ResourcesToAdd != null && {
             ResourcesToAdd: serializeAws_restJson1SetOfARNs(input.ResourcesToAdd, context),
@@ -385,6 +391,9 @@ export const deserializeAws_restJson1GetMonitorCommand = async (output, context)
     if (data.CreatedAt != null) {
         contents.CreatedAt = __expectNonNull(__parseRfc3339DateTimeWithOffset(data.CreatedAt));
     }
+    if (data.InternetMeasurementsLogDelivery != null) {
+        contents.InternetMeasurementsLogDelivery = deserializeAws_restJson1InternetMeasurementsLogDelivery(data.InternetMeasurementsLogDelivery, context);
+    }
     if (data.MaxCityNetworksToMonitor != null) {
         contents.MaxCityNetworksToMonitor = __expectInt32(data.MaxCityNetworksToMonitor);
     }
@@ -846,6 +855,18 @@ const deserializeAws_restJson1ValidationExceptionResponse = async (parsedOutput,
     });
     return __decorateServiceException(exception, parsedOutput.body);
 };
+const serializeAws_restJson1InternetMeasurementsLogDelivery = (input, context) => {
+    return {
+        ...(input.S3Config != null && { S3Config: serializeAws_restJson1S3Config(input.S3Config, context) }),
+    };
+};
+const serializeAws_restJson1S3Config = (input, context) => {
+    return {
+        ...(input.BucketName != null && { BucketName: input.BucketName }),
+        ...(input.BucketPrefix != null && { BucketPrefix: input.BucketPrefix }),
+        ...(input.LogDeliveryStatus != null && { LogDeliveryStatus: input.LogDeliveryStatus }),
+    };
+};
 const serializeAws_restJson1SetOfARNs = (input, context) => {
     return input
         .filter((e) => e != null)
@@ -939,6 +960,11 @@ const deserializeAws_restJson1InternetHealth = (output, context) => {
             : undefined,
     };
 };
+const deserializeAws_restJson1InternetMeasurementsLogDelivery = (output, context) => {
+    return {
+        S3Config: output.S3Config != null ? deserializeAws_restJson1S3Config(output.S3Config, context) : undefined,
+    };
+};
 const deserializeAws_restJson1Monitor = (output, context) => {
     return {
         MonitorArn: __expectString(output.MonitorArn),
@@ -997,6 +1023,13 @@ const deserializeAws_restJson1RoundTripTime = (output, context) => {
         P95: __limitedParseDouble(output.P95),
     };
 };
+const deserializeAws_restJson1S3Config = (output, context) => {
+    return {
+        BucketName: __expectString(output.BucketName),
+        BucketPrefix: __expectString(output.BucketPrefix),
+        LogDeliveryStatus: __expectString(output.LogDeliveryStatus),
+    };
+};
 const deserializeAws_restJson1SetOfARNs = (output, context) => {
     const retVal = (output || [])
         .filter((e) => e != null)

package/dist-types/InternetMonitor.d.ts

@@ -12,25 +12,33 @@ import { UpdateMonitorCommandInput, UpdateMonitorCommandOutput } from "./command
 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, reducing the time it takes for you to diagnose these issues, from days to minutes. You can explore internet measurements for different time frames
- * 			and at different geographic granularities, and quickly visualize the impact of issues, and then take action to improve your end users' experience, for
- * 			example, by switching to other Amazon Web Services services or rerouting traffic to your workload through differentAmazon Web Services Regions.</p>
- *          <p> If the issue is caused by the Amazon Web Services network, you'll automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking
- * 			to mitigate the problem. To support integrating health information for geographies and networks specific to your application, Internet Monitor delivers measurements
- * 			to CloudWatch Logs and CloudWatch Metrics. Internet Monitor also sends health events to Amazon EventBridge, so you can set up notifications. Internet Monitor monitors internet connectivity
- * 			for your application through Amazon Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and Amazon WorkSpaces directories.</p>
- *          <p>To use Internet Monitor, you create a <i>monitor</i> and add resources to it, Virtual Private Clouds (VPCs), Amazon CloudFront distributions, or WorkSpaces
- * 			directories that show 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. 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 Amazon CloudWatch User Guide.</p>
+ * <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 {
     /**
      * @public
-     * <p>Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: Virtual Private Clouds (VPCs),
-     * 			Amazon CloudFront distributions, and WorkSpaces directories. </p>
-     *          <p>After you create a monitor, you can view the internet performance for your application, scoped to a location, as well as any health events that are
-     * 			impairing traffic. Internet Monitor can also diagnose whether the impairment is on the Amazon Web Services network or is an issue with an internet service provider (ISP).</p>
+     * <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>
      */
     createMonitor(args: CreateMonitorCommandInput, options?: __HttpHandlerOptions): Promise<CreateMonitorCommandOutput>;
     createMonitor(args: CreateMonitorCommandInput, cb: (err: any, data?: CreateMonitorCommandOutput) => void): void;
@@ -103,8 +111,11 @@ export declare class InternetMonitor extends InternetMonitorClient {
     untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     /**
      * @public
-     * <p>Updates a monitor. You can update a monitor to add or remove resources, or to change the status of the monitor. You can't change the name of a
-     * 			monitor.</p>
+     * <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>
      */
     updateMonitor(args: UpdateMonitorCommandInput, options?: __HttpHandlerOptions): Promise<UpdateMonitorCommandOutput>;
     updateMonitor(args: UpdateMonitorCommandInput, cb: (err: any, data?: UpdateMonitorCommandOutput) => void): void;

package/dist-types/InternetMonitorClient.d.ts

@@ -153,17 +153,22 @@ export interface InternetMonitorClientResolvedConfig extends InternetMonitorClie
 }
 /**
  * @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, reducing the time it takes for you to diagnose these issues, from days to minutes. You can explore internet measurements for different time frames
- * 			and at different geographic granularities, and quickly visualize the impact of issues, and then take action to improve your end users' experience, for
- * 			example, by switching to other Amazon Web Services services or rerouting traffic to your workload through differentAmazon Web Services Regions.</p>
- *          <p> If the issue is caused by the Amazon Web Services network, you'll automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking
- * 			to mitigate the problem. To support integrating health information for geographies and networks specific to your application, Internet Monitor delivers measurements
- * 			to CloudWatch Logs and CloudWatch Metrics. Internet Monitor also sends health events to Amazon EventBridge, so you can set up notifications. Internet Monitor monitors internet connectivity
- * 			for your application through Amazon Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and Amazon WorkSpaces directories.</p>
- *          <p>To use Internet Monitor, you create a <i>monitor</i> and add resources to it, Virtual Private Clouds (VPCs), Amazon CloudFront distributions, or WorkSpaces
- * 			directories that show 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. 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 Amazon CloudWatch User Guide.</p>
+ * <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 InternetMonitorClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, InternetMonitorClientResolvedConfig> {
     /**

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

@@ -19,10 +19,13 @@ export interface CreateMonitorCommandOutput extends CreateMonitorOutput, __Metad
 }
 /**
  * @public
- * <p>Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: Virtual Private Clouds (VPCs),
- * 			Amazon CloudFront distributions, and WorkSpaces directories. </p>
- *          <p>After you create a monitor, you can view the internet performance for your application, scoped to a location, as well as any health events that are
- * 			impairing traffic. Internet Monitor can also diagnose whether the impairment is on the Amazon Web Services network or is an issue with an internet service provider (ISP).</p>
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -39,6 +42,13 @@ export interface CreateMonitorCommandOutput extends CreateMonitorOutput, __Metad
  *     "<keys>": "STRING_VALUE",
  *   },
  *   MaxCityNetworksToMonitor: Number("int"), // required
+ *   InternetMeasurementsLogDelivery: { // InternetMeasurementsLogDelivery
+ *     S3Config: { // S3Config
+ *       BucketName: "STRING_VALUE",
+ *       BucketPrefix: "STRING_VALUE",
+ *       LogDeliveryStatus: "STRING_VALUE",
+ *     },
+ *   },
  * };
  * const command = new CreateMonitorCommand(input);
  * const response = await client.send(command);

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

@@ -19,8 +19,11 @@ export interface UpdateMonitorCommandOutput extends UpdateMonitorOutput, __Metad
 }
 /**
  * @public
- * <p>Updates a monitor. You can update a monitor to add or remove resources, or to change the status of the monitor. You can't change the name of a
- * 			monitor.</p>
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -38,6 +41,13 @@ export interface UpdateMonitorCommandOutput extends UpdateMonitorOutput, __Metad
  *   Status: "STRING_VALUE",
  *   ClientToken: "STRING_VALUE",
  *   MaxCityNetworksToMonitor: Number("int"),
+ *   InternetMeasurementsLogDelivery: { // InternetMeasurementsLogDelivery
+ *     S3Config: { // S3Config
+ *       BucketName: "STRING_VALUE",
+ *       BucketPrefix: "STRING_VALUE",
+ *       LogDeliveryStatus: "STRING_VALUE",
+ *     },
+ *   },
  * };
  * const command = new UpdateMonitorCommand(input);
  * const response = await client.send(command);

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

@@ -20,28 +20,28 @@ export declare class AccessDeniedException extends __BaseException {
  * 			easier to see those drops, we report that information to you in the form of health scores: a performance score and an availability score.</p>
  *          <p>Availability in Internet Monitor represents the estimated percentage of traffic that is not seeing an availability drop. For example, an availability score of 99%
  * 			for an end user and service location pair is equivalent to 1% of the traffic experiencing an availability drop for that pair.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores"> How Internet Monitor calculates performance and availability
- * 				scores</a> in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores">How Internet Monitor calculates performance and availability
+ * 				scores</a> in the Amazon CloudWatch Internet Monitor section of the <i>Amazon CloudWatch User Guide</i>.</p>
  */
 export interface AvailabilityMeasurement {
     /**
      * <p>Experience scores, or health scores are calculated for different geographic and network provider combinations (that is, different granularities) and
      * 			also summed into global scores. If you view performance or availability scores without filtering for any specific geography or service provider, Amazon CloudWatch Internet Monitor
      * 			provides global health scores.</p>
-     *          <p>The Amazon CloudWatch Internet Monitor chapter in the CloudWatch User Guide includes detailed information about how Internet Monitor calculates health scores, including performance and
-     * 			availability scores, and when it creates and resolves health events. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores"> How Amazon Web Services calculates performance and
-     * 				availability scores</a> in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.</p>
+     *          <p>The Amazon CloudWatch Internet Monitor chapter in the <i>CloudWatch User Guide</i> includes detailed information about how Internet Monitor calculates health scores, including performance and
+     * 			availability scores, and when it creates and resolves health events. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores">How Amazon Web Services calculates performance and
+     * 				availability scores</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
     ExperienceScore?: number;
     /**
      * <p>The percentage of impact caused by a health event for total traffic globally.</p>
-     *          <p>For information about how Internet Monitor calculates impact, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html"> Inside Internet Monitor</a> in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User
+     *          <p>For information about how Internet Monitor calculates impact, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html">Inside Internet Monitor</a> in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User
      * 			Guide.</p>
      */
     PercentOfTotalTrafficImpacted?: number;
     /**
      * <p>The percentage of impact caused by a health event for client location traffic globally.</p>
-     *          <p>For information about how Internet Monitor calculates impact, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html"> Inside Internet Monitor</a> in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User
+     *          <p>For information about how Internet Monitor calculates impact, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html">Inside Internet Monitor</a> in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User
      * 			Guide.</p>
      */
     PercentOfClientLocationImpacted?: number;
@@ -70,6 +70,51 @@ export declare class ConflictException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const LogDeliveryStatus: {
+    readonly DISABLED: "DISABLED";
+    readonly ENABLED: "ENABLED";
+};
+/**
+ * @public
+ */
+export type LogDeliveryStatus = (typeof LogDeliveryStatus)[keyof typeof LogDeliveryStatus];
+/**
+ * @public
+ * <p>The configuration for publishing Amazon CloudWatch Internet Monitor internet measurements to Amazon S3. The configuration includes the bucket name and (optionally) prefix
+ * 			for the S3 bucket to store the measurements, and the delivery status. The delivery status is <code>ENABLED</code> or <code>DISABLED</code>, depending on
+ * 			whether you choose to deliver internet measurements to S3 logs.</p>
+ */
+export interface S3Config {
+    /**
+     * <p>The Amazon S3 bucket name.</p>
+     */
+    BucketName?: string;
+    /**
+     * <p>The Amazon S3 bucket prefix.</p>
+     */
+    BucketPrefix?: string;
+    /**
+     * <p>The status of publishing Internet Monitor internet measurements to an Amazon S3 bucket.</p>
+     */
+    LogDeliveryStatus?: LogDeliveryStatus | string;
+}
+/**
+ * @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>
+ */
+export interface InternetMeasurementsLogDelivery {
+    /**
+     * <p>The configuration information for publishing Internet Monitor internet measurements to Amazon S3. The configuration includes the bucket name and (optionally) prefix
+     * 			for the S3 bucket to store the measurements, and the delivery status. The delivery status is <code>ENABLED</code> or <code>DISABLED</code>, depending on
+     * 			whether you choose to deliver internet measurements to S3 logs.</p>
+     */
+    S3Config?: S3Config;
+}
 /**
  * @public
  */
@@ -97,10 +142,16 @@ export interface CreateMonitorInput {
      */
     Tags?: Record<string, string>;
     /**
-     * <p>The maximum number of city-network combinations (that is, combinations of a city location and network, such as an ISP) to be monitored
-     * 			for your resources.</p>
+     * <p>The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and
+     * 			the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.</p>
+     *          <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;
+    /**
+     * <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;
 }
 /**
  * @public
@@ -280,8 +331,8 @@ export interface RoundTripTime {
  * 			easier to see those drops, we report that information to you in the form of health scores: a performance score and an availability score.</p>
  *          <p>Performance in Internet Monitor represents the estimated percentage of traffic that is not seeing a performance drop. For example, a performance score of 99% for
  * 			an end user and service location pair is equivalent to 1% of the traffic experiencing a performance drop for that pair.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores"> How Internet Monitor calculates performance and availability
- * 				scores</a> in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores">How Internet Monitor calculates performance and availability
+ * 			scores</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
  */
 export interface PerformanceMeasurement {
     /**
@@ -289,28 +340,28 @@ export interface PerformanceMeasurement {
      * 			also totaled into global scores. If you view performance or availability scores without filtering for any specific geography or service provider, Amazon CloudWatch Internet Monitor
      * 			provides global health scores.</p>
      *          <p>The Amazon CloudWatch Internet Monitor chapter in the CloudWatch User Guide includes detailed information about how Internet Monitor calculates health scores, including performance and
-     * 			availability scores, and when it creates and resolves health events. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores"> How Amazon Web Services calculates performance and
-     * 				availability scores</a> in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.</p>
+     * 			availability scores, and when it creates and resolves health events. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores">How Amazon Web Services calculates performance and
+     * 				availability scores</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
     ExperienceScore?: number;
     /**
      * <p>How much performance impact was caused by a health event for total traffic globally. For performance, this is the percentage of how much latency
      * 			increased during the event compared to typical performance for your application traffic globally. </p>
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop"> When Amazon Web Services creates and resolves health
-     * 				events</a> in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop">When Amazon Web Services creates and resolves health
+     * 			events</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
     PercentOfTotalTrafficImpacted?: number;
     /**
      * <p>How much performance impact was caused by a health event at a client location. For performance, this is the percentage of how much latency increased
      * 			during the event compared to typical performance for traffic, from this client location to an Amazon Web Services location, using a specific client network. </p>
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop"> When Amazon Web Services creates and resolves health
-     * 				events</a> in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop">When Amazon Web Services creates and resolves health
+     * 			events</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
     PercentOfClientLocationImpacted?: number;
     /**
      * <p>This is the percentage of how much round-trip time increased during the event compared to typical round-trip time for your application for traffic. </p>
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop"> When Amazon Web Services creates and resolves health
-     * 				events</a> in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMHealthEventStartStop">When Amazon Web Services creates and resolves health
+     * 			events</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
     RoundTripTime?: RoundTripTime;
 }
@@ -326,15 +377,15 @@ export interface InternetHealth {
     /**
      * <p>Availability in Internet Monitor represents the estimated percentage of traffic that is not seeing an availability drop. For example, an availability score of 99%
      * 			for an end user and service location pair is equivalent to 1% of the traffic experiencing an availability drop for that pair.</p>
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores"> How Internet Monitor calculates performance and availability
-     * 				scores</a> in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores">How Internet Monitor calculates performance and availability
+     * 			scores</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
     Availability?: AvailabilityMeasurement;
     /**
      * <p>Performance in Internet Monitor represents the estimated percentage of traffic that is not seeing a performance drop. For example, a performance score of 99% for
      * 			an end user and service location pair is equivalent to 1% of the traffic experiencing a performance drop for that pair.</p>
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores"> How Internet Monitor calculates performance and availability
-     * 				scores</a> in the Amazon CloudWatch Internet Monitor section of the Amazon CloudWatch User Guide.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-inside-internet-monitor.html#IMExperienceScores">How Internet Monitor calculates performance and availability
+     * 			scores</a> in the Amazon CloudWatch Internet Monitor section of the <i>CloudWatch User Guide</i>.</p>
      */
     Performance?: PerformanceMeasurement;
 }
@@ -546,10 +597,16 @@ export interface GetMonitorOutput {
      */
     Tags?: Record<string, string>;
     /**
-     * <p>The maximum number of city-network combinations (that is, combinations of a city location and network, such as an ISP) to be monitored
-     * 			for your resources.</p>
+     * <p>The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and
+     * 			the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs.</p>
+     *          <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;
+    /**
+     * <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;
 }
 /**
  * @public
@@ -796,10 +853,15 @@ export interface UpdateMonitorInput {
      */
     ClientToken?: string;
     /**
-     * <p>The maximum number of city-network combinations (that is, combinations of a city location and network, such as an ISP) to be monitored
-     * 			for your resources.</p>
+     * <p>The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from
+     * 			and the network or ASN,
+     * 			such as an internet service provider, that clients access the resources through.</p>
      */
     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;
 }
 /**
  * @public

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

@@ -24,12 +24,27 @@ export declare class ConflictException extends __BaseException {
   readonly $fault: "client";
   constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
 }
+export declare const LogDeliveryStatus: {
+  readonly DISABLED: "DISABLED";
+  readonly ENABLED: "ENABLED";
+};
+export type LogDeliveryStatus =
+  (typeof LogDeliveryStatus)[keyof typeof LogDeliveryStatus];
+export interface S3Config {
+  BucketName?: string;
+  BucketPrefix?: string;
+  LogDeliveryStatus?: LogDeliveryStatus | string;
+}
+export interface InternetMeasurementsLogDelivery {
+  S3Config?: S3Config;
+}
 export interface CreateMonitorInput {
   MonitorName: string | undefined;
   Resources?: string[];
   ClientToken?: string;
   Tags?: Record<string, string>;
   MaxCityNetworksToMonitor: number | undefined;
+  InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
 }
 export declare const MonitorConfigState: {
   readonly ACTIVE: "ACTIVE";
@@ -177,6 +192,7 @@ export interface GetMonitorOutput {
   ProcessingStatusInfo?: string;
   Tags?: Record<string, string>;
   MaxCityNetworksToMonitor: number | undefined;
+  InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
 }
 export interface HealthEvent {
   EventArn: string | undefined;
@@ -260,6 +276,7 @@ export interface UpdateMonitorInput {
   Status?: MonitorConfigState | string;
   ClientToken?: string;
   MaxCityNetworksToMonitor?: number;
+  InternetMeasurementsLogDelivery?: InternetMeasurementsLogDelivery;
 }
 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.303.0",
+  "version": "3.304.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",