aws-sdk-internetmonitor 1.0.0 → 1.2.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: ec79db6f139566947327de70f306b26516023e4e6a402559e300802f3591f3c8
4
- data.tar.gz: b16a053ae47f2e57a6786e58b3370e3551c12c3a8fbc335bff0d8a09a8a268fe
3
+ metadata.gz: e7ea1492a3cc1dafd274eba8d6e5a468c2116c7aef7698cb4571181b9e45d353
4
+ data.tar.gz: 44ad1747125596e48e9e513527ce3396315bcd6a038e05e1c383c8647ad06541
5
5
  SHA512:
6
- metadata.gz: 41f5d8df07e5149ef2cace7cbb4ec8ceaa32922668372bf9d36df60f0e1b570da3a59cf4ff63012de63356dc7c8ef2ac218e8df81e5ea021478da1cf0773751e
7
- data.tar.gz: 3ae389924675c2c5694c19c438fda38a18effc33988d9e482ba706da6a110575bda107bee2614265b3043c1469f98af20164fc589802222d07ef7fb727582c2e
6
+ metadata.gz: b3f871acf6cd9d6d5f4a67e7970d4da9ae2c539e83b082c75d315bd400c76fed48022276bd20c463d942ad0905e804111c2ef4df7c30c15602f6d524510f4b12
7
+ data.tar.gz: 6b343f3828f6458ee5ef608af0dcd4bd32f8dfa00f505bd731cc8d3a231526f4d1594f4344abd15f4b4eed40ef82034d7fe2b8ba9bcdda25300f60d28b53fea9
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.2.0 (2023-04-17)
5
+ ------------------
6
+
7
+ * Feature - This release includes a new configurable value, TrafficPercentageToMonitor, which allows users to adjust the amount of traffic monitored by percentage
8
+
9
+ 1.1.0 (2023-03-31)
10
+ ------------------
11
+
12
+ * Feature - This release adds a new feature for Amazon CloudWatch Internet Monitor that enables customers to deliver internet measurements to Amazon S3 buckets as well as CloudWatch Logs.
13
+
4
14
  1.0.0 (2023-02-27)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.0.0
1
+ 1.2.0
@@ -370,14 +370,26 @@ module Aws::InternetMonitor
370
370
 
371
371
  # Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is
372
372
  # built based on information from the application resources that you
373
- # add: Virtual Private Clouds (VPCs), Amazon CloudFront distributions,
374
- # and WorkSpaces directories.
373
+ # add: Amazon Virtual Private Clouds (VPCs), Amazon CloudFront
374
+ # distributions, and WorkSpaces directories. Internet Monitor then
375
+ # publishes internet measurements from Amazon Web Services that are
376
+ # specific to the *city-networks*, that is, the locations and ASNs
377
+ # (typically internet service providers or ISPs), where clients access
378
+ # your application. For more information, see [Using Amazon CloudWatch
379
+ # Internet Monitor][1] in the *Amazon CloudWatch User Guide*.
375
380
  #
376
- # After you create a monitor, you can view the internet performance for
377
- # your application, scoped to a location, as well as any health events
378
- # that are impairing traffic. Internet Monitor can also diagnose whether
379
- # the impairment is on the Amazon Web Services network or is an issue
380
- # with an internet service provider (ISP).
381
+ # When you create a monitor, you set a maximum limit for the number of
382
+ # city-networks where client traffic is monitored. The city-network
383
+ # maximum that you choose is the limit, but you only pay for the number
384
+ # of city-networks that are actually monitored. You can change the
385
+ # maximum at any time by updating your monitor. For more information,
386
+ # see [Choosing a city-network maximum value][2] in the *Amazon
387
+ # CloudWatch User Guide*.
388
+ #
389
+ #
390
+ #
391
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-InternetMonitor.html
392
+ # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html
381
393
  #
382
394
  # @option params [required, String] :monitor_name
383
395
  # The name of the monitor.
@@ -408,10 +420,28 @@ module Aws::InternetMonitor
408
420
  # The tags for a monitor. You can add a maximum of 50 tags in Internet
409
421
  # Monitor.
410
422
  #
