aws-sdk-resourcegroups 1.71.0 → 1.73.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -36,8 +36,6 @@ require 'aws-sdk-core/plugins/telemetry.rb'
36
36
  require 'aws-sdk-core/plugins/sign.rb'
37
37
  require 'aws-sdk-core/plugins/protocols/rest_json.rb'
38
38
 
39
- Aws::Plugins::GlobalConfiguration.add_identifier(:resourcegroups)
40
-
41
39
  module Aws::ResourceGroups
42
40
  # An API client for ResourceGroups. To construct a client, you need to configure a `:region` and `:credentials`.
43
41
  #
@@ -449,6 +447,36 @@ module Aws::ResourceGroups
449
447
 
450
448
  # @!group API Operations
451
449
 
450
+ # Cancels the specified tag-sync task.
451
+ #
452
+ # **Minimum permissions**
453
+ #
454
+ # To run this command, you must have the following permissions:
455
+ #
456
+ # * `resource-groups:CancelTagSyncTask` on the application group
457
+ #
458
+ # * `resource-groups:DeleteGroup`
459
+ #
460
+ # @option params [required, String] :task_arn
461
+ # The Amazon resource name (ARN) of the tag-sync task.
462
+ #
463
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
464
+ #
465
+ # @example Request syntax with placeholder values
466
+ #
467
+ # resp = client.cancel_tag_sync_task({
468
+ # task_arn: "TagSyncTaskArn", # required
469
+ # })
470
+ #
471
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/CancelTagSyncTask AWS API Documentation
472
+ #
473
+ # @overload cancel_tag_sync_task(params = {})
474
+ # @param [Hash] params ({})
475
+ def cancel_tag_sync_task(params = {}, options = {})
476
+ req = build_request(:cancel_tag_sync_task, params)
477
+ req.send_request(options)
478
+ end
479
+
452
480
  # Creates a resource group with the specified name and description. You
453
481
  # can optionally include either a resource query or a service
454
482
  # configuration. For more information about constructing a resource
@@ -517,6 +545,19 @@ module Aws::ResourceGroups
517
545
  #
518
546
  # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
519
547
  #
548
+ # @option params [Integer] :criticality
549
+ # The critical rank of the application group on a scale of 1 to 10, with
550
+ # a rank of 1 being the most critical, and a rank of 10 being least
551
+ # critical.
552
+ #
553
+ # @option params [String] :owner
554
+ # A name, email address or other identifier for the person or group who
555
+ # is considered as the owner of this application group within your
556
+ # organization.
557
+ #
558
+ # @option params [String] :display_name
559
+ # The name of the application group, which you can change at any time.
560
+ #
520
561
  # @return [Types::CreateGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
521
562
  #
522
563
  # * {Types::CreateGroupOutput#group #group} => Types::Group
@@ -527,7 +568,7 @@ module Aws::ResourceGroups
527
568
  # @example Request syntax with placeholder values
528
569
  #
529
570
  # resp = client.create_group({
530
- # name: "GroupName", # required
571
+ # name: "CreateGroupName", # required
531
572
  # description: "Description",
532
573
  # resource_query: {
533
574
  # type: "TAG_FILTERS_1_0", # required, accepts TAG_FILTERS_1_0, CLOUDFORMATION_STACK_1_0
@@ -547,6 +588,9 @@ module Aws::ResourceGroups
547
588
  # ],
548
589
  # },
549
590
  # ],
591
+ # criticality: 1,
592
+ # owner: "Owner",
593
+ # display_name: "DisplayName",
550
594
  # })
551
595
  #
552
596
  # @example Response structure
@@ -554,6 +598,11 @@ module Aws::ResourceGroups
554
598
  # resp.group.group_arn #=> String
555
599
  # resp.group.name #=> String
556
600
  # resp.group.description #=> String
601
+ # resp.group.criticality #=> Integer
602
+ # resp.group.owner #=> String
603
+ # resp.group.display_name #=> String
604
+ # resp.group.application_tag #=> Hash
605
+ # resp.group.application_tag["ApplicationTagKey"] #=> String
557
606
  # resp.resource_query.type #=> String, one of "TAG_FILTERS_1_0", "CLOUDFORMATION_STACK_1_0"
558
607
  # resp.resource_query.query #=> String
559
608
  # resp.tags #=> Hash
