aws-sdk-resourcegroups 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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 1239f7df53b817e01f77429858ed5a052223981e1617c5cca3ec167fe1cf2fcd
4
- data.tar.gz: b5833910391071de5543e37ece23b98867fba65ee94c38a72e397197c83a6710
3
+ metadata.gz: 0cd9b853dae692f26ea582fd09d1b7ee05c9e6c415daf225561e9f51de1ba373
4
+ data.tar.gz: 2774d44203d0f390edbd27d81df9880d8df7068c15ceff03c16a5d732c7ea206
5
5
  SHA512:
6
- metadata.gz: 15a7a5c824d3eba44fd22fdf20d325c53da53c7cc39f59eb35165b946ff2a836c517b5701be3ce4dade4806031cac38a370bc9c66be02938f783994062c408a0
7
- data.tar.gz: b71ff290e4e9d03314db050557b8b85a331e5bda6e31042b9d01b68e0de7c539e31c0f757582c1eda862dc2cb55a84f7b3aa712f91c12273554c5234985c3474
6
+ metadata.gz: cc8d1ab14a885c2bd8aad249c766cb80d9edce7a939d87a6b40cc70924d82cab7fae5e98f779064dd8ef1871c0da4cdfc1dac4c3a79dc15f360b11156c434fcc
7
+ data.tar.gz: ec90a308aa4956e52173a5dd876dac639f892d6240da062ecec2c2b74fc4739da759f9553821adacffa9c6ff57480d129f6db0ab3e8b02c776631d342d6c2ae8
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-resourcegroups/customizations'
48
48
  # @!group service
49
49
  module Aws::ResourceGroups
50
50
 
51
- GEM_VERSION = '1.32.0'
51
+ GEM_VERSION = '1.33.0'
52
52
 
53
53
  end
@@ -329,6 +329,23 @@ module Aws::ResourceGroups
329
329
 
330
330
  # Creates a resource group with the specified name and description. You
331
331
  # can optionally include a resource query, or a service configuration.
332
+ # For more information about constructing a resource query, see [Create
333
+ # a tag-based group in Resource Groups][1]. For more information about
334
+ # service configurations, see [Service configurations for resource
335
+ # groups][2].
336
+ #
337
+ # **Minimum permissions**
338
+ #
339
+ # To run this command, you must have the following permissions:
340
+ #
341
+ # * `resource-groups:CreateGroup`
342
+ #
343
+ # ^
344
+ #
345
+ #
346
+ #
347
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag
348
+ # [2]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
332
349
  #
333
350
  # @option params [required, String] :name
334
351
  # The name of the group, which is the identifier of the group in other
@@ -344,13 +361,18 @@ module Aws::ResourceGroups
344
361
  #
345
362
  # @option params [Types::ResourceQuery] :resource_query
346
363
  # The resource query that determines which AWS resources are members of
347
- # this group.
364
+ # this group. For more information about resource queries, see [Create a
365
+ # tag-based group in Resource Groups][1].
348
366
  #
349
- # <note markdown="1"> You can specify either a `ResourceQuery` or a `Configuration`, but not
350
- # both.
367
+ # <note markdown="1"> A resource group can contain either a `ResourceQuery` or a
368
+ # `Configuration`, but not both.
351
369
  #
352
370
  # </note>
353
371
  #
372
+ #
373
+ #
374
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag
375
+ #
354
376
  # @option params [Hash<String,String>] :tags
355
377
  # The tags to add to the group. A tag is key-value pair string.
356
378
  #
@@ -358,12 +380,18 @@ module Aws::ResourceGroups
358
380
  # A configuration associates the resource group with an AWS service and
359
381
  # specifies how the service can interact with the resources in the
360
382
  # group. A configuration is an array of GroupConfigurationItem elements.
383
+ # For details about the syntax of service configurations, see [Service
384
+ # configurations for resource groups][1].
361
385
  #
362
- # <note markdown="1"> You can specify either a `Configuration` or a `ResourceQuery` in a
363
- # group, but not both.
386
+ # <note markdown="1"> A resource group can contain either a `Configuration` or a
387
+ # `ResourceQuery`, but not both.
364
388
  #
365
389
  # </note>
366
390
  #
391
+ #
392
+ #
393
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
394
+ #
367
395
  # @return [Types::CreateGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
368
396
  #
369
397
  # * {Types::CreateGroupOutput#group #group} => Types::Group
@@ -433,8 +461,16 @@ module Aws::ResourceGroups
433
461
  # not delete any resources that are members of the group; it only
434
462
  # deletes the group structure.
435
463
  #
464
+ # **Minimum permissions**
465
+ #
466
+ # To run this command, you must have the following permissions:
467
+ #
468
+ # * `resource-groups:DeleteGroup`
469
+ #
470
+ # ^
471
+ #
436
472
  # @option params [String] :group_name
437
- # Don't use this parameter. Use `Group` instead.
473
+ # Deprecated - don't use this parameter. Use `Group` instead.
438
474
  #
439
475
  # @option params [String] :group
440
476
  # The name or the ARN of the resource group to delete.
@@ -467,8 +503,16 @@ module Aws::ResourceGroups
467
503
 
468
504
  # Returns information about a specified resource group.
469
505
  #
506
+ # **Minimum permissions**
507
+ #
508
+ # To run this command, you must have the following permissions:
509
+ #
510
+ # * `resource-groups:GetGroup`
511
+ #
512
+ # ^
513
+ #
470
514
  # @option params [String] :group_name
471
- # Don't use this parameter. Use `Group` instead.
515
+ # Deprecated - don't use this parameter. Use `Group` instead.
472
516
  #
473
517
  # @option params [String] :group
474
518
  # The name or the ARN of the resource group to retrieve.
@@ -500,18 +544,20 @@ module Aws::ResourceGroups
500
544
  end
501
545
 
502
546
  # Returns the service configuration associated with the specified
503
- # resource group. AWS Resource Groups supports configurations for the
504
- # following resource group types:
547
+ # resource group. For details about the service configuration syntax,
548
+ # see [Service configurations for resource groups][1].
505
549
  #
506
- # * `AWS::EC2::CapacityReservationPool` - Amazon EC2 capacity
507
- # reservation pools. For more information, see [Working with capacity
508
- # reservation groups][1] in the *EC2 Users Guide*.
550
+ # **Minimum permissions**
551
+ #
552
+ # To run this command, you must have the following permissions:
553
+ #
554
+ # * `resource-groups:GetGroupConfiguration`
509
555
  #