411
- # @option params [required, Integer] :max_city_networks_to_monitor
412
- # The maximum number of city-network combinations (that is, combinations
413
- # of a city location and network, such as an ISP) to be monitored for
414
- # your resources.
423
+ # @option params [Integer] :max_city_networks_to_monitor
424
+ # The maximum number of city-networks to monitor for your resources. A
425
+ # city-network is the location (city) where clients access your
426
+ # application resources from and the network or ASN, such as an internet
427
+ # service provider (ISP), that clients access the resources through.
428
+ # This limit helps control billing costs.
429
+ #
430
+ # To learn more, see [Choosing a city-network maximum value ][1] in the
431
+ # Amazon CloudWatch Internet Monitor section of the *CloudWatch User
432
+ # Guide*.
433
+ #
434
+ #
435
+ #
436
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html
437
+ #
438
+ # @option params [Types::InternetMeasurementsLogDelivery] :internet_measurements_log_delivery
439
+ # Publish internet measurements for Internet Monitor to an Amazon S3
440
+ # bucket in addition to CloudWatch Logs.
441
+ #
442
+ # @option params [Integer] :traffic_percentage_to_monitor
443
+ # The percentage of the internet-facing traffic for your application
444
+ # that you want to monitor with this monitor.
415
445
  #
416
446
  # @return [Types::CreateMonitorOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
417
447
  #
@@ -427,7 +457,15 @@ module Aws::InternetMonitor
427
457
  # tags: {
428
458
  # "TagKey" => "TagValue",
429
459
  # },
430
- # max_city_networks_to_monitor: 1, # required
460
+ # max_city_networks_to_monitor: 1,
461
+ # internet_measurements_log_delivery: {
462
+ # s3_config: {
463
+ # bucket_name: "S3ConfigBucketNameString",
464
+ # bucket_prefix: "String",
465
+ # log_delivery_status: "ENABLED", # accepts ENABLED, DISABLED
466
+ # },
467
+ # },
468
+ # traffic_percentage_to_monitor: 1,
431
469
  # })
432
470
  #
433
471
  # @example Response structure
@@ -576,6 +614,8 @@ module Aws::InternetMonitor
576
614
  # * {Types::GetMonitorOutput#processing_status_info #processing_status_info} => String
577
615
  # * {Types::GetMonitorOutput#tags #tags} => Hash<String,String>
578
616
  # * {Types::GetMonitorOutput#max_city_networks_to_monitor #max_city_networks_to_monitor} => Integer
617
+ # * {Types::GetMonitorOutput#internet_measurements_log_delivery #internet_measurements_log_delivery} => Types::InternetMeasurementsLogDelivery
618
+ # * {Types::GetMonitorOutput#traffic_percentage_to_monitor #traffic_percentage_to_monitor} => Integer
579
619
  #
580
620
  # @example Request syntax with placeholder values
581
621
  #
@@ -597,6 +637,10 @@ module Aws::InternetMonitor
597
637
  # resp.tags #=> Hash
598
638
  # resp.tags["TagKey"] #=> String
599
639
  # resp.max_city_networks_to_monitor #=> Integer
640
+ # resp.internet_measurements_log_delivery.s3_config.bucket_name #=> String
641
+ # resp.internet_measurements_log_delivery.s3_config.bucket_prefix #=> String
642
+ # resp.internet_measurements_log_delivery.s3_config.log_delivery_status #=> String, one of "ENABLED", "DISABLED"
643
+ # resp.traffic_percentage_to_monitor #=> Integer
600
644
  #
601
645
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetMonitor AWS API Documentation
602
646
  #
@@ -854,9 +898,19 @@ module Aws::InternetMonitor
854
898
  req.send_request(options)
855
899
  end
856
900
 
857
- # Updates a monitor. You can update a monitor to add or remove
858
- # resources, or to change the status of the monitor. You can't change
859
- # the name of a monitor.
901
+ # Updates a monitor. You can update a monitor to change the maximum
902
+ # number of city-networks (locations and ASNs or internet service
903
+ # providers), to add or remove resources, or to change the status of the
904
+ # monitor. Note that you can't change the name of a monitor.
905
+ #
906
+ # The city-network maximum that you choose is the limit, but you only
907
+ # pay for the number of city-networks that are actually monitored. For
908
+ # more information, see [Choosing a city-network maximum value][1] in
909
+ # the *Amazon CloudWatch User Guide*.
910
+ #
911
+ #
912
+ #
913
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html
860
914
  #
861
915
  # @option params [required, String] :monitor_name
862
916
  # The name of the monitor.
@@ -893,9 +947,19 @@ module Aws::InternetMonitor
893
947
  # not need to pass this option.**
894
948
  #
895
949
  # @option params [Integer] :max_city_networks_to_monitor