@@ -598,7 +647,8 @@ module Aws::ResourceGroups
598
647
  # Deprecated - don't use this parameter. Use `Group` instead.
599
648
  #
600
649
  # @option params [String] :group
601
- # The name or the ARN of the resource group to delete.
650
+ # The name or the Amazon resource name (ARN) of the resource group to
651
+ # delete.
602
652
  #
603
653
  # @return [Types::DeleteGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
604
654
  #
@@ -608,7 +658,7 @@ module Aws::ResourceGroups
608
658
  #
609
659
  # resp = client.delete_group({
610
660
  # group_name: "GroupName",
611
- # group: "GroupString",
661
+ # group: "GroupStringV2",
612
662
  # })
613
663
  #
614
664
  # @example Response structure
@@ -616,6 +666,11 @@ module Aws::ResourceGroups
616
666
  # resp.group.group_arn #=> String
617
667
  # resp.group.name #=> String
618
668
  # resp.group.description #=> String
669
+ # resp.group.criticality #=> Integer
670
+ # resp.group.owner #=> String
671
+ # resp.group.display_name #=> String
672
+ # resp.group.application_tag #=> Hash
673
+ # resp.group.application_tag["ApplicationTagKey"] #=> String
619
674
  #
620
675
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/DeleteGroup AWS API Documentation
621
676
  #
@@ -661,7 +716,8 @@ module Aws::ResourceGroups
661
716
  # Deprecated - don't use this parameter. Use `Group` instead.
662
717
  #
663
718
  # @option params [String] :group
664
- # The name or the ARN of the resource group to retrieve.
719
+ # The name or the Amazon resource name (ARN) of the resource group to
720
+ # retrieve.
665
721
  #
666
722
  # @return [Types::GetGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
667
723
  #
@@ -671,7 +727,7 @@ module Aws::ResourceGroups
671
727
  #
672
728
  # resp = client.get_group({
673
729
  # group_name: "GroupName",
674
- # group: "GroupString",
730
+ # group: "GroupStringV2",
675
731
  # })
676
732
  #
677
733
  # @example Response structure
@@ -679,6 +735,11 @@ module Aws::ResourceGroups
679
735
  # resp.group.group_arn #=> String
680
736
  # resp.group.name #=> String
681
737
  # resp.group.description #=> String
738
+ # resp.group.criticality #=> Integer
739
+ # resp.group.owner #=> String
740
+ # resp.group.display_name #=> String
741
+ # resp.group.application_tag #=> Hash
742
+ # resp.group.application_tag["ApplicationTagKey"] #=> String
682
743
  #
683
744
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroup AWS API Documentation
684
745
  #
@@ -706,8 +767,8 @@ module Aws::ResourceGroups
706
767
  # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
707
768
  #
708
769
  # @option params [String] :group
709
- # The name or the ARN of the resource group for which you want to
710
- # retrive the service configuration.
770
+ # The name or the Amazon resource name (ARN) of the resource group for
771
+ # which you want to retrive the service configuration.
711
772
  #
712
773
  # @return [Types::GetGroupConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
713
774
  #
@@ -765,7 +826,8 @@ module Aws::ResourceGroups
765
826
  # Don't use this parameter. Use `Group` instead.
766
827
  #
767
828
  # @option params [String] :group
768
- # The name or the ARN of the resource group to query.
829
+ # The name or the Amazon resource name (ARN) of the resource group to
830
+ # query.
769
831
  #
770
832
  # @return [Types::GetGroupQueryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
771
833
  #
@@ -793,8 +855,60 @@ module Aws::ResourceGroups
793
855
  req.send_request(options)
794
856
  end
795
857
 
