aws-sdk-internetmonitor 1.0.0 → 1.2.0

Sign up to get free protection for your applications and to get access to all the features.
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