510
556
  # ^
511
557
  #
512
558
  #
513
559
  #
514
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#create-cr-group
560
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
515
561
  #
516
562
  # @option params [String] :group
517
563
  # The name or the ARN of the resource group.
@@ -553,7 +599,20 @@ module Aws::ResourceGroups
553
599
  end
554
600
 
555
601
  # Retrieves the resource query associated with the specified resource
556
- # group.
602
+ # group. For more information about resource queries, see [Create a
603
+ # tag-based group in Resource Groups][1].
604
+ #
605
+ # **Minimum permissions**
606
+ #
607
+ # To run this command, you must have the following permissions:
608
+ #
609
+ # * `resource-groups:GetGroupQuery`
610
+ #
611
+ # ^
612
+ #
613
+ #
614
+ #
615
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag
557
616
  #
558
617
  # @option params [String] :group_name
559
618
  # Don't use this parameter. Use `Group` instead.
@@ -590,6 +649,14 @@ module Aws::ResourceGroups
590
649
  # Returns a list of tags that are associated with a resource group,
591
650
  # specified by an ARN.
592
651
  #
652
+ # **Minimum permissions**
653
+ #
654
+ # To run this command, you must have the following permissions:
655
+ #
656
+ # * `resource-groups:GetTags`
657
+ #
658
+ # ^
659
+ #
593
660
  # @option params [required, String] :arn
594
661
  # The ARN of the resource group whose tags you want to retrieve.
595
662
  #
@@ -621,6 +688,14 @@ module Aws::ResourceGroups
621
688
 
622
689
  # Adds the specified resources to the specified group.
623
690
  #
691
+ # **Minimum permissions**
692
+ #
693
+ # To run this command, you must have the following permissions:
694
+ #
695
+ # * `resource-groups:GroupResources`
696
+ #
697
+ # ^
698
+ #
624
699
  # @option params [required, String] :group
625
700
  # The name or the ARN of the resource group to add resources to.
626
701
  #
@@ -631,6 +706,7 @@ module Aws::ResourceGroups
631
706
  #
632
707
  # * {Types::GroupResourcesOutput#succeeded #succeeded} => Array&lt;String&gt;
633
708
  # * {Types::GroupResourcesOutput#failed #failed} => Array&lt;Types::FailedResource&gt;
709
+ # * {Types::GroupResourcesOutput#pending #pending} => Array&lt;Types::PendingResource&gt;
634
710
  #
635
711
  # @example Request syntax with placeholder values
636
712
  #
@@ -647,6 +723,8 @@ module Aws::ResourceGroups
647
723
  # resp.failed[0].resource_arn #=> String
648
724
  # resp.failed[0].error_message #=> String
649
725
  # resp.failed[0].error_code #=> String
726
+ # resp.pending #=> Array
727
+ # resp.pending[0].resource_arn #=> String
650
728
  #
651
729
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GroupResources AWS API Documentation
652
730
  #
@@ -660,8 +738,17 @@ module Aws::ResourceGroups
660
738
  # Returns a list of ARNs of the resources that are members of a
661
739
  # specified resource group.
662
740
  #
741
+ # **Minimum permissions**
742
+ #
743
+ # To run this command, you must have the following permissions:
744
+ #
745
+ # * `resource-groups:ListGroupResources`
746
+ #
747
+ # ^
748
+ #
663
749
  # @option params [String] :group_name
664
- # Don't use this parameter. Use `Group` instead.
750
+ # <i> <b>Deprecated - don't use this parameter. Use the
751
+ # <code>Group</code> request field instead.</b> </i>
665
752
  #
666
753
  # @option params [String] :group
667
754
  # The name or the ARN of the resource group
@@ -717,6 +804,7 @@ module Aws::ResourceGroups
717
804
  #
718
805
  # @return [Types::ListGroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
719
806
  #
807
+ # * {Types::ListGroupResourcesOutput#resources #resources} => Array&lt;Types::ListGroupResourcesItem&gt;
720
808
  # * {Types::ListGroupResourcesOutput#resource_identifiers #resource_identifiers} => Array&lt;Types::ResourceIdentifier&gt;
721
809
  # * {Types::ListGroupResourcesOutput#next_token #next_token} => String
722
810
  # * {Types::ListGroupResourcesOutput#query_errors #query_errors} => Array&lt;Types::QueryError&gt;
@@ -740,6 +828,10 @@ module Aws::ResourceGroups
740
828
  #
741
829
  # @example Response structure
742
830
  #
831
+ # resp.resources #=> Array
832
+ # resp.resources[0].identifier.resource_arn #=> String
833
+ # resp.resources[0].identifier.resource_type #=> String
834
+ # resp.resources[0].status.name #=> String, one of "PENDING"
743
835
  # resp.resource_identifiers #=> Array
744
836
  # resp.resource_identifiers[0].resource_arn #=> String
745
837
  # resp.resource_identifiers[0].resource_type #=> String
@@ -759,6 +851,14 @@ module Aws::ResourceGroups
759
851
 
760
852
  # Returns a list of existing resource groups in your account.
761
853
  #
854
+ # **Minimum permissions**
855
+ #
856
+ # To run this command, you must have the following permissions:
857
+ #
858
+ # * `resource-groups:ListGroups`
859
+ #
860
+ # ^
861
+ #
762
862
  # @option params [Array<Types::GroupFilter>] :filters
763
863
  # Filters, formatted as GroupFilter objects, that you want to apply to a
764
864
  # `ListGroups` operation.
@@ -772,9 +872,9 @@ module Aws::ResourceGroups
772
872
  # groups that have the specified configuration types attached. The
773
873
  # current supported values are:
774
874
  #
775
- # * AWS:EC2::CapacityReservationPool
875
+ # * `AWS:EC2::CapacityReservationPool`
776
876
  #
777
- # ^
877
+ # * `AWS:EC2::HostManagement`
778
878
  #
779
879
  # @option params [Integer] :max_results
780
880
  # The total number of results that you want included on each page of the
@@ -836,10 +936,80 @@ module Aws::ResourceGroups
836
936
  req.send_request(options)
837
937
  end
838
938
 