858
+ # Returns information about a specified tag-sync task.
859
+ #
860
+ # **Minimum permissions**
861
+ #
862
+ # To run this command, you must have the following permissions:
863
+ #
864
+ # * `resource-groups:GetTagSyncTask` on the application group
865
+ #
866
+ # ^
867
+ #
868
+ # @option params [required, String] :task_arn
869
+ # The Amazon resource name (ARN) of the tag-sync task.
870
+ #
871
+ # @return [Types::GetTagSyncTaskOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
872
+ #
873
+ # * {Types::GetTagSyncTaskOutput#group_arn #group_arn} => String
874
+ # * {Types::GetTagSyncTaskOutput#group_name #group_name} => String
875
+ # * {Types::GetTagSyncTaskOutput#task_arn #task_arn} => String
876
+ # * {Types::GetTagSyncTaskOutput#tag_key #tag_key} => String
877
+ # * {Types::GetTagSyncTaskOutput#tag_value #tag_value} => String
878
+ # * {Types::GetTagSyncTaskOutput#role_arn #role_arn} => String
879
+ # * {Types::GetTagSyncTaskOutput#status #status} => String
880
+ # * {Types::GetTagSyncTaskOutput#error_message #error_message} => String
881
+ # * {Types::GetTagSyncTaskOutput#created_at #created_at} => Time
882
+ #
883
+ # @example Request syntax with placeholder values
884
+ #
885
+ # resp = client.get_tag_sync_task({
886
+ # task_arn: "TagSyncTaskArn", # required
887
+ # })
888
+ #
889
+ # @example Response structure
890
+ #
891
+ # resp.group_arn #=> String
892
+ # resp.group_name #=> String
893
+ # resp.task_arn #=> String
894
+ # resp.tag_key #=> String
895
+ # resp.tag_value #=> String
896
+ # resp.role_arn #=> String
897
+ # resp.status #=> String, one of "ACTIVE", "ERROR"
898
+ # resp.error_message #=> String
899
+ # resp.created_at #=> Time
900
+ #
901
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetTagSyncTask AWS API Documentation
902
+ #
903
+ # @overload get_tag_sync_task(params = {})
904
+ # @param [Hash] params ({})
905
+ def get_tag_sync_task(params = {}, options = {})
906
+ req = build_request(:get_tag_sync_task, params)
907
+ req.send_request(options)
908
+ end
909
+
796
910
  # Returns a list of tags that are associated with a resource group,
797
- # specified by an ARN.
911
+ # specified by an Amazon resource name (ARN).
798
912
  #
799
913
  # **Minimum permissions**
800
914
  #
@@ -805,7 +919,8 @@ module Aws::ResourceGroups
805
919
  # ^
806
920
  #
807
921
  # @option params [required, String] :arn
808
- # The ARN of the resource group whose tags you want to retrieve.
922
+ # The Amazon resource name (ARN) of the resource group whose tags you
923
+ # want to retrieve.
809
924
  #
810
925
  # @return [Types::GetTagsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
811
926
  #
@@ -815,7 +930,7 @@ module Aws::ResourceGroups
815
930
  # @example Request syntax with placeholder values
816
931
  #
817
932
  # resp = client.get_tags({
818
- # arn: "GroupArn", # required
933
+ # arn: "GroupArnV2", # required
819
934
  # })
820
935
  #
821
936
  # @example Response structure
@@ -835,14 +950,15 @@ module Aws::ResourceGroups
835
950
 
836
951
  # Adds the specified resources to the specified group.
837
952
  #
838
- # You can use this operation with only resource groups that are
839
- # configured with the following types:
953
+ # You can only use this operation with the following groups:
840
954
  #
841
955
  # * `AWS::EC2::HostManagement`
842
956
  #
843
957
  # * `AWS::EC2::CapacityReservationPool`
844
958
  #
845
- # Other resource group type and resource types aren't currently
959
+ # * `AWS::ResourceGroups::ApplicationGroup`
960
+ #
961
+ # Other resource group types and resource types are not currently
846
962
  # supported by this operation.
847
963
  #
848
964
  # **Minimum permissions**
@@ -854,10 +970,12 @@ module Aws::ResourceGroups
854
970
  # ^
855
971
  #
856
972
  # @option params [required, String] :group
857
- # The name or the ARN of the resource group to add resources to.
973
+ # The name or the Amazon resource name (ARN) of the resource group to
974
+ # add resources to.
858
975
  #
859
976
  # @option params [required, Array<String>] :resource_arns
860
- # The list of ARNs of the resources to be added to the group.
977
+ # The list of Amazon resource names (ARNs) of the resources to be added
978
+ # to the group.
861
979
  #
862
980
  # @return [Types::GroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
863
981
  #
@@ -868,7 +986,7 @@ module Aws::ResourceGroups
868
986
  # @example Request syntax with placeholder values
869
987
  #
870
988
  # resp = client.group_resources({
871
- # group: "GroupString", # required
989
+ # group: "GroupStringV2", # required
872
990
  # resource_arns: ["ResourceArn"], # required