896
- # The maximum number of city-network combinations (that is, combinations
897
- # of a city location and network, such as an ISP) to be monitored for
898
- # your resources.
950
+ # The maximum number of city-networks to monitor for your resources. A
951
+ # city-network is the location (city) where clients access your
952
+ # application resources from and the network or ASN, such as an internet
953
+ # service provider, that clients access the resources through.
954
+ #
955
+ # @option params [Types::InternetMeasurementsLogDelivery] :internet_measurements_log_delivery
956
+ # Publish internet measurements for Internet Monitor to another
957
+ # location, such as an Amazon S3 bucket. The measurements are also
958
+ # published to Amazon CloudWatch Logs.
959
+ #
960
+ # @option params [Integer] :traffic_percentage_to_monitor
961
+ # The percentage of the internet-facing traffic for your application
962
+ # that you want to monitor with this monitor.
899
963
  #
900
964
  # @return [Types::UpdateMonitorOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
901
965
  #
@@ -911,6 +975,14 @@ module Aws::InternetMonitor
911
975
  # status: "PENDING", # accepts PENDING, ACTIVE, INACTIVE, ERROR
912
976
  # client_token: "String",
913
977
  # max_city_networks_to_monitor: 1,
978
+ # internet_measurements_log_delivery: {
979
+ # s3_config: {
980
+ # bucket_name: "S3ConfigBucketNameString",
981
+ # bucket_prefix: "String",
982
+ # log_delivery_status: "ENABLED", # accepts ENABLED, DISABLED
983
+ # },
984
+ # },
985
+ # traffic_percentage_to_monitor: 1,
914
986
  # })
915
987
  #
916
988
  # @example Response structure
@@ -940,7 +1012,7 @@ module Aws::InternetMonitor
940
1012
  params: params,
941
1013
  config: config)
942
1014
  context[:gem_name] = 'aws-sdk-internetmonitor'
943
- context[:gem_version] = '1.0.0'
1015
+ context[:gem_version] = '1.2.0'
944
1016
  Seahorse::Client::Request.new(handlers, context)
945
1017
  end
946
1018
 
@@ -37,6 +37,7 @@ module Aws::InternetMonitor
37
37
  InternalServerErrorException = Shapes::StructureShape.new(name: 'InternalServerErrorException')
38
38
  InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
39
39
  InternetHealth = Shapes::StructureShape.new(name: 'InternetHealth')
40
+ InternetMeasurementsLogDelivery = Shapes::StructureShape.new(name: 'InternetMeasurementsLogDelivery')
40
41
  LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
41
42
  ListHealthEventsInput = Shapes::StructureShape.new(name: 'ListHealthEventsInput')
42
43
  ListHealthEventsOutput = Shapes::StructureShape.new(name: 'ListHealthEventsOutput')
@@ -44,6 +45,7 @@ module Aws::InternetMonitor
44
45
  ListMonitorsOutput = Shapes::StructureShape.new(name: 'ListMonitorsOutput')
45
46
  ListTagsForResourceInput = Shapes::StructureShape.new(name: 'ListTagsForResourceInput')
46
47
  ListTagsForResourceOutput = Shapes::StructureShape.new(name: 'ListTagsForResourceOutput')
48
+ LogDeliveryStatus = Shapes::StringShape.new(name: 'LogDeliveryStatus')
47
49
  Long = Shapes::IntegerShape.new(name: 'Long')
48
50
  MaxCityNetworksToMonitor = Shapes::IntegerShape.new(name: 'MaxCityNetworksToMonitor')
49
51
  MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
@@ -60,6 +62,8 @@ module Aws::InternetMonitor
60
62
  ResourceName = Shapes::StringShape.new(name: 'ResourceName')
61
63
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
62
64
  RoundTripTime = Shapes::StructureShape.new(name: 'RoundTripTime')
65
+ S3Config = Shapes::StructureShape.new(name: 'S3Config')
66
+ S3ConfigBucketNameString = Shapes::StringShape.new(name: 'S3ConfigBucketNameString')
63
67
  SetOfARNs = Shapes::ListShape.new(name: 'SetOfARNs')
64
68
  String = Shapes::StringShape.new(name: 'String')
65
69
  SyntheticTimestamp_date_time = Shapes::TimestampShape.new(name: 'SyntheticTimestamp_date_time', timestampFormat: "iso8601")
@@ -71,6 +75,7 @@ module Aws::InternetMonitor
71
75
  TagValue = Shapes::StringShape.new(name: 'TagValue')
72
76
  ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
73
77
  TooManyRequestsException = Shapes::StructureShape.new(name: 'TooManyRequestsException')
78
+ TrafficPercentageToMonitor = Shapes::IntegerShape.new(name: 'TrafficPercentageToMonitor')
74
79
  TriangulationEventType = Shapes::StringShape.new(name: 'TriangulationEventType')