939
+ # Attaches a service configuration to the specified group. This occurs
940
+ # asynchronously, and can take time to complete. You can use
941
+ # GetGroupConfiguration to check the status of the update.
942
+ #
943
+ # **Minimum permissions**
944
+ #
945
+ # To run this command, you must have the following permissions:
946
+ #
947
+ # * `resource-groups:PutGroupConfiguration`
948
+ #
949
+ # ^
950
+ #
951
+ # @option params [String] :group
952
+ # The name or ARN of the resource group with the configuration that you
953
+ # want to update.
954
+ #
955
+ # @option params [Array<Types::GroupConfigurationItem>] :configuration
956
+ # The new configuration to associate with the specified group. A
957
+ # configuration associates the resource group with an AWS service and
958
+ # specifies how the service can interact with the resources in the
959
+ # group. A configuration is an array of GroupConfigurationItem elements.
960
+ #
961
+ # For information about the syntax of a service configuration, see
962
+ # [Service configurations for resource groups][1].
963
+ #
964
+ # <note markdown="1"> A resource group can contain either a `Configuration` or a
965
+ # `ResourceQuery`, but not both.
966
+ #
967
+ # </note>
968
+ #
969
+ #
970
+ #
971
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
972
+ #
973
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
974
+ #
975
+ # @example Request syntax with placeholder values
976
+ #
977
+ # resp = client.put_group_configuration({
978
+ # group: "GroupString",
979
+ # configuration: [
980
+ # {
981
+ # type: "GroupConfigurationType", # required
982
+ # parameters: [
983
+ # {
984
+ # name: "GroupConfigurationParameterName", # required
985
+ # values: ["GroupConfigurationParameterValue"],
986
+ # },
987
+ # ],
988
+ # },
989
+ # ],
990
+ # })
991
+ #
992
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/PutGroupConfiguration AWS API Documentation
993
+ #
994
+ # @overload put_group_configuration(params = {})
995
+ # @param [Hash] params ({})
996
+ def put_group_configuration(params = {}, options = {})
997
+ req = build_request(:put_group_configuration, params)
998
+ req.send_request(options)
999
+ end
1000
+
839
1001
  # Returns a list of AWS resource identifiers that matches the specified
840
1002
  # query. The query uses the same format as a resource query in a
841
1003
  # CreateGroup or UpdateGroupQuery operation.
842
1004
  #
1005
+ # **Minimum permissions**
1006
+ #
1007
+ # To run this command, you must have the following permissions:
1008
+ #
1009
+ # * `resource-groups:SearchResources`
1010
+ #
1011
+ # ^
1012
+ #
843
1013
  # @option params [required, Types::ResourceQuery] :resource_query
844
1014
  # The search query, using the same formats that are supported for
845
1015
  # resource group definition. For more information, see CreateGroup.
@@ -910,6 +1080,14 @@ module Aws::ResourceGroups
910
1080
  # you with billing and administration services. Tags are not intended to
911
1081
  # be used for private or sensitive data.
912
1082
  #
1083
+ # **Minimum permissions**
1084
+ #
1085
+ # To run this command, you must have the following permissions:
1086
+ #
1087
+ # * `resource-groups:Tag`
1088
+ #
1089
+ # ^
1090
+ #
913
1091
  # @option params [required, String] :arn
914
1092
  # The ARN of the resource group to which to add tags.
915
1093
  #
@@ -948,6 +1126,14 @@ module Aws::ResourceGroups
948
1126
 
949
1127
  # Removes the specified resources from the specified group.
950
1128
  #
1129
+ # **Minimum permissions**
1130
+ #
1131
+ # To run this command, you must have the following permissions:
1132
+ #
1133
+ # * `resource-groups:UngroupResources`
1134
+ #
1135
+ # ^
1136
+ #
951
1137
  # @option params [required, String] :group
952
1138
  # The name or the ARN of the resource group from which to remove the
953
1139
  # resources.
@@ -959,6 +1145,7 @@ module Aws::ResourceGroups
959
1145
  #
960
1146
  # * {Types::UngroupResourcesOutput#succeeded #succeeded} => Array&lt;String&gt;
961
1147
  # * {Types::UngroupResourcesOutput#failed #failed} => Array&lt;Types::FailedResource&gt;
1148
+ # * {Types::UngroupResourcesOutput#pending #pending} => Array&lt;Types::PendingResource&gt;
962
1149
  #
963
1150
  # @example Request syntax with placeholder values
964
1151
  #
@@ -975,6 +1162,8 @@ module Aws::ResourceGroups
975
1162
  # resp.failed[0].resource_arn #=> String
976
1163
  # resp.failed[0].error_message #=> String
977
1164
  # resp.failed[0].error_code #=> String
1165
+ # resp.pending #=> Array
1166
+ # resp.pending[0].resource_arn #=> String
978
1167
  #
979
1168
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UngroupResources AWS API Documentation
980
1169
  #
@@ -987,6 +1176,14 @@ module Aws::ResourceGroups
987
1176
 
988
1177
  # Deletes tags from a specified resource group.
989
1178
  #
1179
+ # **Minimum permissions**
1180
+ #
1181
+ # To run this command, you must have the following permissions:
1182
+ #
1183
+ # * `resource-groups:Untag`
1184
+ #
1185
+ # ^
1186
+ #
990
1187
  # @option params [required, String] :arn
991
1188
  # The ARN of the resource group from which to remove tags. The command
992
1189
  # removed both the specified keys and any values associated with those
@@ -1025,6 +1222,14 @@ module Aws::ResourceGroups
1025
1222
  # Updates the description for an existing group. You cannot update the
1026
1223
  # name of a resource group.
1027
1224
  #
1225
+ # **Minimum permissions**
1226
+ #
1227
+ # To run this command, you must have the following permissions:
1228
+ #
1229
+ # * `resource-groups:UpdateGroup`
1230
+ #
1231
+ # ^
1232
+ #
1028
1233
  # @option params [String] :group_name
1029
1234
  # Don't use this parameter. Use `Group` instead.
1030
1235
  #
@@ -1063,7 +1268,21 @@ module Aws::ResourceGroups
1063
1268
  req.send_request(options)
1064
1269
  end
1065
1270
 
1066
- # Updates the resource query of a group.
1271
+ # Updates the resource query of a group. For more information about
1272
+ # resource queries, see [Create a tag-based group in Resource
1273
+ # Groups][1].
1274
+ #
1275
+ # **Minimum permissions**
1276
+ #
1277
+ # To run this command, you must have the following permissions:
1278
+ #
1279
+ # * `resource-groups:UpdateGroupQuery`
1280
+ #
1281
+ # ^
1282
+ #
1283
+ #
1284
+ #
1285
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag
1067
1286
  #
1068
1287
  # @option params [String] :group_name
1069
1288
  # Don't use this parameter. Use `Group` instead.