873
991
  # })
874
992
  #
@@ -892,8 +1010,8 @@ module Aws::ResourceGroups
892
1010
  req.send_request(options)
893
1011
  end
894
1012
 
895
- # Returns a list of ARNs of the resources that are members of a
896
- # specified resource group.
1013
+ # Returns a list of Amazon resource names (ARNs) of the resources that
1014
+ # are members of a specified resource group.
897
1015
  #
898
1016
  # **Minimum permissions**
899
1017
  #
@@ -912,7 +1030,7 @@ module Aws::ResourceGroups
912
1030
  # <code>Group</code> request field instead.</b> </i>
913
1031
  #
914
1032
  # @option params [String] :group
915
- # The name or the ARN of the resource group
1033
+ # The name or the Amazon resource name (ARN) of the resource group.
916
1034
  #
917
1035
  # @option params [Array<Types::ResourceFilter>] :filters
918
1036
  # Filters, formatted as ResourceFilter objects, that you want to apply
@@ -976,7 +1094,7 @@ module Aws::ResourceGroups
976
1094
  #
977
1095
  # resp = client.list_group_resources({
978
1096
  # group_name: "GroupName",
979
- # group: "GroupString",
1097
+ # group: "GroupStringV2",
980
1098
  # filters: [
981
1099
  # {
982
1100
  # name: "resource-type", # required, accepts resource-type
@@ -1010,6 +1128,71 @@ module Aws::ResourceGroups
1010
1128
  req.send_request(options)
1011
1129
  end
1012
1130
 
1131
+ # Returns the status of the last grouping or ungrouping action for each
1132
+ # resource in the specified application group.
1133
+ #
1134
+ # @option params [required, String] :group
1135
+ # The application group identifier, expressed as an Amazon resource name
1136
+ # (ARN) or the application group name.
1137
+ #
1138
+ # @option params [Integer] :max_results
1139
+ # The maximum number of resources and their statuses returned in the
1140
+ # response.
1141
+ #
1142
+ # @option params [Array<Types::ListGroupingStatusesFilter>] :filters
1143
+ # The filter name and value pair that is used to return more specific
1144
+ # results from a list of resources.
1145
+ #
1146
+ # @option params [String] :next_token
1147
+ # The parameter for receiving additional results if you receive a
1148
+ # `NextToken` response in a previous request. A `NextToken` response
1149
+ # indicates that more output is available. Set this parameter to the
1150
+ # value provided by a previous call's `NextToken` response to indicate
1151
+ # where the output should continue from.
1152
+ #
1153
+ # @return [Types::ListGroupingStatusesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1154
+ #
1155
+ # * {Types::ListGroupingStatusesOutput#group #group} => String
1156
+ # * {Types::ListGroupingStatusesOutput#grouping_statuses #grouping_statuses} => Array&lt;Types::GroupingStatusesItem&gt;
1157
+ # * {Types::ListGroupingStatusesOutput#next_token #next_token} => String
1158
+ #
1159
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1160
+ #
1161
+ # @example Request syntax with placeholder values
1162
+ #
1163
+ # resp = client.list_grouping_statuses({
1164
+ # group: "GroupStringV2", # required
1165
+ # max_results: 1,
1166
+ # filters: [
1167
+ # {
1168
+ # name: "status", # required, accepts status, resource-arn
1169
+ # values: ["ListGroupingStatusesFilterValue"], # required
1170
+ # },
1171
+ # ],
1172
+ # next_token: "NextToken",
1173
+ # })
1174
+ #
1175
+ # @example Response structure
1176
+ #
1177
+ # resp.group #=> String
1178
+ # resp.grouping_statuses #=> Array
1179
+ # resp.grouping_statuses[0].resource_arn #=> String
1180
+ # resp.grouping_statuses[0].action #=> String, one of "GROUP", "UNGROUP"
1181
+ # resp.grouping_statuses[0].status #=> String, one of "SUCCESS", "FAILED", "IN_PROGRESS", "SKIPPED"
1182
+ # resp.grouping_statuses[0].error_message #=> String
1183
+ # resp.grouping_statuses[0].error_code #=> String
1184
+ # resp.grouping_statuses[0].updated_at #=> Time
1185
+ # resp.next_token #=> String
1186
+ #
1187
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListGroupingStatuses AWS API Documentation
1188
+ #
1189
+ # @overload list_grouping_statuses(params = {})
1190
+ # @param [Hash] params ({})
1191
+ def list_grouping_statuses(params = {}, options = {})
1192
+ req = build_request(:list_grouping_statuses, params)
1193
+ req.send_request(options)
1194
+ end
1195
+
1013
1196
  # Returns a list of existing Resource Groups in your account.