75
80
  UntagResourceInput = Shapes::StructureShape.new(name: 'UntagResourceInput')
76
81
  UntagResourceOutput = Shapes::StructureShape.new(name: 'UntagResourceOutput')
@@ -96,7 +101,9 @@ module Aws::InternetMonitor
96
101
  CreateMonitorInput.add_member(:resources, Shapes::ShapeRef.new(shape: SetOfARNs, location_name: "Resources"))
97
102
  CreateMonitorInput.add_member(:client_token, Shapes::ShapeRef.new(shape: String, location_name: "ClientToken", metadata: {"idempotencyToken"=>true}))
98
103
  CreateMonitorInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
99
- CreateMonitorInput.add_member(:max_city_networks_to_monitor, Shapes::ShapeRef.new(shape: MaxCityNetworksToMonitor, required: true, location_name: "MaxCityNetworksToMonitor"))
104
+ CreateMonitorInput.add_member(:max_city_networks_to_monitor, Shapes::ShapeRef.new(shape: MaxCityNetworksToMonitor, location_name: "MaxCityNetworksToMonitor"))
105
+ CreateMonitorInput.add_member(:internet_measurements_log_delivery, Shapes::ShapeRef.new(shape: InternetMeasurementsLogDelivery, location_name: "InternetMeasurementsLogDelivery"))
106
+ CreateMonitorInput.add_member(:traffic_percentage_to_monitor, Shapes::ShapeRef.new(shape: TrafficPercentageToMonitor, location_name: "TrafficPercentageToMonitor"))
100
107
  CreateMonitorInput.struct_class = Types::CreateMonitorInput
101
108
 
102
109
  CreateMonitorOutput.add_member(:arn, Shapes::ShapeRef.new(shape: MonitorArn, required: true, location_name: "Arn"))
@@ -136,7 +143,9 @@ module Aws::InternetMonitor
136
143
  GetMonitorOutput.add_member(:processing_status, Shapes::ShapeRef.new(shape: MonitorProcessingStatusCode, location_name: "ProcessingStatus"))
137
144
  GetMonitorOutput.add_member(:processing_status_info, Shapes::ShapeRef.new(shape: String, location_name: "ProcessingStatusInfo"))
138
145
  GetMonitorOutput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
139
- GetMonitorOutput.add_member(:max_city_networks_to_monitor, Shapes::ShapeRef.new(shape: MaxCityNetworksToMonitor, required: true, location_name: "MaxCityNetworksToMonitor"))
146
+ GetMonitorOutput.add_member(:max_city_networks_to_monitor, Shapes::ShapeRef.new(shape: MaxCityNetworksToMonitor, location_name: "MaxCityNetworksToMonitor"))
147
+ GetMonitorOutput.add_member(:internet_measurements_log_delivery, Shapes::ShapeRef.new(shape: InternetMeasurementsLogDelivery, location_name: "InternetMeasurementsLogDelivery"))
148
+ GetMonitorOutput.add_member(:traffic_percentage_to_monitor, Shapes::ShapeRef.new(shape: TrafficPercentageToMonitor, location_name: "TrafficPercentageToMonitor"))
140
149
  GetMonitorOutput.struct_class = Types::GetMonitorOutput
141
150
 
142
151
  HealthEvent.add_member(:event_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "EventArn"))
@@ -181,6 +190,9 @@ module Aws::InternetMonitor
181
190
  InternetHealth.add_member(:performance, Shapes::ShapeRef.new(shape: PerformanceMeasurement, location_name: "Performance"))
182
191
  InternetHealth.struct_class = Types::InternetHealth
183
192
 
193
+ InternetMeasurementsLogDelivery.add_member(:s3_config, Shapes::ShapeRef.new(shape: S3Config, location_name: "S3Config"))
194
+ InternetMeasurementsLogDelivery.struct_class = Types::InternetMeasurementsLogDelivery
195
+
184
196
  LimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "message"))
185
197
  LimitExceededException.struct_class = Types::LimitExceededException
186
198
 
@@ -247,6 +259,11 @@ module Aws::InternetMonitor
247
259
  RoundTripTime.add_member(:p95, Shapes::ShapeRef.new(shape: Double, location_name: "P95"))
248
260
  RoundTripTime.struct_class = Types::RoundTripTime
249
261
 