@@ -1075,6 +1294,11 @@ module Aws::ResourceGroups
1075
1294
  # The resource query to determine which AWS resources are members of
1076
1295
  # this resource group.
1077
1296
  #
1297
+ # <note markdown="1"> A resource group can contain either a `Configuration` or a
1298
+ # `ResourceQuery`, but not both.
1299
+ #
1300
+ # </note>
1301
+ #
1078
1302
  # @return [Types::UpdateGroupQueryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1079
1303
  #
1080
1304
  # * {Types::UpdateGroupQueryOutput#group_query #group_query} => Types::GroupQuery
@@ -1118,7 +1342,7 @@ module Aws::ResourceGroups
1118
1342
  params: params,
1119
1343
  config: config)
1120
1344
  context[:gem_name] = 'aws-sdk-resourcegroups'
1121
- context[:gem_version] = '1.32.0'
1345
+ context[:gem_version] = '1.33.0'
1122
1346
  Seahorse::Client::Request.new(handlers, context)
1123
1347
  end
1124
1348
 
@@ -60,6 +60,8 @@ module Aws::ResourceGroups
60
60
  GroupString = Shapes::StringShape.new(name: 'GroupString')
61
61
  InternalServerErrorException = Shapes::StructureShape.new(name: 'InternalServerErrorException')
62
62
  ListGroupResourcesInput = Shapes::StructureShape.new(name: 'ListGroupResourcesInput')
63
+ ListGroupResourcesItem = Shapes::StructureShape.new(name: 'ListGroupResourcesItem')
64
+ ListGroupResourcesItemList = Shapes::ListShape.new(name: 'ListGroupResourcesItemList')
63
65
  ListGroupResourcesOutput = Shapes::StructureShape.new(name: 'ListGroupResourcesOutput')
64
66
  ListGroupsInput = Shapes::StructureShape.new(name: 'ListGroupsInput')
65
67
  ListGroupsOutput = Shapes::StructureShape.new(name: 'ListGroupsOutput')
@@ -67,6 +69,10 @@ module Aws::ResourceGroups
67
69
  MethodNotAllowedException = Shapes::StructureShape.new(name: 'MethodNotAllowedException')
68
70
  NextToken = Shapes::StringShape.new(name: 'NextToken')
69
71
  NotFoundException = Shapes::StructureShape.new(name: 'NotFoundException')
72
+ PendingResource = Shapes::StructureShape.new(name: 'PendingResource')
73
+ PendingResourceList = Shapes::ListShape.new(name: 'PendingResourceList')
74
+ PutGroupConfigurationInput = Shapes::StructureShape.new(name: 'PutGroupConfigurationInput')
75
+ PutGroupConfigurationOutput = Shapes::StructureShape.new(name: 'PutGroupConfigurationOutput')
70
76
  Query = Shapes::StringShape.new(name: 'Query')
71
77
  QueryError = Shapes::StructureShape.new(name: 'QueryError')
72
78
  QueryErrorCode = Shapes::StringShape.new(name: 'QueryErrorCode')
@@ -83,6 +89,8 @@ module Aws::ResourceGroups
83
89
  ResourceIdentifier = Shapes::StructureShape.new(name: 'ResourceIdentifier')
84
90
  ResourceIdentifierList = Shapes::ListShape.new(name: 'ResourceIdentifierList')
85
91
  ResourceQuery = Shapes::StructureShape.new(name: 'ResourceQuery')
92
+ ResourceStatus = Shapes::StructureShape.new(name: 'ResourceStatus')
93
+ ResourceStatusValue = Shapes::StringShape.new(name: 'ResourceStatusValue')
86
94
  ResourceType = Shapes::StringShape.new(name: 'ResourceType')
87
95
  SearchResourcesInput = Shapes::StructureShape.new(name: 'SearchResourcesInput')
88
96
  SearchResourcesOutput = Shapes::StructureShape.new(name: 'SearchResourcesOutput')
@@ -214,6 +222,7 @@ module Aws::ResourceGroups
214
222
 
215
223
  GroupResourcesOutput.add_member(:succeeded, Shapes::ShapeRef.new(shape: ResourceArnList, location_name: "Succeeded"))
216
224
  GroupResourcesOutput.add_member(:failed, Shapes::ShapeRef.new(shape: FailedResourceList, location_name: "Failed"))
225
+ GroupResourcesOutput.add_member(:pending, Shapes::ShapeRef.new(shape: PendingResourceList, location_name: "Pending"))
217
226
  GroupResourcesOutput.struct_class = Types::GroupResourcesOutput
218
227
 
219
228
  InternalServerErrorException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
@@ -226,7 +235,14 @@ module Aws::ResourceGroups
226
235
  ListGroupResourcesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
227
236
  ListGroupResourcesInput.struct_class = Types::ListGroupResourcesInput
228
237
 
229
- ListGroupResourcesOutput.add_member(:resource_identifiers, Shapes::ShapeRef.new(shape: ResourceIdentifierList, location_name: "ResourceIdentifiers"))
238
+ ListGroupResourcesItem.add_member(:identifier, Shapes::ShapeRef.new(shape: ResourceIdentifier, location_name: "Identifier"))
239
+ ListGroupResourcesItem.add_member(:status, Shapes::ShapeRef.new(shape: ResourceStatus, location_name: "Status"))
240
+ ListGroupResourcesItem.struct_class = Types::ListGroupResourcesItem
241
+
242
+ ListGroupResourcesItemList.member = Shapes::ShapeRef.new(shape: ListGroupResourcesItem)
243
+
244
+ ListGroupResourcesOutput.add_member(:resources, Shapes::ShapeRef.new(shape: ListGroupResourcesItemList, location_name: "Resources"))
245
+ ListGroupResourcesOutput.add_member(:resource_identifiers, Shapes::ShapeRef.new(shape: ResourceIdentifierList, deprecated: true, location_name: "ResourceIdentifiers", metadata: {"deprecatedMessage"=>"This field is deprecated, use Resources instead."}))
230
246
  ListGroupResourcesOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
231
247
  ListGroupResourcesOutput.add_member(:query_errors, Shapes::ShapeRef.new(shape: QueryErrorList, location_name: "QueryErrors"))
232
248
  ListGroupResourcesOutput.struct_class = Types::ListGroupResourcesOutput
@@ -247,6 +263,17 @@ module Aws::ResourceGroups
247
263
  NotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
248
264
  NotFoundException.struct_class = Types::NotFoundException
249
265
 