1014
1197
  #
1015
1198
  # **Minimum permissions**
@@ -1034,6 +1217,8 @@ module Aws::ResourceGroups
1034
1217
  # groups that have the specified configuration types attached. The
1035
1218
  # current supported values are:
1036
1219
  #
1220
+ # * `AWS::ResourceGroups::ApplicationGroup`
1221
+ #
1037
1222
  # * `AWS::AppRegistry::Application`
1038
1223
  #
1039
1224
  # * `AWS::AppRegistry::ApplicationResourceGroups`
@@ -1078,7 +1263,7 @@ module Aws::ResourceGroups
1078
1263
  # resp = client.list_groups({
1079
1264
  # filters: [
1080
1265
  # {
1081
- # name: "resource-type", # required, accepts resource-type, configuration-type
1266
+ # name: "resource-type", # required, accepts resource-type, configuration-type, owner, display-name, criticality
1082
1267
  # values: ["GroupFilterValue"], # required
1083
1268
  # },
1084
1269
  # ],
@@ -1091,10 +1276,19 @@ module Aws::ResourceGroups
1091
1276
  # resp.group_identifiers #=> Array
1092
1277
  # resp.group_identifiers[0].group_name #=> String
1093
1278
  # resp.group_identifiers[0].group_arn #=> String
1279
+ # resp.group_identifiers[0].description #=> String
1280
+ # resp.group_identifiers[0].criticality #=> Integer
1281
+ # resp.group_identifiers[0].owner #=> String
1282
+ # resp.group_identifiers[0].display_name #=> String
1094
1283
  # resp.groups #=> Array
1095
1284
  # resp.groups[0].group_arn #=> String
1096
1285
  # resp.groups[0].name #=> String
1097
1286
  # resp.groups[0].description #=> String
1287
+ # resp.groups[0].criticality #=> Integer
1288
+ # resp.groups[0].owner #=> String
1289
+ # resp.groups[0].display_name #=> String
1290
+ # resp.groups[0].application_tag #=> Hash
1291
+ # resp.groups[0].application_tag["ApplicationTagKey"] #=> String
1098
1292
  # resp.next_token #=> String
1099
1293
  #
1100
1294
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListGroups AWS API Documentation
@@ -1106,6 +1300,74 @@ module Aws::ResourceGroups
1106
1300
  req.send_request(options)
1107
1301
  end
1108
1302
 