262
+ S3Config.add_member(:bucket_name, Shapes::ShapeRef.new(shape: S3ConfigBucketNameString, location_name: "BucketName"))
263
+ S3Config.add_member(:bucket_prefix, Shapes::ShapeRef.new(shape: String, location_name: "BucketPrefix"))
264
+ S3Config.add_member(:log_delivery_status, Shapes::ShapeRef.new(shape: LogDeliveryStatus, location_name: "LogDeliveryStatus"))
265
+ S3Config.struct_class = Types::S3Config
266
+
250
267
  SetOfARNs.member = Shapes::ShapeRef.new(shape: Arn)
251
268
 
252
269
  TagKeys.member = Shapes::ShapeRef.new(shape: TagKey)
@@ -278,6 +295,8 @@ module Aws::InternetMonitor
278
295
  UpdateMonitorInput.add_member(:status, Shapes::ShapeRef.new(shape: MonitorConfigState, location_name: "Status"))
279
296
  UpdateMonitorInput.add_member(:client_token, Shapes::ShapeRef.new(shape: String, location_name: "ClientToken", metadata: {"idempotencyToken"=>true}))
280
297
  UpdateMonitorInput.add_member(:max_city_networks_to_monitor, Shapes::ShapeRef.new(shape: MaxCityNetworksToMonitor, location_name: "MaxCityNetworksToMonitor"))
298
+ UpdateMonitorInput.add_member(:internet_measurements_log_delivery, Shapes::ShapeRef.new(shape: InternetMeasurementsLogDelivery, location_name: "InternetMeasurementsLogDelivery"))
299
+ UpdateMonitorInput.add_member(:traffic_percentage_to_monitor, Shapes::ShapeRef.new(shape: TrafficPercentageToMonitor, location_name: "TrafficPercentageToMonitor"))
281
300
  UpdateMonitorInput.struct_class = Types::UpdateMonitorInput
282
301
 
283
302
  UpdateMonitorOutput.add_member(:monitor_arn, Shapes::ShapeRef.new(shape: MonitorArn, required: true, location_name: "MonitorArn"))
@@ -40,9 +40,9 @@ module Aws::InternetMonitor
40
40
  # equivalent to 1% of the traffic experiencing an availability drop for
41
41
  # that pair.
42
42
  #
43
- # For more information, see [ How Internet Monitor calculates
44
- # performance and availability scores][1] in the Amazon CloudWatch
45
- # Internet Monitor section of the Amazon CloudWatch User Guide.
43
+ # For more information, see [How Internet Monitor calculates performance
44
+ # and availability scores][1] in the Amazon CloudWatch Internet Monitor
45
+ # section of the *Amazon CloudWatch User Guide*.
46
46
  #
47
47
  #
48
48
  #
@@ -56,13 +56,13 @@ module Aws::InternetMonitor
56
56
  # specific geography or service provider, Amazon CloudWatch Internet
57
57
  # Monitor provides global health scores.
58
58
  #
59
- # The Amazon CloudWatch Internet Monitor chapter in the CloudWatch
60
- # User Guide includes detailed information about how Internet Monitor
59
+ # The Amazon CloudWatch Internet Monitor chapter in the *CloudWatch
60
+ # User Guide* includes detailed information about how Internet Monitor
61
61
  # calculates health scores, including performance and availability
62
62
  # scores, and when it creates and resolves health events. For more
63
- # information, see [ How Amazon Web Services calculates performance
64
- # and availability scores][1] in the Amazon CloudWatch Internet
65
- # Monitor section of the CloudWatch User Guide.
63
+ # information, see [How Amazon Web Services calculates performance and
64
+ # availability scores][1] in the Amazon CloudWatch Internet Monitor
65
+ # section of the *CloudWatch User Guide*.
66
66
  #
67
67
  #
68
68
  #
@@ -73,8 +73,8 @@ module Aws::InternetMonitor
73
73
  # The percentage of impact caused by a health event for total traffic
74
74
  # globally.
75
75
  #
76
- # For information about how Internet Monitor calculates impact, see [
77
- # Inside Internet Monitor][1] in the Amazon CloudWatch Internet
76
+ # For information about how Internet Monitor calculates impact, see
77
+ # [Inside Internet Monitor][1] in the Amazon CloudWatch Internet
78
78
  # Monitor section of the Amazon CloudWatch User Guide.
79
79
  #
80
80
  #
@@ -86,8 +86,8 @@ module Aws::InternetMonitor
86
86
  # The percentage of impact caused by a health event for client
87
87
  # location traffic globally.
88
88
  #
