aws-sdk-shield 1.32.0 → 1.33.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 +4 -4
- data/lib/aws-sdk-shield.rb +1 -1
- data/lib/aws-sdk-shield/client.rb +353 -16
- data/lib/aws-sdk-shield/client_api.rb +231 -0
- data/lib/aws-sdk-shield/errors.rb +20 -0
- data/lib/aws-sdk-shield/types.rb +643 -35
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 8f2f1aede9b84afb04b5a0cf3fe2fdfcadb33a645ac08f16fac40b804976fc99
|
4
|
+
data.tar.gz: cc7e4a635df1aaf215b9237cd5f0b4021f28d6872c940ba53def40499409fa56
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 99f73b39a7ad9cc9ac2d288ebe621a83b325c77f00d4595fffd2b76aa24b6a1d18ceaf8318dbd4f0e60990bcda9936ee70e26772b082ac659239106f79255536
|
7
|
+
data.tar.gz: cab6f0f3ce52fca237b02f2dde6c7dd6b9859bb06e3ec4c239bb5e4916233605b8dd80bae83887f48e7eeeabd62cfc83296a40dda59ac77c97f992fdfff5598d
|
data/lib/aws-sdk-shield.rb
CHANGED
@@ -607,6 +607,71 @@ module Aws::Shield
|
|
607
607
|
req.send_request(options)
|
608
608
|
end
|
609
609
|
|
610
|
+
# Creates a grouping of protected resources so they can be handled as a
|
611
|
+
# collective. This resource grouping improves the accuracy of detection
|
612
|
+
# and reduces false positives.
|
613
|
+
#
|
614
|
+
# @option params [required, String] :protection_group_id
|
615
|
+
# The name of the protection group. You use this to identify the
|
616
|
+
# protection group in lists and to manage the protection group, for
|
617
|
+
# example to update, delete, or describe it.
|
618
|
+
#
|
619
|
+
# @option params [required, String] :aggregation
|
620
|
+
# Defines how AWS Shield combines resource data for the group in order
|
621
|
+
# to detect, mitigate, and report events.
|
622
|
+
#
|
623
|
+
# * Sum - Use the total traffic across the group. This is a good choice
|
624
|
+
# for most cases. Examples include Elastic IP addresses for EC2
|
625
|
+
# instances that scale manually or automatically.
|
626
|
+
#
|
627
|
+
# * Mean - Use the average of the traffic across the group. This is a
|
628
|
+
# good choice for resources that share traffic uniformly. Examples
|
629
|
+
# include accelerators and load balancers.
|
630
|
+
#
|
631
|
+
# * Max - Use the highest traffic from each resource. This is useful for
|
632
|
+
# resources that don't share traffic and for resources that share
|
633
|
+
# that traffic in a non-uniform way. Examples include CloudFront
|
634
|
+
# distributions and origin resources for CloudFront distributions.
|
635
|
+
#
|
636
|
+
# @option params [required, String] :pattern
|
637
|
+
# The criteria to use to choose the protected resources for inclusion in
|
638
|
+
# the group. You can include all resources that have protections,
|
639
|
+
# provide a list of resource Amazon Resource Names (ARNs), or include
|
640
|
+
# all resources of a specified resource type.
|
641
|
+
#
|
642
|
+
# @option params [String] :resource_type
|
643
|
+
# The resource type to include in the protection group. All protected
|
644
|
+
# resources of this type are included in the protection group. Newly
|
645
|
+
# protected resources of this type are automatically added to the group.
|
646
|
+
# You must set this when you set `Pattern` to `BY_RESOURCE_TYPE` and you
|
647
|
+
# must not set it for any other `Pattern` setting.
|
648
|
+
#
|
649
|
+
# @option params [Array<String>] :members
|
650
|
+
# The Amazon Resource Names (ARNs) of the resources to include in the
|
651
|
+
# protection group. You must set this when you set `Pattern` to
|
652
|
+
# `ARBITRARY` and you must not set it for any other `Pattern` setting.
|
653
|
+
#
|
654
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
655
|
+
#
|
656
|
+
# @example Request syntax with placeholder values
|
657
|
+
#
|
658
|
+
# resp = client.create_protection_group({
|
659
|
+
# protection_group_id: "ProtectionGroupId", # required
|
660
|
+
# aggregation: "SUM", # required, accepts SUM, MEAN, MAX
|
661
|
+
# pattern: "ALL", # required, accepts ALL, ARBITRARY, BY_RESOURCE_TYPE
|
662
|
+
# resource_type: "CLOUDFRONT_DISTRIBUTION", # accepts CLOUDFRONT_DISTRIBUTION, ROUTE_53_HOSTED_ZONE, ELASTIC_IP_ALLOCATION, CLASSIC_LOAD_BALANCER, APPLICATION_LOAD_BALANCER, GLOBAL_ACCELERATOR
|
663
|
+
# members: ["ResourceArn"],
|
664
|
+
# })
|
665
|
+
#
|
666
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/CreateProtectionGroup AWS API Documentation
|
667
|
+
#
|
668
|
+
# @overload create_protection_group(params = {})
|
669
|
+
# @param [Hash] params ({})
|
670
|
+
def create_protection_group(params = {}, options = {})
|
671
|
+
req = build_request(:create_protection_group, params)
|
672
|
+
req.send_request(options)
|
673
|
+
end
|
674
|
+
|
610
675
|
# Activates AWS Shield Advanced for an account.
|
611
676
|
#
|
612
677
|
# When you initally create a subscription, your subscription is set to
|
@@ -647,6 +712,30 @@ module Aws::Shield
|
|
647
712
|
req.send_request(options)
|
648
713
|
end
|
649
714
|
|
715
|
+
# Removes the specified protection group.
|
716
|
+
#
|
717
|
+
# @option params [required, String] :protection_group_id
|
718
|
+
# The name of the protection group. You use this to identify the
|
719
|
+
# protection group in lists and to manage the protection group, for
|
720
|
+
# example to update, delete, or describe it.
|
721
|
+
#
|
722
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
723
|
+
#
|
724
|
+
# @example Request syntax with placeholder values
|
725
|
+
#
|
726
|
+
# resp = client.delete_protection_group({
|
727
|
+
# protection_group_id: "ProtectionGroupId", # required
|
728
|
+
# })
|
729
|
+
#
|
730
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DeleteProtectionGroup AWS API Documentation
|
731
|
+
#
|
732
|
+
# @overload delete_protection_group(params = {})
|
733
|
+
# @param [Hash] params ({})
|
734
|
+
def delete_protection_group(params = {}, options = {})
|
735
|
+
req = build_request(:delete_protection_group, params)
|
736
|
+
req.send_request(options)
|
737
|
+
end
|
738
|
+
|
650
739
|
# Removes AWS Shield Advanced from an account. AWS Shield Advanced
|
651
740
|
# requires a 1-year subscription commitment. You cannot delete a
|
652
741
|
# subscription prior to the completion of that commitment.
|
@@ -729,6 +818,45 @@ module Aws::Shield
|
|
729
818
|
req.send_request(options)
|
730
819
|
end
|
731
820
|
|
821
|
+
# Provides information about the number and type of attacks AWS Shield
|
822
|
+
# has detected in the last year for all resources that belong to your
|
823
|
+
# account, regardless of whether you've defined Shield protections for
|
824
|
+
# them. This operation is available to Shield customers as well as to
|
825
|
+
# Shield Advanced customers.
|
826
|
+
#
|
827
|
+
# The operation returns data for the time range of midnight UTC, one
|
828
|
+
# year ago, to midnight UTC, today. For example, if the current time is
|
829
|
+
# `2020-10-26 15:39:32 PDT`, equal to `2020-10-26 22:39:32 UTC`, then
|
830
|
+
# the time range for the attack data returned is from `2019-10-26
|
831
|
+
# 00:00:00 UTC` to `2020-10-26 00:00:00 UTC`.
|
832
|
+
#
|
833
|
+
# The time range indicates the period covered by the attack statistics
|
834
|
+
# data items.
|
835
|
+
#
|
836
|
+
# @return [Types::DescribeAttackStatisticsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
837
|
+
#
|
838
|
+
# * {Types::DescribeAttackStatisticsResponse#time_range #time_range} => Types::TimeRange
|
839
|
+
# * {Types::DescribeAttackStatisticsResponse#data_items #data_items} => Array<Types::AttackStatisticsDataItem>
|
840
|
+
#
|
841
|
+
# @example Response structure
|
842
|
+
#
|
843
|
+
# resp.time_range.from_inclusive #=> Time
|
844
|
+
# resp.time_range.to_exclusive #=> Time
|
845
|
+
# resp.data_items #=> Array
|
846
|
+
# resp.data_items[0].attack_volume.bits_per_second.max #=> Float
|
847
|
+
# resp.data_items[0].attack_volume.packets_per_second.max #=> Float
|
848
|
+
# resp.data_items[0].attack_volume.requests_per_second.max #=> Float
|
849
|
+
# resp.data_items[0].attack_count #=> Integer
|
850
|
+
#
|
851
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeAttackStatistics AWS API Documentation
|
852
|
+
#
|
853
|
+
# @overload describe_attack_statistics(params = {})
|
854
|
+
# @param [Hash] params ({})
|
855
|
+
def describe_attack_statistics(params = {}, options = {})
|
856
|
+
req = build_request(:describe_attack_statistics, params)
|
857
|
+
req.send_request(options)
|
858
|
+
end
|
859
|
+
|
732
860
|
# Returns the current role and list of Amazon S3 log buckets used by the
|
733
861
|
# DDoS Response Team (DRT) to access your AWS account while assisting
|
734
862
|
# with attack mitigation.
|
@@ -819,6 +947,41 @@ module Aws::Shield
|
|
819
947
|
req.send_request(options)
|
820
948
|
end
|
821
949
|
|
950
|
+
# Returns the specification for the specified protection group.
|
951
|
+
#
|
952
|
+
# @option params [required, String] :protection_group_id
|
953
|
+
# The name of the protection group. You use this to identify the
|
954
|
+
# protection group in lists and to manage the protection group, for
|
955
|
+
# example to update, delete, or describe it.
|
956
|
+
#
|
957
|
+
# @return [Types::DescribeProtectionGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
958
|
+
#
|
959
|
+
# * {Types::DescribeProtectionGroupResponse#protection_group #protection_group} => Types::ProtectionGroup
|
960
|
+
#
|
961
|
+
# @example Request syntax with placeholder values
|
962
|
+
#
|
963
|
+
# resp = client.describe_protection_group({
|
964
|
+
# protection_group_id: "ProtectionGroupId", # required
|
965
|
+
# })
|
966
|
+
#
|
967
|
+
# @example Response structure
|
968
|
+
#
|
969
|
+
# resp.protection_group.protection_group_id #=> String
|
970
|
+
# resp.protection_group.aggregation #=> String, one of "SUM", "MEAN", "MAX"
|
971
|
+
# resp.protection_group.pattern #=> String, one of "ALL", "ARBITRARY", "BY_RESOURCE_TYPE"
|
972
|
+
# resp.protection_group.resource_type #=> String, one of "CLOUDFRONT_DISTRIBUTION", "ROUTE_53_HOSTED_ZONE", "ELASTIC_IP_ALLOCATION", "CLASSIC_LOAD_BALANCER", "APPLICATION_LOAD_BALANCER", "GLOBAL_ACCELERATOR"
|
973
|
+
# resp.protection_group.members #=> Array
|
974
|
+
# resp.protection_group.members[0] #=> String
|
975
|
+
#
|
976
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeProtectionGroup AWS API Documentation
|
977
|
+
#
|
978
|
+
# @overload describe_protection_group(params = {})
|
979
|
+
# @param [Hash] params ({})
|
980
|
+
def describe_protection_group(params = {}, options = {})
|
981
|
+
req = build_request(:describe_protection_group, params)
|
982
|
+
req.send_request(options)
|
983
|
+
end
|
984
|
+
|
822
985
|
# Provides details about the AWS Shield Advanced subscription for an
|
823
986
|
# account.
|
824
987
|
#
|
@@ -836,6 +999,11 @@ module Aws::Shield
|
|
836
999
|
# resp.subscription.limits[0].type #=> String
|
837
1000
|
# resp.subscription.limits[0].max #=> Integer
|
838
1001
|
# resp.subscription.proactive_engagement_status #=> String, one of "ENABLED", "DISABLED", "PENDING"
|
1002
|
+
# resp.subscription.subscription_limits.protection_limits.protected_resource_type_limits #=> Array
|
1003
|
+
# resp.subscription.subscription_limits.protection_limits.protected_resource_type_limits[0].type #=> String
|
1004
|
+
# resp.subscription.subscription_limits.protection_limits.protected_resource_type_limits[0].max #=> Integer
|
1005
|
+
# resp.subscription.subscription_limits.protection_group_limits.max_protection_groups #=> Integer
|
1006
|
+
# resp.subscription.subscription_limits.protection_group_limits.pattern_type_limits.arbitrary_pattern_limits.max_members #=> Integer
|
839
1007
|
#
|
840
1008
|
# @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeSubscription AWS API Documentation
|
841
1009
|
#
|
@@ -1028,15 +1196,15 @@ module Aws::Shield
|
|
1028
1196
|
# `ListAttacksRequest`. Pass null if this is the first call.
|
1029
1197
|
#
|
1030
1198
|
# @option params [Integer] :max_results
|
1031
|
-
# The maximum number of AttackSummary objects to
|
1032
|
-
#
|
1199
|
+
# The maximum number of AttackSummary objects to return. If you leave
|
1200
|
+
# this blank, Shield Advanced returns the first 20 results.
|
1033
1201
|
#
|
1034
|
-
# This is a maximum value
|
1035
|
-
#
|
1036
|
-
#
|
1037
|
-
#
|
1038
|
-
#
|
1039
|
-
#
|
1202
|
+
# This is a maximum value. Shield Advanced might return the results in
|
1203
|
+
# smaller batches. That is, the number of objects returned could be less
|
1204
|
+
# than `MaxResults`, even if there are still more objects yet to return.
|
1205
|
+
# If there are more objects to return, Shield Advanced returns a value
|
1206
|
+
# in `NextToken` that you can use in your next request, to get the next
|
1207
|
+
# batch of objects.
|
1040
1208
|
#
|
1041
1209
|
# @return [Types::ListAttacksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1042
1210
|
#
|
@@ -1081,6 +1249,57 @@ module Aws::Shield
|
|
1081
1249
|
req.send_request(options)
|
1082
1250
|
end
|
1083
1251
|
|
1252
|
+
# Retrieves the ProtectionGroup objects for the account.
|
1253
|
+
#
|
1254
|
+
# @option params [String] :next_token
|
1255
|
+
# The next token value from a previous call to `ListProtectionGroups`.
|
1256
|
+
# Pass null if this is the first call.
|
1257
|
+
#
|
1258
|
+
# @option params [Integer] :max_results
|
1259
|
+
# The maximum number of ProtectionGroup objects to return. If you leave
|
1260
|
+
# this blank, Shield Advanced returns the first 20 results.
|
1261
|
+
#
|
1262
|
+
# This is a maximum value. Shield Advanced might return the results in
|
1263
|
+
# smaller batches. That is, the number of objects returned could be less
|
1264
|
+
# than `MaxResults`, even if there are still more objects yet to return.
|
1265
|
+
# If there are more objects to return, Shield Advanced returns a value
|
1266
|
+
# in `NextToken` that you can use in your next request, to get the next
|
1267
|
+
# batch of objects.
|
1268
|
+
#
|
1269
|
+
# @return [Types::ListProtectionGroupsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1270
|
+
#
|
1271
|
+
# * {Types::ListProtectionGroupsResponse#protection_groups #protection_groups} => Array<Types::ProtectionGroup>
|
1272
|
+
# * {Types::ListProtectionGroupsResponse#next_token #next_token} => String
|
1273
|
+
#
|
1274
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1275
|
+
#
|
1276
|
+
# @example Request syntax with placeholder values
|
1277
|
+
#
|
1278
|
+
# resp = client.list_protection_groups({
|
1279
|
+
# next_token: "Token",
|
1280
|
+
# max_results: 1,
|
1281
|
+
# })
|
1282
|
+
#
|
1283
|
+
# @example Response structure
|
1284
|
+
#
|
1285
|
+
# resp.protection_groups #=> Array
|
1286
|
+
# resp.protection_groups[0].protection_group_id #=> String
|
1287
|
+
# resp.protection_groups[0].aggregation #=> String, one of "SUM", "MEAN", "MAX"
|
1288
|
+
# resp.protection_groups[0].pattern #=> String, one of "ALL", "ARBITRARY", "BY_RESOURCE_TYPE"
|
1289
|
+
# resp.protection_groups[0].resource_type #=> String, one of "CLOUDFRONT_DISTRIBUTION", "ROUTE_53_HOSTED_ZONE", "ELASTIC_IP_ALLOCATION", "CLASSIC_LOAD_BALANCER", "APPLICATION_LOAD_BALANCER", "GLOBAL_ACCELERATOR"
|
1290
|
+
# resp.protection_groups[0].members #=> Array
|
1291
|
+
# resp.protection_groups[0].members[0] #=> String
|
1292
|
+
# resp.next_token #=> String
|
1293
|
+
#
|
1294
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/ListProtectionGroups AWS API Documentation
|
1295
|
+
#
|
1296
|
+
# @overload list_protection_groups(params = {})
|
1297
|
+
# @param [Hash] params ({})
|
1298
|
+
def list_protection_groups(params = {}, options = {})
|
1299
|
+
req = build_request(:list_protection_groups, params)
|
1300
|
+
req.send_request(options)
|
1301
|
+
end
|
1302
|
+
|
1084
1303
|
# Lists all Protection objects for the account.
|
1085
1304
|
#
|
1086
1305
|
# @option params [String] :next_token
|
@@ -1088,14 +1307,15 @@ module Aws::Shield
|
|
1088
1307
|
# `ListProtections`. Pass null if this is the first call.
|
1089
1308
|
#
|
1090
1309
|
# @option params [Integer] :max_results
|
1091
|
-
# The maximum number of Protection objects to
|
1092
|
-
#
|
1310
|
+
# The maximum number of Protection objects to return. If you leave this
|
1311
|
+
# blank, Shield Advanced returns the first 20 results.
|
1093
1312
|
#
|
1094
|
-
# This is a maximum value
|
1095
|
-
#
|
1096
|
-
#
|
1097
|
-
#
|
1098
|
-
#
|
1313
|
+
# This is a maximum value. Shield Advanced might return the results in
|
1314
|
+
# smaller batches. That is, the number of objects returned could be less
|
1315
|
+
# than `MaxResults`, even if there are still more objects yet to return.
|
1316
|
+
# If there are more objects to return, Shield Advanced returns a value
|
1317
|
+
# in `NextToken` that you can use in your next request, to get the next
|
1318
|
+
# batch of objects.
|
1099
1319
|
#
|
1100
1320
|
# @return [Types::ListProtectionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1101
1321
|
#
|
@@ -1130,6 +1350,58 @@ module Aws::Shield
|
|
1130
1350
|
req.send_request(options)
|
1131
1351
|
end
|
1132
1352
|
|
1353
|
+
# Retrieves the resources that are included in the protection group.
|
1354
|
+
#
|
1355
|
+
# @option params [required, String] :protection_group_id
|
1356
|
+
# The name of the protection group. You use this to identify the
|
1357
|
+
# protection group in lists and to manage the protection group, for
|
1358
|
+
# example to update, delete, or describe it.
|
1359
|
+
#
|
1360
|
+
# @option params [String] :next_token
|
1361
|
+
# The next token value from a previous call to
|
1362
|
+
# `ListResourcesInProtectionGroup`. Pass null if this is the first call.
|
1363
|
+
#
|
1364
|
+
# @option params [Integer] :max_results
|
1365
|
+
# The maximum number of resource ARN objects to return. If you leave
|
1366
|
+
# this blank, Shield Advanced returns the first 20 results.
|
1367
|
+
#
|
1368
|
+
# This is a maximum value. Shield Advanced might return the results in
|
1369
|
+
# smaller batches. That is, the number of objects returned could be less
|
1370
|
+
# than `MaxResults`, even if there are still more objects yet to return.
|
1371
|
+
# If there are more objects to return, Shield Advanced returns a value
|
1372
|
+
# in `NextToken` that you can use in your next request, to get the next
|
1373
|
+
# batch of objects.
|
1374
|
+
#
|
1375
|
+
# @return [Types::ListResourcesInProtectionGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1376
|
+
#
|
1377
|
+
# * {Types::ListResourcesInProtectionGroupResponse#resource_arns #resource_arns} => Array<String>
|
1378
|
+
# * {Types::ListResourcesInProtectionGroupResponse#next_token #next_token} => String
|
1379
|
+
#
|
1380
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1381
|
+
#
|
1382
|
+
# @example Request syntax with placeholder values
|
1383
|
+
#
|
1384
|
+
# resp = client.list_resources_in_protection_group({
|
1385
|
+
# protection_group_id: "ProtectionGroupId", # required
|
1386
|
+
# next_token: "Token",
|
1387
|
+
# max_results: 1,
|
1388
|
+
# })
|
1389
|
+
#
|
1390
|
+
# @example Response structure
|
1391
|
+
#
|
1392
|
+
# resp.resource_arns #=> Array
|
1393
|
+
# resp.resource_arns[0] #=> String
|
1394
|
+
# resp.next_token #=> String
|
1395
|
+
#
|
1396
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/ListResourcesInProtectionGroup AWS API Documentation
|
1397
|
+
#
|
1398
|
+
# @overload list_resources_in_protection_group(params = {})
|
1399
|
+
# @param [Hash] params ({})
|
1400
|
+
def list_resources_in_protection_group(params = {}, options = {})
|
1401
|
+
req = build_request(:list_resources_in_protection_group, params)
|
1402
|
+
req.send_request(options)
|
1403
|
+
end
|
1404
|
+
|
1133
1405
|
# Updates the details of the list of email addresses and phone numbers
|
1134
1406
|
# that the DDoS Response Team (DRT) can use to contact you if you have
|
1135
1407
|
# proactive engagement enabled, for escalations to the DRT and to
|
@@ -1167,6 +1439,71 @@ module Aws::Shield
|
|
1167
1439
|
req.send_request(options)
|
1168
1440
|
end
|
1169
1441
|
|
1442
|
+
# Updates an existing protection group. A protection group is a grouping
|
1443
|
+
# of protected resources so they can be handled as a collective. This
|
1444
|
+
# resource grouping improves the accuracy of detection and reduces false
|
1445
|
+
# positives.
|
1446
|
+
#
|
1447
|
+
# @option params [required, String] :protection_group_id
|
1448
|
+
# The name of the protection group. You use this to identify the
|
1449
|
+
# protection group in lists and to manage the protection group, for
|
1450
|
+
# example to update, delete, or describe it.
|
1451
|
+
#
|
1452
|
+
# @option params [required, String] :aggregation
|
1453
|
+
# Defines how AWS Shield combines resource data for the group in order
|
1454
|
+
# to detect, mitigate, and report events.
|
1455
|
+
#
|
1456
|
+
# * Sum - Use the total traffic across the group. This is a good choice
|
1457
|
+
# for most cases. Examples include Elastic IP addresses for EC2
|
1458
|
+
# instances that scale manually or automatically.
|
1459
|
+
#
|
1460
|
+
# * Mean - Use the average of the traffic across the group. This is a
|
1461
|
+
# good choice for resources that share traffic uniformly. Examples
|
1462
|
+
# include accelerators and load balancers.
|
1463
|
+
#
|
1464
|
+
# * Max - Use the highest traffic from each resource. This is useful for
|
1465
|
+
# resources that don't share traffic and for resources that share
|
1466
|
+
# that traffic in a non-uniform way. Examples include CloudFront
|
1467
|
+
# distributions and origin resources for CloudFront distributions.
|
1468
|
+
#
|
1469
|
+
# @option params [required, String] :pattern
|
1470
|
+
# The criteria to use to choose the protected resources for inclusion in
|
1471
|
+
# the group. You can include all resources that have protections,
|
1472
|
+
# provide a list of resource Amazon Resource Names (ARNs), or include
|
1473
|
+
# all resources of a specified resource type.
|
1474
|
+
#
|
1475
|
+
# @option params [String] :resource_type
|
1476
|
+
# The resource type to include in the protection group. All protected
|
1477
|
+
# resources of this type are included in the protection group. You must
|
1478
|
+
# set this when you set `Pattern` to `BY_RESOURCE_TYPE` and you must not
|
1479
|
+
# set it for any other `Pattern` setting.
|
1480
|
+
#
|
1481
|
+
# @option params [Array<String>] :members
|
1482
|
+
# The Amazon Resource Names (ARNs) of the resources to include in the
|
1483
|
+
# protection group. You must set this when you set `Pattern` to
|
1484
|
+
# `ARBITRARY` and you must not set it for any other `Pattern` setting.
|
1485
|
+
#
|
1486
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1487
|
+
#
|
1488
|
+
# @example Request syntax with placeholder values
|
1489
|
+
#
|
1490
|
+
# resp = client.update_protection_group({
|
1491
|
+
# protection_group_id: "ProtectionGroupId", # required
|
1492
|
+
# aggregation: "SUM", # required, accepts SUM, MEAN, MAX
|
1493
|
+
# pattern: "ALL", # required, accepts ALL, ARBITRARY, BY_RESOURCE_TYPE
|
1494
|
+
# resource_type: "CLOUDFRONT_DISTRIBUTION", # accepts CLOUDFRONT_DISTRIBUTION, ROUTE_53_HOSTED_ZONE, ELASTIC_IP_ALLOCATION, CLASSIC_LOAD_BALANCER, APPLICATION_LOAD_BALANCER, GLOBAL_ACCELERATOR
|
1495
|
+
# members: ["ResourceArn"],
|
1496
|
+
# })
|
1497
|
+
#
|
1498
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/UpdateProtectionGroup AWS API Documentation
|
1499
|
+
#
|
1500
|
+
# @overload update_protection_group(params = {})
|
1501
|
+
# @param [Hash] params ({})
|
1502
|
+
def update_protection_group(params = {}, options = {})
|
1503
|
+
req = build_request(:update_protection_group, params)
|
1504
|
+
req.send_request(options)
|
1505
|
+
end
|
1506
|
+
|
1170
1507
|
# Updates the details of an existing subscription. Only enter values for
|
1171
1508
|
# parameters you want to change. Empty parameters are not updated.
|
1172
1509
|
#
|
@@ -1208,7 +1545,7 @@ module Aws::Shield
|
|
1208
1545
|
params: params,
|
1209
1546
|
config: config)
|
1210
1547
|
context[:gem_name] = 'aws-sdk-shield'
|
1211
|
-
context[:gem_version] = '1.
|
1548
|
+
context[:gem_version] = '1.33.0'
|
1212
1549
|
Seahorse::Client::Request.new(handlers, context)
|
1213
1550
|
end
|
1214
1551
|
|