1303
+ # Returns a list of tag-sync tasks.
1304
+ #
1305
+ # **Minimum permissions**
1306
+ #
1307
+ # To run this command, you must have the following permissions:
1308
+ #
1309
+ # * `resource-groups:ListTagSyncTasks` with the group passed in the
1310
+ # filters as the resource or * if using no filters
1311
+ #
1312
+ # ^
1313
+ #
1314
+ # @option params [Array<Types::ListTagSyncTasksFilter>] :filters
1315
+ # The Amazon resource name (ARN) or name of the application group for
1316
+ # which you want to return a list of tag-sync tasks.
1317
+ #
1318
+ # @option params [Integer] :max_results
1319
+ # The maximum number of results to be included in the response.
1320
+ #
1321
+ # @option params [String] :next_token
1322
+ # The parameter for receiving additional results if you receive a
1323
+ # `NextToken` response in a previous request. A `NextToken` response
1324
+ # indicates that more output is available. Set this parameter to the
1325
+ # value provided by a previous call's `NextToken` response to indicate
1326
+ # where the output should continue from.
1327
+ #
1328
+ # @return [Types::ListTagSyncTasksOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1329
+ #
1330
+ # * {Types::ListTagSyncTasksOutput#tag_sync_tasks #tag_sync_tasks} => Array&lt;Types::TagSyncTaskItem&gt;
1331
+ # * {Types::ListTagSyncTasksOutput#next_token #next_token} => String
1332
+ #
1333
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1334
+ #
1335
+ # @example Request syntax with placeholder values
1336
+ #
1337
+ # resp = client.list_tag_sync_tasks({
1338
+ # filters: [
1339
+ # {
1340
+ # group_arn: "GroupArnV2",
1341
+ # group_name: "GroupName",
1342
+ # },
1343
+ # ],
1344
+ # max_results: 1,
1345
+ # next_token: "NextToken",
1346
+ # })
1347
+ #
1348
+ # @example Response structure
1349
+ #
1350
+ # resp.tag_sync_tasks #=> Array
1351
+ # resp.tag_sync_tasks[0].group_arn #=> String
1352
+ # resp.tag_sync_tasks[0].group_name #=> String
1353
+ # resp.tag_sync_tasks[0].task_arn #=> String
1354
+ # resp.tag_sync_tasks[0].tag_key #=> String
1355
+ # resp.tag_sync_tasks[0].tag_value #=> String
1356
+ # resp.tag_sync_tasks[0].role_arn #=> String
1357
+ # resp.tag_sync_tasks[0].status #=> String, one of "ACTIVE", "ERROR"
1358
+ # resp.tag_sync_tasks[0].error_message #=> String
1359
+ # resp.tag_sync_tasks[0].created_at #=> Time
1360
+ # resp.next_token #=> String
1361
+ #
1362
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListTagSyncTasks AWS API Documentation
1363
+ #
1364
+ # @overload list_tag_sync_tasks(params = {})
1365
+ # @param [Hash] params ({})
1366
+ def list_tag_sync_tasks(params = {}, options = {})
1367
+ req = build_request(:list_tag_sync_tasks, params)
1368
+ req.send_request(options)
1369
+ end
1370
+
1109
1371
  # Attaches a service configuration to the specified group. This occurs
1110
1372
  # asynchronously, and can take time to complete. You can use
1111
1373
  # GetGroupConfiguration to check the status of the update.
@@ -1119,8 +1381,8 @@ module Aws::ResourceGroups
1119
1381
  # ^
1120
1382
  #
1121
1383
  # @option params [String] :group
1122
- # The name or ARN of the resource group with the configuration that you
1123
- # want to update.
1384
+ # The name or Amazon resource name (ARN) of the resource group with the
1385
+ # configuration that you want to update.
1124
1386
  #
1125
1387
  # @option params [Array<Types::GroupConfigurationItem>] :configuration
1126
1388
  # The new configuration to associate with the specified group. A
@@ -1246,9 +1508,76 @@ module Aws::ResourceGroups
1246
1508
  req.send_request(options)
1247
1509
  end
1248
1510
 
1249
- # Adds tags to a resource group with the specified ARN. Existing tags on
1250
- # a resource group are not changed if they are not specified in the
1251
- # request parameters.
1511
+ # Creates a new tag-sync task to onboard and sync resources tagged with
1512
+ # a specific tag key-value pair to an application.
1513
+ #
1514
+ # **Minimum permissions**
1515
+ #
1516
+ # To run this command, you must have the following permissions:
1517
+ #
1518
+ # * `resource-groups:StartTagSyncTask` on the application group
1519
+ #
1520
+ # * `resource-groups:CreateGroup`
1521
+ #
1522
+ # * `iam:PassRole` on the role provided in the request
1523
+ #
1524
+ # @option params [required, String] :group
1525
+ # The Amazon resource name (ARN) or name of the application group for
1526
+ # which you want to create a tag-sync task.
1527
+ #
1528
+ # @option params [required, String] :tag_key
1529
+ # The tag key. Resources tagged with this tag key-value pair will be
1530
+ # added to the application. If a resource with this tag is later
1531
+ # untagged, the tag-sync task removes the resource from the application.
1532
+ #
1533
+ # @option params [required, String] :tag_value
1534
+ # The tag value. Resources tagged with this tag key-value pair will be
1535
+ # added to the application. If a resource with this tag is later
1536
+ # untagged, the tag-sync task removes the resource from the application.
1537
+ #
1538
+ # @option params [required, String] :role_arn
1539
+ # The Amazon resource name (ARN) of the role assumed by the service to
1540
+ # tag and untag resources on your behalf.
1541
+ #
1542
+ # @return [Types::StartTagSyncTaskOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1543
+ #
1544
+ # * {Types::StartTagSyncTaskOutput#group_arn #group_arn} => String
1545
+ # * {Types::StartTagSyncTaskOutput#group_name #group_name} => String
1546
+ # * {Types::StartTagSyncTaskOutput#task_arn #task_arn} => String
1547
+ # * {Types::StartTagSyncTaskOutput#tag_key #tag_key} => String
1548
+ # * {Types::StartTagSyncTaskOutput#tag_value #tag_value} => String
1549
+ # * {Types::StartTagSyncTaskOutput#role_arn #role_arn} => String
1550
+ #
1551
+ # @example Request syntax with placeholder values
1552
+ #
1553
+ # resp = client.start_tag_sync_task({
1554
+ # group: "GroupStringV2", # required
1555
+ # tag_key: "TagKey", # required
1556
+ # tag_value: "TagValue", # required
1557
+ # role_arn: "RoleArn", # required
1558
+ # })
1559
+ #
1560
+ # @example Response structure
1561
+ #
1562
+ # resp.group_arn #=> String
1563
+ # resp.group_name #=> String
1564
+ # resp.task_arn #=> String
1565
+ # resp.tag_key #=> String
1566
+ # resp.tag_value #=> String
1567
+ # resp.role_arn #=> String
1568
+ #
1569
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/StartTagSyncTask AWS API Documentation
1570
+ #
1571
+ # @overload start_tag_sync_task(params = {})
1572
+ # @param [Hash] params ({})
1573
+ def start_tag_sync_task(params = {}, options = {})
1574
+ req = build_request(:start_tag_sync_task, params)
1575
+ req.send_request(options)
1576
+ end
1577
+
1578
+ # Adds tags to a resource group with the specified Amazon resource name
1579
+ # (ARN). Existing tags on a resource group are not changed if they are
1580
+ # not specified in the request parameters.
1252
1581
  #