266
+ PendingResource.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, location_name: "ResourceArn"))
267
+ PendingResource.struct_class = Types::PendingResource
268
+
269
+ PendingResourceList.member = Shapes::ShapeRef.new(shape: PendingResource)
270
+
271
+ PutGroupConfigurationInput.add_member(:group, Shapes::ShapeRef.new(shape: GroupString, location_name: "Group"))
272
+ PutGroupConfigurationInput.add_member(:configuration, Shapes::ShapeRef.new(shape: GroupConfigurationList, location_name: "Configuration"))
273
+ PutGroupConfigurationInput.struct_class = Types::PutGroupConfigurationInput
274
+
275
+ PutGroupConfigurationOutput.struct_class = Types::PutGroupConfigurationOutput
276
+
250
277
  QueryError.add_member(:error_code, Shapes::ShapeRef.new(shape: QueryErrorCode, location_name: "ErrorCode"))
251
278
  QueryError.add_member(:message, Shapes::ShapeRef.new(shape: QueryErrorMessage, location_name: "Message"))
252
279
  QueryError.struct_class = Types::QueryError
@@ -273,6 +300,9 @@ module Aws::ResourceGroups
273
300
  ResourceQuery.add_member(:query, Shapes::ShapeRef.new(shape: Query, required: true, location_name: "Query"))
274
301
  ResourceQuery.struct_class = Types::ResourceQuery
275
302
 
303
+ ResourceStatus.add_member(:name, Shapes::ShapeRef.new(shape: ResourceStatusValue, location_name: "Name"))
304
+ ResourceStatus.struct_class = Types::ResourceStatus
305
+
276
306
  SearchResourcesInput.add_member(:resource_query, Shapes::ShapeRef.new(shape: ResourceQuery, required: true, location_name: "ResourceQuery"))
277
307
  SearchResourcesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
278
308
  SearchResourcesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
@@ -308,6 +338,7 @@ module Aws::ResourceGroups
308
338
 
309
339
  UngroupResourcesOutput.add_member(:succeeded, Shapes::ShapeRef.new(shape: ResourceArnList, location_name: "Succeeded"))
310
340
  UngroupResourcesOutput.add_member(:failed, Shapes::ShapeRef.new(shape: FailedResourceList, location_name: "Failed"))
341
+ UngroupResourcesOutput.add_member(:pending, Shapes::ShapeRef.new(shape: PendingResourceList, location_name: "Pending"))
311
342
  UngroupResourcesOutput.struct_class = Types::UngroupResourcesOutput
312
343
 
313
344
  UntagInput.add_member(:arn, Shapes::ShapeRef.new(shape: GroupArn, required: true, location: "uri", location_name: "Arn"))
@@ -489,6 +520,20 @@ module Aws::ResourceGroups
489
520
  )
490
521
  end)
491
522
 