89
- # For information about how Internet Monitor calculates impact, see [
90
- # Inside Internet Monitor][1] in the Amazon CloudWatch Internet
89
+ # For information about how Internet Monitor calculates impact, see
90
+ # [Inside Internet Monitor][1] in the Amazon CloudWatch Internet
91
91
  # Monitor section of the Amazon CloudWatch User Guide.
92
92
  #
93
93
  #
@@ -165,9 +165,29 @@ module Aws::InternetMonitor
165
165
  # @return [Hash<String,String>]
166
166
  #
167
167
  # @!attribute [rw] max_city_networks_to_monitor
168
- # The maximum number of city-network combinations (that is,
169
- # combinations of a city location and network, such as an ISP) to be
170
- # monitored for your resources.
168
+ # The maximum number of city-networks to monitor for your resources. A
169
+ # city-network is the location (city) where clients access your
170
+ # application resources from and the network or ASN, such as an
171
+ # internet service provider (ISP), that clients access the resources
172
+ # through. This limit helps control billing costs.
173
+ #
174
+ # To learn more, see [Choosing a city-network maximum value ][1] in
175
+ # the Amazon CloudWatch Internet Monitor section of the *CloudWatch
176
+ # User Guide*.
177
+ #
178
+ #
179
+ #
180
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html
181
+ # @return [Integer]
182
+ #
183
+ # @!attribute [rw] internet_measurements_log_delivery
184
+ # Publish internet measurements for Internet Monitor to an Amazon S3
185
+ # bucket in addition to CloudWatch Logs.
186
+ # @return [Types::InternetMeasurementsLogDelivery]
187
+ #
188
+ # @!attribute [rw] traffic_percentage_to_monitor
189
+ # The percentage of the internet-facing traffic for your application
190
+ # that you want to monitor with this monitor.
171
191
  # @return [Integer]
172
192
  #
173
193
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/CreateMonitorInput AWS API Documentation
@@ -177,7 +197,9 @@ module Aws::InternetMonitor
177
197
  :resources,
178
198
  :client_token,
179
199
  :tags,
180
- :max_city_networks_to_monitor)
200
+ :max_city_networks_to_monitor,
201
+ :internet_measurements_log_delivery,
202
+ :traffic_percentage_to_monitor)
181
203
  SENSITIVE = []
182
204
  include Aws::Structure
183
205
  end
@@ -343,9 +365,30 @@ module Aws::InternetMonitor
343
365
  # @return [Hash<String,String>]
344
366
  #
345
367
  # @!attribute [rw] max_city_networks_to_monitor
346
- # The maximum number of city-network combinations (that is,
347
- # combinations of a city location and network, such as an ISP) to be
348
- # monitored for your resources.
368
+ # The maximum number of city-networks to monitor for your resources. A
369
+ # city-network is the location (city) where clients access your
370
+ # application resources from and the network or ASN, such as an
371
+ # internet service provider (ISP), that clients access the resources
372
+ # through. This limit helps control billing costs.
373
+ #
374
+ # To learn more, see [Choosing a city-network maximum value ][1] in
375
+ # the Amazon CloudWatch Internet Monitor section of the *CloudWatch
376
+ # User Guide*.
377
+ #
378
+ #
379
+ #
380
+ # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/IMCityNetworksMaximum.html
381
+ # @return [Integer]
382
+ #
383
+ # @!attribute [rw] internet_measurements_log_delivery
384
+ # Publish internet measurements for Internet Monitor to another
385
+ # location, such as an Amazon S3 bucket. The measurements are also
386
+ # published to Amazon CloudWatch Logs.
387
+ # @return [Types::InternetMeasurementsLogDelivery]
388
+ #
389
+ # @!attribute [rw] traffic_percentage_to_monitor
390
+ # The percentage of the internet-facing traffic for your application
391
+ # that you want to monitor with this monitor.
349
392
  # @return [Integer]
350
393
  #
351
394
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/GetMonitorOutput AWS API Documentation
@@ -360,7 +403,9 @@ module Aws::InternetMonitor
360
403
  :processing_status,
361
404
  :processing_status_info,
362
405
  :tags,
363
- :max_city_networks_to_monitor)
406
+ :max_city_networks_to_monitor,
407
+ :internet_measurements_log_delivery,
408
+ :traffic_percentage_to_monitor)
364
409
  SENSITIVE = []
365
410
  include Aws::Structure
366
411
  end
@@ -573,9 +618,9 @@ module Aws::InternetMonitor
573
618
  # is equivalent to 1% of the traffic experiencing an availability drop
574
619
  # for that pair.
575
620
  #