1253
1582
  # Do not store personally identifiable information (PII) or other
1254
1583
  # confidential or sensitive information in tags. We use tags to provide
@@ -1264,7 +1593,8 @@ module Aws::ResourceGroups
1264
1593
  # ^
1265
1594
  #
1266
1595
  # @option params [required, String] :arn
1267
- # The ARN of the resource group to which to add tags.
1596
+ # The Amazon resource name (ARN) of the resource group to which to add
1597
+ # tags.
1268
1598
  #
1269
1599
  # @option params [required, Hash<String,String>] :tags
1270
1600
  # The tags to add to the specified resource group. A tag is a
@@ -1278,7 +1608,7 @@ module Aws::ResourceGroups
1278
1608
  # @example Request syntax with placeholder values
1279
1609
  #
1280
1610
  # resp = client.tag({
1281
- # arn: "GroupArn", # required
1611
+ # arn: "GroupArnV2", # required
1282
1612
  # tags: { # required
1283
1613
  # "TagKey" => "TagValue",
1284
1614
  # },
@@ -1314,11 +1644,12 @@ module Aws::ResourceGroups
1314
1644
  # ^
1315
1645
  #
1316
1646
  # @option params [required, String] :group
1317
- # The name or the ARN of the resource group from which to remove the
1318
- # resources.
1647
+ # The name or the Amazon resource name (ARN) of the resource group from
1648
+ # which to remove the resources.
1319
1649
  #
1320
1650
  # @option params [required, Array<String>] :resource_arns
1321
- # The ARNs of the resources to be removed from the group.
1651
+ # The Amazon resource names (ARNs) of the resources to be removed from
1652
+ # the group.
1322
1653
  #
1323
1654
  # @return [Types::UngroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1324
1655
  #
@@ -1329,7 +1660,7 @@ module Aws::ResourceGroups
1329
1660
  # @example Request syntax with placeholder values
1330
1661
  #
1331
1662
  # resp = client.ungroup_resources({
1332
- # group: "GroupString", # required
1663
+ # group: "GroupStringV2", # required
1333
1664
  # resource_arns: ["ResourceArn"], # required
1334
1665
  # })
1335
1666
  #
@@ -1364,9 +1695,9 @@ module Aws::ResourceGroups
1364
1695
  # ^
1365
1696
  #
1366
1697
  # @option params [required, String] :arn
1367
- # The ARN of the resource group from which to remove tags. The command
1368
- # removed both the specified keys and any values associated with those
1369
- # keys.
1698
+ # The Amazon resource name (ARN) of the resource group from which to
1699
+ # remove tags. The command removed both the specified keys and any
1700
+ # values associated with those keys.
1370
1701
  #