523
+ api.add_operation(:put_group_configuration, Seahorse::Model::Operation.new.tap do |o|
524
+ o.name = "PutGroupConfiguration"
525
+ o.http_method = "POST"
526
+ o.http_request_uri = "/put-group-configuration"
527
+ o.input = Shapes::ShapeRef.new(shape: PutGroupConfigurationInput)
528
+ o.output = Shapes::ShapeRef.new(shape: PutGroupConfigurationOutput)
529
+ o.errors << Shapes::ShapeRef.new(shape: BadRequestException)
530
+ o.errors << Shapes::ShapeRef.new(shape: ForbiddenException)
531
+ o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
532
+ o.errors << Shapes::ShapeRef.new(shape: MethodNotAllowedException)
533
+ o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
534
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerErrorException)
535
+ end)
536
+
492
537
  api.add_operation(:search_resources, Seahorse::Model::Operation.new.tap do |o|
493
538
  o.name = "SearchResources"
494
539
  o.http_method = "POST"
@@ -66,12 +66,17 @@ module Aws::ResourceGroups
66
66
  #
67
67
  # @!attribute [rw] resource_query
68
68
  # The resource query that determines which AWS resources are members
69
- # of this group.
69
+ # of this group. For more information about resource queries, see
70
+ # [Create a tag-based group in Resource Groups][1].
70
71
  #
71
- # <note markdown="1"> You can specify either a `ResourceQuery` or a `Configuration`, but
72
- # not both.
72
+ # <note markdown="1"> A resource group can contain either a `ResourceQuery` or a
73
+ # `Configuration`, but not both.
73
74
  #
74
75
  # </note>
76
+ #
77
+ #
78
+ #
79
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag
75
80
  # @return [Types::ResourceQuery]
76
81
  #
77
82
  # @!attribute [rw] tags
@@ -82,12 +87,17 @@ module Aws::ResourceGroups
82
87
  # A configuration associates the resource group with an AWS service
83
88
  # and specifies how the service can interact with the resources in the
84
89
  # group. A configuration is an array of GroupConfigurationItem
85
- # elements.
90
+ # elements. For details about the syntax of service configurations,
91
+ # see [Service configurations for resource groups][1].
86
92
  #
87
- # <note markdown="1"> You can specify either a `Configuration` or a `ResourceQuery` in a
88
- # group, but not both.
93
+ # <note markdown="1"> A resource group can contain either a `Configuration` or a
94
+ # `ResourceQuery`, but not both.
89
95
  #
90
96
  # </note>
97
+ #
98
+ #
99
+ #
100
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
91
101
  # @return [Array<Types::GroupConfigurationItem>]
92
102
  #
93
103
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/CreateGroupInput AWS API Documentation
@@ -107,7 +117,13 @@ module Aws::ResourceGroups
107
117
  # @return [Types::Group]
108
118
  #
109
119
  # @!attribute [rw] resource_query
110
- # The resource query associated with the group.
120
+ # The resource query associated with the group. For more information
121
+ # about resource queries, see [Create a tag-based group in Resource
122
+ # Groups][1].
123
+ #
124
+ #
125
+ #
126
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag
111
127
  # @return [Types::ResourceQuery]
112
128
  #
113
129
  # @!attribute [rw] tags
@@ -115,19 +131,13 @@ module Aws::ResourceGroups
115
131
  # @return [Hash<String,String>]
116
132
  #
117
133
  # @!attribute [rw] group_configuration
118
- # The service configuration associated with the resource group. AWS
119
- # Resource Groups supports adding service configurations for the
120
- # following resource group types:
121
- #
122
- # * `AWS::EC2::CapacityReservationPool` - Amazon EC2 capacity
123
- # reservation pools. For more information, see [Working with
124
- # capacity reservation groups][1] in the *EC2 Users Guide*.
125
- #
126
- # ^
134
+ # The service configuration associated with the resource group. For
135
+ # details about the syntax of a service configuration, see [Service
136
+ # configurations for resource groups][1].
127
137
  #
128
138
  #
129
139
  #
130
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#create-cr-group
140
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
131
141
  # @return [Types::GroupConfiguration]
132
142
  #
133
143
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/CreateGroupOutput AWS API Documentation
@@ -150,7 +160,7 @@ module Aws::ResourceGroups
150
160
  # }
151
161
  #
152
162
  # @!attribute [rw] group_name
153
- # Don't use this parameter. Use `Group` instead.
163
+ # Deprecated - don't use this parameter. Use `Group` instead.
154
164
  # @return [String]
155
165
  #
156
166
  # @!attribute [rw] group
@@ -235,7 +245,13 @@ module Aws::ResourceGroups
235
245
  end
236
246
 
237
247
  # @!attribute [rw] group_configuration
238
- # The configuration associated with the specified group.
248
+ # The service configuration associated with the specified group. For
249
+ # details about the service configuration syntax, see [Service
250
+ # configurations for resource groups][1].
251
+ #
252
+ #
253
+ #
254
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
239
255
  # @return [Types::GroupConfiguration]
240
256
  #
241
257
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroupConfigurationOutput AWS API Documentation
@@ -255,7 +271,7 @@ module Aws::ResourceGroups
255
271
  # }
256
272
  #
257
273
  # @!attribute [rw] group_name
258
- # Don't use this parameter. Use `Group` instead.
274
+ # Deprecated - don't use this parameter. Use `Group` instead.
259
275
  # @return [String]
260
276
  #
261
277
  # @!attribute [rw] group
@@ -309,7 +325,13 @@ module Aws::ResourceGroups
309
325
  end
310
326
 
311
327
  # @!attribute [rw] group_query
312
- # The resource query associated with the specified group.
328
+ # The resource query associated with the specified group. For more
329
+ # information about resource queries, see [Create a tag-based group in
330
+ # Resource Groups][1].
331
+ #
332
+ #
333
+ #
334
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#gettingstarted-query-cli-tag
313
335
  # @return [Types::GroupQuery]
314
336
  #
315
337
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroupQueryOutput AWS API Documentation
@@ -363,7 +385,8 @@ module Aws::ResourceGroups
363
385
  # * ResourceQuery - Use a resource query to specify a set of tag keys
364
386
  # and values. All resources in the same AWS Region and AWS account
365
387
  # that have those keys with the same values are included in the group.
366
- # You can add a resource query when you create the group.
388
+ # You can add a resource query when you create the group, or later by
389
+ # using the PutGroupConfiguration operation.
367
390
  #
368
391
  # * GroupConfiguration - Use a service configuration to associate the
369
392
  # group with an AWS service. The configuration specifies which
@@ -394,7 +417,14 @@ module Aws::ResourceGroups
394
417
  # A service configuration associated with a resource group. The
395
418
  # configuration options are determined by the AWS service that defines
396
419
  # the `Type`, and specifies which resources can be included in the
397
- # group. You can add a service configuration when you create the group.
420
+ # group. You can add a service configuration when you create the group
421
+ # by using CreateGroup, or later by using the PutGroupConfiguration
422
+ # operation. For details about group service configuration syntax, see
423
+ # [Service configurations for resource groups][1].
424
+ #
425
+ #
426
+ #
427
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
398
428
  #
399
429
  # @!attribute [rw] configuration
400
430
  # The configuration currently associated with the group and in effect.
@@ -425,8 +455,13 @@ module Aws::ResourceGroups
425
455
  include Aws::Structure
426
456
  end
427
457
 
428
- # An item in a group configuration. A group configuration can have one
429
- # or more items.
458
+ # An item in a group configuration. A group service configuration can
459
+ # have one or more items. For details about group service configuration
460
+ # syntax, see [Service configurations for resource groups][1].
461
+ #
462
+ #
463
+ #
464
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
430
465
  #
431
466
  # @note When making an API call, you may pass GroupConfigurationItem
432
467
  # data as a hash:
@@ -443,26 +478,23 @@ module Aws::ResourceGroups
443
478
  #
444
479
  # @!attribute [rw] type
445
480
  # Specifies the type of group configuration item. Each item must have
446
- # a unique value for `type`.
481
+ # a unique value for `type`. For the list of types that you can
482
+ # specify for a configuration item, see [Supported resource types and
483
+ # parameters][1].
447
484
  #
448
- # You can specify the following string values:
449
485
  #
450
- # * `AWS::EC2::CapacityReservationPool`
451
486
  #
452
- # For more information about EC2 capacity reservation groups, see
453
- # [Working with capacity reservation groups][1] in the *EC2 Users
454
- # Guide*.
455
- #
456
- # * `AWS::ResourceGroups::Generic` - Supports parameters that
457
- # configure the behavior of resource groups of any type.
487
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types
488
+ # @return [String]
458
489
  #
490
+ # @!attribute [rw] parameters
491
+ # A collection of parameters for this group configuration item. For
492
+ # the list of parameters that you can use with each configuration item
493
+ # type, see [Supported resource types and parameters][1].
459
494
  #
460
495
  #
461
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#create-cr-group
462
- # @return [String]
463
496
  #
464
- # @!attribute [rw] parameters
465
- # A collection of parameters for this group configuration item.
497
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types
466
498
  # @return [Array<Types::GroupConfigurationParameter>]
467
499
  #
468
500
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GroupConfigurationItem AWS API Documentation
@@ -474,7 +506,13 @@ module Aws::ResourceGroups
474
506
  include Aws::Structure
475
507
  end
476
508
 
477
- # A parameter for a group configuration item.
509
+ # A parameter for a group configuration item. For details about group
510
+ # service configuration syntax, see [Service configurations for resource
511
+ # groups][1].
512
+ #
513
+ #
514
+ #
515
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
478
516
  #
479
517
  # @note When making an API call, you may pass GroupConfigurationParameter
480
518
  # data as a hash:
@@ -485,42 +523,23 @@ module Aws::ResourceGroups
485
523
  # }
486
524
  #
487
525
  # @!attribute [rw] name
488
- # The name of the group configuration parameter.
489
- #
490
- # You can specify the following string values:
491
- #
492
- # * For configuration item type `AWS::ResourceGroups::Generic`\:
493
- #
494
- # * `allowed-resource-types`
495
- #
496
- # Specifies the types of resources that you can add to this group
497
- # by using the GroupResources operation.
498
- #
499
- # * For configuration item type `AWS::EC2::CapacityReservationPool`\:
500
- #
501
- # * None - This configuration item type doesn't support any
502
- # parameters.
526
+ # The name of the group configuration parameter. For the list of
527
+ # parameters that you can use with each configuration item type, see
528
+ # [Supported resource types and parameters][1].
503
529
  #
504
- # ^
505
530
  #
506
- # For more information about EC2 capacity reservation groups, see
507
- # [Working with capacity reservation groups][1] in the *EC2 Users
508
- # Guide*.
509
531
  #
510
- #
511
- #
512
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#create-cr-group
532
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types
513
533
  # @return [String]
514
534
  #
515
535
  # @!attribute [rw] values
516
- # The values of for this parameter.
536
+ # The value or values to be used for the specified parameter. For the
537
+ # list of values you can use with each parameter, see [Supported
538
+ # resource types and parameters][1].
517
539
  #
518
- # You can specify the following string value:
519
540
  #
520
- # * For item type `allowed-resource-types`\: the only supported
521
- # parameter value is `AWS::EC2::CapacityReservation`.
522
541
  #
523
- # ^
542
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types
524
543
  # @return [Array<String>]
525
544
  #
526
545
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GroupConfigurationParameter AWS API Documentation
@@ -628,20 +647,30 @@ module Aws::ResourceGroups
628
647
  end
629
648
 
630
649
  # @!attribute [rw] succeeded
631
- # The ARNs of the resources that were successfully added to the group
632
- # by this operation.
650
+ # A list of ARNs of resources that were successfully added to the
651
+ # group by this operation.
633
652
  # @return [Array<String>]
634
653
  #
635
654
  # @!attribute [rw] failed
636
- # The ARNs of the resources that failed to be added to the group by
637
- # this operation.
655
+ # A list of ARNs of any resources that failed to be added to the group
656
+ # by this operation.
638
657
  # @return [Array<Types::FailedResource>]
639
658
  #
659
+ # @!attribute [rw] pending
660
+ # A list of ARNs of any resources that are still in the process of
661
+ # being added to the group by this operation. These pending additions
662
+ # continue asynchronously. You can check the status of pending
663
+ # additions by using the ` ListGroupResources ` operation, and
664
+ # checking the `Resources` array in the response and the `Status`
665
+ # field of each object in that array.
666
+ # @return [Array<Types::PendingResource>]
667
+ #
640
668
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GroupResourcesOutput AWS API Documentation
641
669
  #
642
670
  class GroupResourcesOutput < Struct.new(
643
671
  :succeeded,
644
- :failed)
672
+ :failed,
673
+ :pending)
645
674
  SENSITIVE = []