576
- # For more information, see [ How Internet Monitor calculates
621
+ # For more information, see [How Internet Monitor calculates
577
622
  # performance and availability scores][1] in the Amazon CloudWatch
578
- # Internet Monitor section of the Amazon CloudWatch User Guide.
623
+ # Internet Monitor section of the *CloudWatch User Guide*.
579
624
  #
580
625
  #
581
626
  #
@@ -589,9 +634,9 @@ module Aws::InternetMonitor
589
634
  # is equivalent to 1% of the traffic experiencing a performance drop
590
635
  # for that pair.
591
636
  #
592
- # For more information, see [ How Internet Monitor calculates
637
+ # For more information, see [How Internet Monitor calculates
593
638
  # performance and availability scores][1] in the Amazon CloudWatch
594
- # Internet Monitor section of the Amazon CloudWatch User Guide.
639
+ # Internet Monitor section of the *CloudWatch User Guide*.
595
640
  #
596
641
  #
597
642
  #
@@ -607,6 +652,26 @@ module Aws::InternetMonitor
607
652
  include Aws::Structure
608
653
  end
609
654
 
655
+ # Publish internet measurements to an Amazon S3 bucket in addition to
656
+ # CloudWatch Logs.
657
+ #
658
+ # @!attribute [rw] s3_config
659
+ # The configuration information for publishing Internet Monitor
660
+ # internet measurements to Amazon S3. The configuration includes the
661
+ # bucket name and (optionally) prefix for the S3 bucket to store the
662
+ # measurements, and the delivery status. The delivery status is
663
+ # `ENABLED` or `DISABLED`, depending on whether you choose to deliver
664
+ # internet measurements to S3 logs.
665
+ # @return [Types::S3Config]
666
+ #
667
+ # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/InternetMeasurementsLogDelivery AWS API Documentation
668
+ #
669
+ class InternetMeasurementsLogDelivery < Struct.new(
670
+ :s3_config)
671
+ SENSITIVE = []
672
+ include Aws::Structure
673
+ end
674
+
610
675
  # The request exceeded a service quota.
611
676
  #
612
677
  # @!attribute [rw] message
@@ -858,9 +923,9 @@ module Aws::InternetMonitor
858
923
  # equivalent to 1% of the traffic experiencing a performance drop for
859
924
  # that pair.
860
925
  #
861
- # For more information, see [ How Internet Monitor calculates
862
- # performance and availability scores][1] in the Amazon CloudWatch
863
- # Internet Monitor section of the Amazon CloudWatch User Guide.
926
+ # For more information, see [How Internet Monitor calculates performance
927
+ # and availability scores][1] in the Amazon CloudWatch Internet Monitor
928
+ # section of the *CloudWatch User Guide*.
864
929
  #
865
930
  #
866
931
  #
@@ -878,9 +943,9 @@ module Aws::InternetMonitor
878
943
  # User Guide includes detailed information about how Internet Monitor
879
944
  # calculates health scores, including performance and availability
880
945
  # scores, and when it creates and resolves health events. For more
881
- # information, see [ How Amazon Web Services calculates performance
882
- # and availability scores][1] in the Amazon CloudWatch Internet
883
- # Monitor section of the CloudWatch User Guide.
946
+ # information, see [How Amazon Web Services calculates performance and
947
+ # availability scores][1] in the Amazon CloudWatch Internet Monitor
948
+ # section of the *CloudWatch User Guide*.
884
949
  #
885
950
  #
886
951
  #
@@ -893,9 +958,9 @@ module Aws::InternetMonitor
893
958
  # much latency increased during the event compared to typical
894
959
  # performance for your application traffic globally.
895
960
  #
896
- # For more information, see [ When Amazon Web Services creates and
961
+ # For more information, see [When Amazon Web Services creates and
897
962
  # resolves health events][1] in the Amazon CloudWatch Internet Monitor
898
- # section of the CloudWatch User Guide.
963
+ # section of the *CloudWatch User Guide*.
899
964
  #
900
965
  #
901
966
  #
@@ -909,9 +974,9 @@ module Aws::InternetMonitor
909
974
  # for traffic, from this client location to an Amazon Web Services
910
975
  # location, using a specific client network.
911
976
  #
912
- # For more information, see [ When Amazon Web Services creates and
977
+ # For more information, see [When Amazon Web Services creates and
913
978
  # resolves health events][1] in the Amazon CloudWatch Internet Monitor
914
- # section of the CloudWatch User Guide.
979
+ # section of the *CloudWatch User Guide*.
915
980
  #
916
981
  #
917
982
  #