1371
1702
  # @option params [required, Array<String>] :keys
1372
1703
  # The keys of the tags to be removed.
@@ -1379,7 +1710,7 @@ module Aws::ResourceGroups
1379
1710
  # @example Request syntax with placeholder values
1380
1711
  #
1381
1712
  # resp = client.untag({
1382
- # arn: "GroupArn", # required
1713
+ # arn: "GroupArnV2", # required
1383
1714
  # keys: ["TagKey"], # required
1384
1715
  # })
1385
1716
  #
@@ -1409,6 +1740,9 @@ module Aws::ResourceGroups
1409
1740
  # Specifies whether you want to turn [group lifecycle events][1] on or
1410
1741
  # off.
1411
1742
  #
1743
+ # You can't turn on group lifecycle events if your resource groups
1744
+ # quota is greater than 2,000.
1745
+ #
1412
1746
  #
1413
1747
  #
1414
1748
  # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/monitor-groups.html
@@ -1453,13 +1787,26 @@ module Aws::ResourceGroups
1453
1787
  # Don't use this parameter. Use `Group` instead.
1454
1788
  #
1455
1789
  # @option params [String] :group
1456
- # The name or the ARN of the resource group to modify.
1790
+ # The name or the ARN of the resource group to update.
1457
1791
  #
1458
1792
  # @option params [String] :description
1459
1793
  # The new description that you want to update the resource group with.
1460
1794
  # Descriptions can contain letters, numbers, hyphens, underscores,
1461
1795
  # periods, and spaces.
1462
1796
  #
1797
+ # @option params [Integer] :criticality
1798
+ # The critical rank of the application group on a scale of 1 to 10, with
1799
+ # a rank of 1 being the most critical, and a rank of 10 being least
1800
+ # critical.
1801
+ #
1802
+ # @option params [String] :owner
1803
+ # A name, email address or other identifier for the person or group who
1804
+ # is considered as the owner of this application group within your
1805
+ # organization.
1806
+ #
1807
+ # @option params [String] :display_name
1808
+ # The name of the application group, which you can change at any time.
1809
+ #
1463
1810
  # @return [Types::UpdateGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1464
1811
  #
1465
1812
  # * {Types::UpdateGroupOutput#group #group} => Types::Group
@@ -1468,8 +1815,11 @@ module Aws::ResourceGroups
1468
1815
  #
1469
1816
  # resp = client.update_group({
1470
1817
  # group_name: "GroupName",
1471
- # group: "GroupString",
1818
+ # group: "GroupStringV2",
1472
1819
  # description: "Description",
1820
+ # criticality: 1,
1821
+ # owner: "Owner",
1822
+ # display_name: "DisplayName",
1473
1823
  # })
1474
1824
  #
1475
1825
  # @example Response structure
@@ -1477,6 +1827,11 @@ module Aws::ResourceGroups
1477
1827
  # resp.group.group_arn #=> String
1478
1828
  # resp.group.name #=> String
1479
1829
  # resp.group.description #=> String
1830
+ # resp.group.criticality #=> Integer
1831
+ # resp.group.owner #=> String
1832
+ # resp.group.display_name #=> String
1833
+ # resp.group.application_tag #=> Hash
1834
+ # resp.group.application_tag["ApplicationTagKey"] #=> String
1480
1835
  #
1481
1836
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UpdateGroup AWS API Documentation
1482
1837
  #
@@ -1507,7 +1862,8 @@ module Aws::ResourceGroups
1507
1862
  # Don't use this parameter. Use `Group` instead.
1508
1863
  #
1509
1864
  # @option params [String] :group
1510
- # The name or the ARN of the resource group to query.
1865
+ # The name or the Amazon resource name (ARN) of the resource group to
1866
+ # query.
1511
1867
  #
1512
1868
  # @option params [required, Types::ResourceQuery] :resource_query
1513
1869
  # The resource query to determine which Amazon Web Services resources
@@ -1566,7 +1922,7 @@ module Aws::ResourceGroups
1566
1922
  tracer: tracer
1567
1923
  )
1568
1924
  context[:gem_name] = 'aws-sdk-resourcegroups'
1569
- context[:gem_version] = '1.71.0'
1925
+ context[:gem_version] = '1.73.0'
1570
1926
  Seahorse::Client::Request.new(handlers, context)
1571
1927
  end
1572
1928