aws-sdk-resourcegroups 1.71.0 → 1.73.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.
@@ -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