646
675
  include Aws::Structure
647
676
  end
@@ -677,7 +706,8 @@ module Aws::ResourceGroups
677
706
  # }
678
707
  #
679
708
  # @!attribute [rw] group_name
680
- # Don't use this parameter. Use `Group` instead.
709
+ # <i> <b>Deprecated - don't use this parameter. Use the
710
+ # <code>Group</code> request field instead.</b> </i>
681
711
  # @return [String]
682
712
  #
683
713
  # @!attribute [rw] group
@@ -749,9 +779,42 @@ module Aws::ResourceGroups
749
779
  include Aws::Structure
750
780
  end
751
781
 
782
+ # A structure returned by the ListGroupResources operation that contains
783
+ # identity and group membership status information for one of the
784
+ # resources in the group.
785
+ #
786
+ # @!attribute [rw] identifier
787
+ # A structure that contains the ARN of a resource and its resource
788
+ # type.
789
+ # @return [Types::ResourceIdentifier]
790
+ #
791
+ # @!attribute [rw] status
792
+ # A structure that contains the status of this resource's membership
793
+ # in the group.
794
+ #
795
+ # <note markdown="1"> This field is present in the response only if the group is of type
796
+ # `AWS::EC2::HostManagement`.
797
+ #
798
+ # </note>
799
+ # @return [Types::ResourceStatus]
800
+ #
801
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListGroupResourcesItem AWS API Documentation
802
+ #
803
+ class ListGroupResourcesItem < Struct.new(
804
+ :identifier,
805
+ :status)
806
+ SENSITIVE = []
807
+ include Aws::Structure
808
+ end
809
+
810
+ # @!attribute [rw] resources
811
+ # An array of resources from which you can determine each resource's
812
+ # identity, type, and group membership status.
813
+ # @return [Array<Types::ListGroupResourcesItem>]
814
+ #
752
815
  # @!attribute [rw] resource_identifiers
753
- # The ARNs and resource types of resources that are members of the
754
- # group that you specified.
816
+ # <b> <i>Deprecated - don't use this parameter. Use the
817
+ # <code>Resources</code> response field instead.</i> </b>
755
818
  # @return [Array<Types::ResourceIdentifier>]
756
819
  #
757
820
  # @!attribute [rw] next_token
@@ -772,6 +835,7 @@ module Aws::ResourceGroups
772
835
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListGroupResourcesOutput AWS API Documentation
773
836
  #
774
837
  class ListGroupResourcesOutput < Struct.new(
838
+ :resources,
775
839
  :resource_identifiers,
776
840
  :next_token,
777
841
  :query_errors)
@@ -806,9 +870,9 @@ module Aws::ResourceGroups
806
870
  # groups that have the specified configuration types attached. The
807
871
  # current supported values are:
808
872
  #
809
- # * AWS:EC2::CapacityReservationPool
873
+ # * `AWS:EC2::CapacityReservationPool`
810
874
  #
811
- # ^
875
+ # * `AWS:EC2::HostManagement`
812
876
  # @return [Array<Types::GroupFilter>]
813
877
  #
814
878
  # @!attribute [rw] max_results
@@ -848,8 +912,8 @@ module Aws::ResourceGroups
848
912
  # @return [Array<Types::GroupIdentifier>]
849
913
  #
850
914
  # @!attribute [rw] groups
851
- # This output element is deprecated and shouldn't be used. Refer to
852
- # `GroupIdentifiers` instead.
915
+ # <i> <b>Deprecated - don't use this field. Use the
916
+ # <code>GroupIdentifiers</code> response field instead.</b> </i>
853
917
  # @return [Array<Types::Group>]
854
918
  #
855
919
  # @!attribute [rw] next_token