@@ -923,9 +988,9 @@ module Aws::InternetMonitor
923
988
  # the event compared to typical round-trip time for your application
924
989
  # for traffic.
925
990
  #
926
- # For more information, see [ When Amazon Web Services creates and
991
+ # For more information, see [When Amazon Web Services creates and
927
992
  # resolves health events][1] in the Amazon CloudWatch Internet Monitor
928
- # section of the CloudWatch User Guide.
993
+ # section of the *CloudWatch User Guide*.
929
994
  #
930
995
  #
931
996
  #
@@ -982,6 +1047,36 @@ module Aws::InternetMonitor
982
1047
  include Aws::Structure
983
1048
  end
984
1049
 
1050
+ # The configuration for publishing Amazon CloudWatch Internet Monitor
1051
+ # internet measurements to Amazon S3. The configuration includes the
1052
+ # bucket name and (optionally) prefix for the S3 bucket to store the
1053
+ # measurements, and the delivery status. The delivery status is
1054
+ # `ENABLED` or `DISABLED`, depending on whether you choose to deliver
1055
+ # internet measurements to S3 logs.
1056
+ #
1057
+ # @!attribute [rw] bucket_name
1058
+ # The Amazon S3 bucket name.
1059
+ # @return [String]
1060
+ #
1061
+ # @!attribute [rw] bucket_prefix
1062
+ # The Amazon S3 bucket prefix.
1063
+ # @return [String]
1064
+ #
1065
+ # @!attribute [rw] log_delivery_status
1066
+ # The status of publishing Internet Monitor internet measurements to
1067
+ # an Amazon S3 bucket.
1068
+ # @return [String]
1069
+ #
1070
+ # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/S3Config AWS API Documentation
1071
+ #
1072
+ class S3Config < Struct.new(
1073
+ :bucket_name,
1074
+ :bucket_prefix,
1075
+ :log_delivery_status)
1076
+ SENSITIVE = []
1077
+ include Aws::Structure
1078
+ end
1079
+
985
1080
  # @!attribute [rw] resource_arn
986
1081
  # The Amazon Resource Name (ARN) for a tag that you add to a resource.
987
1082
  # Tags are supported only for monitors in Amazon CloudWatch Internet
@@ -1093,9 +1188,22 @@ module Aws::InternetMonitor
1093
1188
  # @return [String]
1094
1189
  #
1095
1190
  # @!attribute [rw] max_city_networks_to_monitor
1096
- # The maximum number of city-network combinations (that is,
1097
- # combinations of a city location and network, such as an ISP) to be
1098
- # monitored for your resources.
1191
+ # The maximum number of city-networks to monitor for your resources. A
1192
+ # city-network is the location (city) where clients access your
1193
+ # application resources from and the network or ASN, such as an
1194
+ # internet service provider, that clients access the resources
1195
+ # through.
1196
+ # @return [Integer]
1197
+ #
1198
+ # @!attribute [rw] internet_measurements_log_delivery
1199
+ # Publish internet measurements for Internet Monitor to another
1200
+ # location, such as an Amazon S3 bucket. The measurements are also
1201
+ # published to Amazon CloudWatch Logs.
1202
+ # @return [Types::InternetMeasurementsLogDelivery]
1203
+ #
1204
+ # @!attribute [rw] traffic_percentage_to_monitor
1205
+ # The percentage of the internet-facing traffic for your application
1206
+ # that you want to monitor with this monitor.
1099
1207
  # @return [Integer]
1100
1208
  #
1101
1209
  # @see http://docs.aws.amazon.com/goto/WebAPI/internetmonitor-2021-06-03/UpdateMonitorInput AWS API Documentation
@@ -1106,7 +1214,9 @@ module Aws::InternetMonitor
1106
1214
  :resources_to_remove,
1107
1215
  :status,
1108
1216
  :client_token,
1109
- :max_city_networks_to_monitor)
1217
+ :max_city_networks_to_monitor,
1218
+ :internet_measurements_log_delivery,
1219
+ :traffic_percentage_to_monitor)
1110
1220
  SENSITIVE = []
1111
1221
  include Aws::Structure
1112
1222
  end
@@ -53,6 +53,6 @@ require_relative 'aws-sdk-internetmonitor/customizations'
53
53
  # @!group service
54
54
  module Aws::InternetMonitor
55
55
 
56
- GEM_VERSION = '1.0.0'
56
+ GEM_VERSION = '1.2.0'
57
57
 
58
58
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-internetmonitor
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.0
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-02-27 00:00:00.000000000 Z
11
+ date: 2023-04-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core