@@ -897,6 +961,80 @@ module Aws::ResourceGroups
897
961
  include Aws::Structure
898
962
  end
899
963
 
964
+ # A structure that identifies a resource that is currently pending
965
+ # addition to the group as a member. Adding a resource to a resource
966
+ # group happens asynchronously as a background task and this one isn't
967
+ # completed yet.
968
+ #
969
+ # @!attribute [rw] resource_arn
970
+ # The Amazon resource name (ARN) of the resource that's in a pending
971
+ # state.
972
+ # @return [String]
973
+ #
974
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/PendingResource AWS API Documentation
975
+ #
976
+ class PendingResource < Struct.new(
977
+ :resource_arn)
978
+ SENSITIVE = []
979
+ include Aws::Structure
980
+ end
981
+
982
+ # @note When making an API call, you may pass PutGroupConfigurationInput
983
+ # data as a hash:
984
+ #
985
+ # {
986
+ # group: "GroupString",
987
+ # configuration: [
988
+ # {
989
+ # type: "GroupConfigurationType", # required
990
+ # parameters: [
991
+ # {
992
+ # name: "GroupConfigurationParameterName", # required
993
+ # values: ["GroupConfigurationParameterValue"],
994
+ # },
995
+ # ],
996
+ # },
997
+ # ],
998
+ # }
999
+ #
1000
+ # @!attribute [rw] group
1001
+ # The name or ARN of the resource group with the configuration that
1002
+ # you want to update.
1003
+ # @return [String]
1004
+ #
1005
+ # @!attribute [rw] configuration
1006
+ # The new configuration to associate with the specified group. A
1007
+ # configuration associates the resource group with an AWS service and
1008
+ # specifies how the service can interact with the resources in the
1009
+ # group. A configuration is an array of GroupConfigurationItem
1010
+ # elements.
1011
+ #
1012
+ # For information about the syntax of a service configuration, see
1013
+ # [Service configurations for resource groups][1].
1014
+ #
1015
+ # <note markdown="1"> A resource group can contain either a `Configuration` or a
1016
+ # `ResourceQuery`, but not both.
1017
+ #
1018
+ # </note>
1019
+ #
1020
+ #
1021
+ #
1022
+ # [1]: https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html
1023
+ # @return [Array<Types::GroupConfigurationItem>]
1024
+ #
1025
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/PutGroupConfigurationInput AWS API Documentation
1026
+ #
1027
+ class PutGroupConfigurationInput < Struct.new(
1028
+ :group,
1029
+ :configuration)
1030
+ SENSITIVE = []
1031
+ include Aws::Structure
1032
+ end
1033
+
1034
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/PutGroupConfigurationOutput AWS API Documentation
1035
+ #
1036
+ class PutGroupConfigurationOutput < Aws::EmptyStructure; end
1037
+
900
1038
  # A two-part error structure that can occur in `ListGroupResources` or
901
1039
  # `SearchResources` operations on CloudFormation stack-based queries.
902
1040
  # The error occurs if the CloudFormation stack on which the query is
@@ -956,7 +1094,7 @@ module Aws::ResourceGroups
956
1094
  include Aws::Structure
957
1095
  end
958
1096
 
959
- # The ARN of a resource, and its resource type.
1097
+ # A structure that contains the ARN of a resource and its resource type.
960
1098
  #
961
1099
  # @!attribute [rw] resource_arn
962
1100
  # The ARN of a resource.
@@ -1111,6 +1249,23 @@ module Aws::ResourceGroups
1111
1249
  include Aws::Structure
1112
1250
  end
1113
1251
 
1252
+ # A structure that identifies the current group membership status for a
1253
+ # resource. Adding a resource to a resource group is performed
1254
+ # asynchronously as a background task. A `PENDING` status indicates, for
1255
+ # this resource, that the process isn't completed yet.
1256
+ #
1257
+ # @!attribute [rw] name
1258
+ # The current status.
1259
+ # @return [String]
1260
+ #
1261
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ResourceStatus AWS API Documentation
1262
+ #
1263
+ class ResourceStatus < Struct.new(
1264
+ :name)
1265
+ SENSITIVE = []
1266
+ include Aws::Structure
1267
+ end
1268
+
1114
1269
  # @note When making an API call, you may pass SearchResourcesInput
1115
1270
  # data as a hash:
1116
1271
  #
@@ -1289,19 +1444,30 @@ module Aws::ResourceGroups
1289
1444
  end
1290
1445
 
1291
1446
  # @!attribute [rw] succeeded
1292
- # The ARNs of the resources that were successfully removed from the
1293
- # group.
1447
+ # A list of resources that were successfully removed from the group by
1448
+ # this operation.
1294
1449
  # @return [Array<String>]
1295
1450
  #
1296
1451
  # @!attribute [rw] failed
1297
- # The resources that failed to be removed from the group.
1452
+ # A list of any resources that failed to be removed from the group by
1453
+ # this operation.
1298
1454
  # @return [Array<Types::FailedResource>]
1299
1455
  #
1456
+ # @!attribute [rw] pending
1457
+ # A list of any resources that are still in the process of being
1458
+ # removed from the group by this operation. These pending removals
1459
+ # continue asynchronously. You can check the status of pending
1460
+ # removals by using the ` ListGroupResources ` operation. After the
1461
+ # resource is successfully removed, it no longer appears in the
1462
+ # response.
1463
+ # @return [Array<Types::PendingResource>]
1464
+ #
1300
1465
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UngroupResourcesOutput AWS API Documentation
1301
1466
  #
1302
1467
  class UngroupResourcesOutput < Struct.new(
1303
1468
  :succeeded,
1304
- :failed)
1469
+ :failed,
1470
+ :pending)
1305
1471
  SENSITIVE = []
1306
1472
  include Aws::Structure
1307
1473
  end
@@ -1418,6 +1584,11 @@ module Aws::ResourceGroups
1418
1584
  # @!attribute [rw] resource_query
1419
1585
  # The resource query to determine which AWS resources are members of
1420
1586
  # this resource group.
1587
+ #
1588
+ # <note markdown="1"> A resource group can contain either a `Configuration` or a
1589
+ # `ResourceQuery`, but not both.
1590
+ #
1591
+ # </note>
1421
1592
  # @return [Types::ResourceQuery]
1422
1593
  #
1423
1594
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UpdateGroupQueryInput AWS API Documentation
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-resourcegroups
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.32.0
4
+ version: 1.33.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: 2020-09-30 00:00:00.000000000 Z
11
+ date: 2020-12-23 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core