aws-sdk-resourcegroups 1.26.0 → 1.27.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: d0e691d2c0a24b1fbf5dbfdd60ebbeb2ea92d8eea8f6c25b8af0ad9f1e3e8695
4
- data.tar.gz: c050b10a3ebf3acd446fb9e86c810d7cde98cb77e3e600fdec03208cc5557c3f
3
+ metadata.gz: d11deac8aab073e36e5c1f6ed18e872b6e532cddbede52d9a6eea6e6e39d24f1
4
+ data.tar.gz: c846995796d93f43edf31e8a61b0b152f6a6fa2b44fb785b576151586fa7fb02
5
5
  SHA512:
6
- metadata.gz: e47b6689e9e328569a02e7bcf64dcca407a0dbeaff23e658fc0536527fc264019d84786bd02c24fd39508a5f561fb60cc15d47ae62be6a44be6efbaaa943bd5e
7
- data.tar.gz: a8b7b1518803c1546a11884cf6b39ba16556a2fcdcc0df67394e40e9e1ef8f88477b4cea0dae8cdf989a39430257233918efd50945be542d6154fbd1860a8476
6
+ metadata.gz: 57b6f38164521ee6695549f76e12e8880ec4dedf4c8fc4564f8cd4ff291cca6b9129858a527dc8ab2432508c971ba209ac665b8cc6f8ace3c4e57ea4716f80ab
7
+ data.tar.gz: bf6d5bc545861c81229f61123123bc7b74f242c72d4ada99248c02153e5a26963283ac5e924818a6d3523cdb56ec0e6eeb4fc40c90eda783015f16ecf7d784cd
@@ -47,6 +47,6 @@ require_relative 'aws-sdk-resourcegroups/customizations'
47
47
  # @service
48
48
  module Aws::ResourceGroups
49
49
 
50
- GEM_VERSION = '1.26.0'
50
+ GEM_VERSION = '1.27.0'
51
51
 
52
52
  end
@@ -312,50 +312,73 @@ module Aws::ResourceGroups
312
312
 
313
313
  # @!group API Operations
314
314
 
315
- # Creates a group with a specified name, description, and resource
316
- # query.
315
+ # Creates a resource group with the specified name and description. You
316
+ # can optionally include a resource query, or a service configuration.
317
317
  #
318
318
  # @option params [required, String] :name
319
319
  # The name of the group, which is the identifier of the group in other
320
- # operations. A resource group name cannot be updated after it is
321
- # created. A resource group name can have a maximum of 128 characters,
322
- # including letters, numbers, hyphens, dots, and underscores. The name
323
- # cannot start with `AWS` or `aws`; these are reserved. A resource group
324
- # name must be unique within your account.
320
+ # operations. You can't change the name of a resource group after you
321
+ # create it. A resource group name can consist of letters, numbers,
322
+ # hyphens, periods, and underscores. The name cannot start with `AWS` or
323
+ # `aws`; these are reserved. A resource group name must be unique within
324
+ # each AWS Region in your AWS account.
325
325
  #
326
326
  # @option params [String] :description
327
- # The description of the resource group. Descriptions can have a maximum
328
- # of 511 characters, including letters, numbers, hyphens, underscores,
329
- # punctuation, and spaces.
327
+ # The description of the resource group. Descriptions can consist of
328
+ # letters, numbers, hyphens, underscores, periods, and spaces.
330
329
  #
331
- # @option params [required, Types::ResourceQuery] :resource_query
330
+ # @option params [Types::ResourceQuery] :resource_query
332
331
  # The resource query that determines which AWS resources are members of
333
332
  # this group.
334
333
  #
334
+ # <note markdown="1"> You can specify either a `ResourceQuery` or a `Configuration`, but not
335
+ # both.
336
+ #
337
+ # </note>
338
+ #
335
339
  # @option params [Hash<String,String>] :tags
336
- # The tags to add to the group. A tag is a string-to-string map of
337
- # key-value pairs. Tag keys can have a maximum character length of 128
338
- # characters, and tag values can have a maximum length of 256
339
- # characters.
340
+ # The tags to add to the group. A tag is key-value pair string.
341
+ #
342
+ # @option params [Array<Types::GroupConfigurationItem>] :configuration
343
+ # A configuration associates the resource group with an AWS service and
344
+ # specifies how the service can interact with the resources in the
345
+ # group. A configuration is an array of GroupConfigurationItem elements.
346
+ #
347
+ # <note markdown="1"> You can specify either a `Configuration` or a `ResourceQuery` in a
348
+ # group, but not both.
349
+ #
350
+ # </note>
340
351
  #
341
352
  # @return [Types::CreateGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
342
353
  #
343
354
  # * {Types::CreateGroupOutput#group #group} => Types::Group
344
355
  # * {Types::CreateGroupOutput#resource_query #resource_query} => Types::ResourceQuery
345
356
  # * {Types::CreateGroupOutput#tags #tags} => Hash&lt;String,String&gt;
357
+ # * {Types::CreateGroupOutput#group_configuration #group_configuration} => Types::GroupConfiguration
346
358
  #
347
359
  # @example Request syntax with placeholder values
348
360
  #
349
361
  # resp = client.create_group({
350
362
  # name: "GroupName", # required
351
- # description: "GroupDescription",
352
- # resource_query: { # required
363
+ # description: "Description",
364
+ # resource_query: {
353
365
  # type: "TAG_FILTERS_1_0", # required, accepts TAG_FILTERS_1_0, CLOUDFORMATION_STACK_1_0
354
366
  # query: "Query", # required
355
367
  # },
356
368
  # tags: {
357
369
  # "TagKey" => "TagValue",
358
370
  # },
371
+ # configuration: [
372
+ # {
373
+ # type: "GroupConfigurationType", # required
374
+ # parameters: [
375
+ # {
376
+ # name: "GroupConfigurationParameterName", # required
377
+ # values: ["GroupConfigurationParameterValue"],
378
+ # },
379
+ # ],
380
+ # },
381
+ # ],
359
382
  # })
360
383
  #
361
384
  # @example Response structure
@@ -367,6 +390,20 @@ module Aws::ResourceGroups
367
390
  # resp.resource_query.query #=> String
368
391
  # resp.tags #=> Hash
369
392
  # resp.tags["TagKey"] #=> String
393
+ # resp.group_configuration.configuration #=> Array
394
+ # resp.group_configuration.configuration[0].type #=> String
395
+ # resp.group_configuration.configuration[0].parameters #=> Array
396
+ # resp.group_configuration.configuration[0].parameters[0].name #=> String
397
+ # resp.group_configuration.configuration[0].parameters[0].values #=> Array
398
+ # resp.group_configuration.configuration[0].parameters[0].values[0] #=> String
399
+ # resp.group_configuration.proposed_configuration #=> Array
400
+ # resp.group_configuration.proposed_configuration[0].type #=> String
401
+ # resp.group_configuration.proposed_configuration[0].parameters #=> Array
402
+ # resp.group_configuration.proposed_configuration[0].parameters[0].name #=> String
403
+ # resp.group_configuration.proposed_configuration[0].parameters[0].values #=> Array
404
+ # resp.group_configuration.proposed_configuration[0].parameters[0].values[0] #=> String
405
+ # resp.group_configuration.status #=> String, one of "UPDATING", "UPDATE_COMPLETE", "UPDATE_FAILED"
406
+ # resp.group_configuration.failure_reason #=> String
370
407
  #
371
408
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/CreateGroup AWS API Documentation
372
409
  #
@@ -377,12 +414,15 @@ module Aws::ResourceGroups
377
414
  req.send_request(options)
378
415
  end
379
416
 
380
- # Deletes a specified resource group. Deleting a resource group does not
381
- # delete resources that are members of the group; it only deletes the
382
- # group structure.
417
+ # Deletes the specified resource group. Deleting a resource group does
418
+ # not delete any resources that are members of the group; it only
419
+ # deletes the group structure.
383
420
  #
384
- # @option params [required, String] :group_name
385
- # The name of the resource group to delete.
421
+ # @option params [String] :group_name
422
+ # Don't use this parameter. Use `Group` instead.
423
+ #
424
+ # @option params [String] :group
425
+ # The name or the ARN of the resource group to delete.
386
426
  #
387
427
  # @return [Types::DeleteGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
388
428
  #
@@ -391,7 +431,8 @@ module Aws::ResourceGroups
391
431
  # @example Request syntax with placeholder values
392
432
  #
393
433
  # resp = client.delete_group({
394
- # group_name: "GroupName", # required
434
+ # group_name: "GroupName",
435
+ # group: "GroupString",
395
436
  # })
396
437
  #
397
438
  # @example Response structure
@@ -411,8 +452,11 @@ module Aws::ResourceGroups
411
452
 
412
453
  # Returns information about a specified resource group.
413
454
  #
414
- # @option params [required, String] :group_name
415
- # The name of the resource group.
455
+ # @option params [String] :group_name
456
+ # Don't use this parameter. Use `Group` instead.
457
+ #
458
+ # @option params [String] :group
459
+ # The name or the ARN of the resource group to retrieve.
416
460
  #
417
461
  # @return [Types::GetGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
418
462
  #
@@ -421,7 +465,8 @@ module Aws::ResourceGroups
421
465
  # @example Request syntax with placeholder values
422
466
  #
423
467
  # resp = client.get_group({
424
- # group_name: "GroupName", # required
468
+ # group_name: "GroupName",
469
+ # group: "GroupString",
425
470
  # })
426
471
  #
427
472
  # @example Response structure
@@ -439,11 +484,67 @@ module Aws::ResourceGroups
439
484
  req.send_request(options)
440
485
  end
441
486
 
442
- # Returns the resource query associated with the specified resource
487
+ # Returns the service configuration associated with the specified
488
+ # resource group. AWS Resource Groups supports configurations for the
489
+ # following resource group types:
490
+ #
491
+ # * `AWS::EC2::CapacityReservationPool` - Amazon EC2 capacity
492
+ # reservation pools. For more information, see [Working with capacity
493
+ # reservation groups][1] in the *EC2 Users Guide*.
494
+ #
495
+ # ^
496
+ #
497
+ #
498
+ #
499
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#create-cr-group
500
+ #
501
+ # @option params [String] :group
502
+ # The name or the ARN of the resource group.
503
+ #
504
+ # @return [Types::GetGroupConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
505
+ #
506
+ # * {Types::GetGroupConfigurationOutput#group_configuration #group_configuration} => Types::GroupConfiguration
507
+ #
508
+ # @example Request syntax with placeholder values
509
+ #
510
+ # resp = client.get_group_configuration({
511
+ # group: "GroupString",
512
+ # })
513
+ #
514
+ # @example Response structure
515
+ #
516
+ # resp.group_configuration.configuration #=> Array
517
+ # resp.group_configuration.configuration[0].type #=> String
518
+ # resp.group_configuration.configuration[0].parameters #=> Array
519
+ # resp.group_configuration.configuration[0].parameters[0].name #=> String
520
+ # resp.group_configuration.configuration[0].parameters[0].values #=> Array
521
+ # resp.group_configuration.configuration[0].parameters[0].values[0] #=> String
522
+ # resp.group_configuration.proposed_configuration #=> Array
523
+ # resp.group_configuration.proposed_configuration[0].type #=> String
524
+ # resp.group_configuration.proposed_configuration[0].parameters #=> Array
525
+ # resp.group_configuration.proposed_configuration[0].parameters[0].name #=> String
526
+ # resp.group_configuration.proposed_configuration[0].parameters[0].values #=> Array
527
+ # resp.group_configuration.proposed_configuration[0].parameters[0].values[0] #=> String
528
+ # resp.group_configuration.status #=> String, one of "UPDATING", "UPDATE_COMPLETE", "UPDATE_FAILED"
529
+ # resp.group_configuration.failure_reason #=> String
530
+ #
531
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroupConfiguration AWS API Documentation
532
+ #
533
+ # @overload get_group_configuration(params = {})
534
+ # @param [Hash] params ({})
535
+ def get_group_configuration(params = {}, options = {})
536
+ req = build_request(:get_group_configuration, params)
537
+ req.send_request(options)
538
+ end
539
+
540
+ # Retrieves the resource query associated with the specified resource
443
541
  # group.
444
542
  #
445
- # @option params [required, String] :group_name
446
- # The name of the resource group.
543
+ # @option params [String] :group_name
544
+ # Don't use this parameter. Use `Group` instead.
545
+ #
546
+ # @option params [String] :group
547
+ # The name or the ARN of the resource group to query.
447
548
  #
448
549
  # @return [Types::GetGroupQueryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
449
550
  #
@@ -452,7 +553,8 @@ module Aws::ResourceGroups
452
553
  # @example Request syntax with placeholder values
453
554
  #
454
555
  # resp = client.get_group_query({
455
- # group_name: "GroupName", # required
556
+ # group_name: "GroupName",
557
+ # group: "GroupString",
456
558
  # })
457
559
  #
458
560
  # @example Response structure
@@ -474,8 +576,7 @@ module Aws::ResourceGroups
474
576
  # specified by an ARN.
475
577
  #
476
578
  # @option params [required, String] :arn
477
- # The ARN of the resource group for which you want a list of tags. The
478
- # resource must exist within the account you are using.
579
+ # The ARN of the resource group whose tags you want to retrieve.
479
580
  #
480
581
  # @return [Types::GetTagsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
481
582
  #
@@ -503,31 +604,101 @@ module Aws::ResourceGroups
503
604
  req.send_request(options)
504
605
  end
505
606
 
607
+ # Adds the specified resources to the specified group.
608
+ #
609
+ # @option params [required, String] :group
610
+ # The name or the ARN of the resource group to add resources to.
611
+ #
612
+ # @option params [required, Array<String>] :resource_arns
613
+ # The list of ARNs for resources to be added to the group.
614
+ #
615
+ # @return [Types::GroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
616
+ #
617
+ # * {Types::GroupResourcesOutput#succeeded #succeeded} => Array&lt;String&gt;
618
+ # * {Types::GroupResourcesOutput#failed #failed} => Array&lt;Types::FailedResource&gt;
619
+ #
620
+ # @example Request syntax with placeholder values
621
+ #
622
+ # resp = client.group_resources({
623
+ # group: "GroupString", # required
624
+ # resource_arns: ["ResourceArn"], # required
625
+ # })
626
+ #
627
+ # @example Response structure
628
+ #
629
+ # resp.succeeded #=> Array
630
+ # resp.succeeded[0] #=> String
631
+ # resp.failed #=> Array
632
+ # resp.failed[0].resource_arn #=> String
633
+ # resp.failed[0].error_message #=> String
634
+ # resp.failed[0].error_code #=> String
635
+ #
636
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GroupResources AWS API Documentation
637
+ #
638
+ # @overload group_resources(params = {})
639
+ # @param [Hash] params ({})
640
+ def group_resources(params = {}, options = {})
641
+ req = build_request(:group_resources, params)
642
+ req.send_request(options)
643
+ end
644
+
506
645
  # Returns a list of ARNs of resources that are members of a specified
507
646
  # resource group.
508
647
  #
509
- # @option params [required, String] :group_name
510
- # The name of the resource group.
648
+ # @option params [String] :group_name
649
+ # Don't use this parameter. Use `Group` instead.
650
+ #
651
+ # @option params [String] :group
652
+ # The name or the ARN of the resource group
511
653
  #
512
654
  # @option params [Array<Types::ResourceFilter>] :filters
513
655
  # Filters, formatted as ResourceFilter objects, that you want to apply
514
- # to a ListGroupResources operation.
656
+ # to a `ListGroupResources` operation. Filters the results to include
657
+ # only those of the specified resource types.
515
658
  #
516
659
  # * `resource-type` - Filter resources by their type. Specify up to five
517
- # resource types in the format AWS::ServiceCode::ResourceType. For
518
- # example, AWS::EC2::Instance, or AWS::S3::Bucket.
660
+ # resource types in the format `AWS::ServiceCode::ResourceType`. For
661
+ # example, `AWS::EC2::Instance`, or `AWS::S3::Bucket`.
519
662
  #
520
663
  # ^
521
664
  #
665
+ # When you specify a `resource-type` filter for `ListGroupResources`,
666
+ # AWS Resource Groups validates your filter resource types against the
667
+ # types that are defined in the query associated with the group. For
668
+ # example, if a group contains only S3 buckets because its query
669
+ # specifies only that resource type, but your `resource-type` filter
670
+ # includes EC2 instances, AWS Resource Groups does not filter for EC2
671
+ # instances. In this case, a `ListGroupResources` request returns a
672
+ # `BadRequestException` error with a message similar to the following:
673
+ #
674
+ # `The resource types specified as filters in the request are not
675
+ # valid.`
676
+ #
677
+ # The error includes a list of resource types that failed the validation
678
+ # because they are not part of the query associated with the group. This
679
+ # validation doesn't occur when the group query specifies
680
+ # `AWS::AllSupported`, because a group based on such a query can contain
681
+ # any of the allowed resource types for the query type (tag-based or AWS
682
+ # CloudFormation stack-based queries).
683
+ #
522
684
  # @option params [Integer] :max_results
523
- # The maximum number of group member ARNs that are returned in a single
524
- # call by ListGroupResources, in paginated output. By default, this
525
- # number is 50.
685
+ # The total number of results that you want included on each page of the
686
+ # response. If you do not include this parameter, it defaults to a value
687
+ # that is specific to the operation. If additional items exist beyond
688
+ # the maximum you specify, the `NextToken` response element is present
689
+ # and has a value (is not null). Include that value as the `NextToken`
690
+ # request parameter in the next call to the operation to get the next
691
+ # part of the results. Note that the service might return fewer results
692
+ # than the maximum even when there are more results available. You
693
+ # should check `NextToken` after every operation to ensure that you
694
+ # receive all of the results.
526
695
  #
527
696
  # @option params [String] :next_token
528
- # The NextToken value that is returned in a paginated ListGroupResources
529
- # request. To get the next page of results, run the call again, add the
530
- # NextToken parameter, and specify the NextToken value.
697
+ # The parameter for receiving additional results if you receive a
698
+ # `NextToken` response in a previous request. A `NextToken` response
699
+ # indicates that more output is available. Set this parameter to the
700
+ # value provided by a previous call's `NextToken` response to indicate
701
+ # where the output should continue from.
531
702
  #
532
703
  # @return [Types::ListGroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
533
704
  #
@@ -540,7 +711,8 @@ module Aws::ResourceGroups
540
711
  # @example Request syntax with placeholder values
541
712
  #
542
713
  # resp = client.list_group_resources({
543
- # group_name: "GroupName", # required
714
+ # group_name: "GroupName",
715
+ # group: "GroupString",
544
716
  # filters: [
545
717
  # {
546
718
  # name: "resource-type", # required, accepts resource-type
@@ -574,22 +746,39 @@ module Aws::ResourceGroups
574
746
  #
575
747
  # @option params [Array<Types::GroupFilter>] :filters
576
748
  # Filters, formatted as GroupFilter objects, that you want to apply to a
577
- # ListGroups operation.
749
+ # `ListGroups` operation.
578
750
  #
579
- # * `resource-type` - Filter groups by resource type. Specify up to five
580
- # resource types in the format AWS::ServiceCode::ResourceType. For
581
- # example, AWS::EC2::Instance, or AWS::S3::Bucket.
751
+ # * `resource-type` - Filter the results to include only those of the
752
+ # specified resource types. Specify up to five resource types in the
753
+ # format `AWS::ServiceCode::ResourceType `. For example,
754
+ # `AWS::EC2::Instance`, or `AWS::S3::Bucket`.
582
755
  #
583
- # ^
756
+ # * `configuration-type` - Filter the results to include only those
757
+ # groups that have the specified configuration types attached. The
758
+ # current supported values are:
759
+ #
760
+ # * AWS:EC2::CapacityReservationPool
761
+ #
762
+ # ^
584
763
  #
585
764
  # @option params [Integer] :max_results
586
- # The maximum number of resource group results that are returned by
587
- # ListGroups in paginated output. By default, this number is 50.
765
+ # The total number of results that you want included on each page of the
766
+ # response. If you do not include this parameter, it defaults to a value
767
+ # that is specific to the operation. If additional items exist beyond
768
+ # the maximum you specify, the `NextToken` response element is present
769
+ # and has a value (is not null). Include that value as the `NextToken`
770
+ # request parameter in the next call to the operation to get the next
771
+ # part of the results. Note that the service might return fewer results
772
+ # than the maximum even when there are more results available. You
773
+ # should check `NextToken` after every operation to ensure that you
774
+ # receive all of the results.
588
775
  #
589
776
  # @option params [String] :next_token
590
- # The NextToken value that is returned in a paginated `ListGroups`
591
- # request. To get the next page of results, run the call again, add the
592
- # NextToken parameter, and specify the NextToken value.
777
+ # The parameter for receiving additional results if you receive a
778
+ # `NextToken` response in a previous request. A `NextToken` response
779
+ # indicates that more output is available. Set this parameter to the
780
+ # value provided by a previous call's `NextToken` response to indicate
781
+ # where the output should continue from.
593
782
  #
594
783
  # @return [Types::ListGroupsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
595
784
  #
@@ -604,7 +793,7 @@ module Aws::ResourceGroups
604
793
  # resp = client.list_groups({
605
794
  # filters: [
606
795
  # {
607
- # name: "resource-type", # required, accepts resource-type
796
+ # name: "resource-type", # required, accepts resource-type, configuration-type
608
797
  # values: ["GroupFilterValue"], # required
609
798
  # },
610
799
  # ],
@@ -638,16 +827,26 @@ module Aws::ResourceGroups
638
827
  #
639
828
  # @option params [required, Types::ResourceQuery] :resource_query
640
829
  # The search query, using the same formats that are supported for
641
- # resource group definition.
830
+ # resource group definition. For more information, see CreateGroup.
642
831
  #
643
832
  # @option params [Integer] :max_results
644
- # The maximum number of group member ARNs returned by `SearchResources`
645
- # in paginated output. By default, this number is 50.
833
+ # The total number of results that you want included on each page of the
834
+ # response. If you do not include this parameter, it defaults to a value
835
+ # that is specific to the operation. If additional items exist beyond
836
+ # the maximum you specify, the `NextToken` response element is present
837
+ # and has a value (is not null). Include that value as the `NextToken`
838
+ # request parameter in the next call to the operation to get the next
839
+ # part of the results. Note that the service might return fewer results
840
+ # than the maximum even when there are more results available. You
841
+ # should check `NextToken` after every operation to ensure that you
842
+ # receive all of the results.
646
843
  #
647
844
  # @option params [String] :next_token
648
- # The NextToken value that is returned in a paginated `SearchResources`
649
- # request. To get the next page of results, run the call again, add the
650
- # NextToken parameter, and specify the NextToken value.
845
+ # The parameter for receiving additional results if you receive a
846
+ # `NextToken` response in a previous request. A `NextToken` response
847
+ # indicates that more output is available. Set this parameter to the
848
+ # value provided by a previous call's `NextToken` response to indicate
849
+ # where the output should continue from.
651
850
  #
652
851
  # @return [Types::SearchResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
653
852
  #
@@ -691,14 +890,17 @@ module Aws::ResourceGroups
691
890
  # a resource group are not changed if they are not specified in the
692
891
  # request parameters.
693
892
  #
893
+ # Do not store personally identifiable information (PII) or other
894
+ # confidential or sensitive information in tags. We use tags to provide
895
+ # you with billing and administration services. Tags are not intended to
896
+ # be used for private or sensitive data.
897
+ #
694
898
  # @option params [required, String] :arn
695
- # The ARN of the resource to which to add tags.
899
+ # The ARN of the resource group to which to add tags.
696
900
  #
697
901
  # @option params [required, Hash<String,String>] :tags
698
- # The tags to add to the specified resource. A tag is a string-to-string
699
- # map of key-value pairs. Tag keys can have a maximum character length
700
- # of 128 characters, and tag values can have a maximum length of 256
701
- # characters.
902
+ # The tags to add to the specified resource group. A tag is a
903
+ # string-to-string map of key-value pairs.
702
904
  #
703
905
  # @return [Types::TagOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
704
906
  #
@@ -729,10 +931,51 @@ module Aws::ResourceGroups
729
931
  req.send_request(options)
730
932
  end
731
933
 
732
- # Deletes specified tags from a specified resource.
934
+ # Removes the specified resources from the specified group.
935
+ #
936
+ # @option params [required, String] :group
937
+ # The name or the ARN of the resource group from which to remove the
938
+ # resources.
939
+ #
940
+ # @option params [required, Array<String>] :resource_arns
941
+ # The ARNs of the resources to be removed from the group.
942
+ #
943
+ # @return [Types::UngroupResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
944
+ #
945
+ # * {Types::UngroupResourcesOutput#succeeded #succeeded} => Array&lt;String&gt;
946
+ # * {Types::UngroupResourcesOutput#failed #failed} => Array&lt;Types::FailedResource&gt;
947
+ #
948
+ # @example Request syntax with placeholder values
949
+ #
950
+ # resp = client.ungroup_resources({
951
+ # group: "GroupString", # required
952
+ # resource_arns: ["ResourceArn"], # required
953
+ # })
954
+ #
955
+ # @example Response structure
956
+ #
957
+ # resp.succeeded #=> Array
958
+ # resp.succeeded[0] #=> String
959
+ # resp.failed #=> Array
960
+ # resp.failed[0].resource_arn #=> String
961
+ # resp.failed[0].error_message #=> String
962
+ # resp.failed[0].error_code #=> String
963
+ #
964
+ # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UngroupResources AWS API Documentation
965
+ #
966
+ # @overload ungroup_resources(params = {})
967
+ # @param [Hash] params ({})
968
+ def ungroup_resources(params = {}, options = {})
969
+ req = build_request(:ungroup_resources, params)
970
+ req.send_request(options)
971
+ end
972
+
973
+ # Deletes tags from a specified resource group.
733
974
  #
734
975
  # @option params [required, String] :arn
735
- # The ARN of the resource from which to remove tags.
976
+ # The ARN of the resource group from which to remove tags. The command
977
+ # removed both the specified keys and any values associated with those
978
+ # keys.
736
979
  #
737
980
  # @option params [required, Array<String>] :keys
738
981
  # The keys of the tags to be removed.
@@ -764,17 +1007,19 @@ module Aws::ResourceGroups
764
1007
  req.send_request(options)
765
1008
  end
766
1009
 
767
- # Updates an existing group with a new or changed description. You
768
- # cannot update the name of a resource group.
1010
+ # Updates the description for an existing group. You cannot update the
1011
+ # name of a resource group.
1012
+ #
1013
+ # @option params [String] :group_name
1014
+ # Don't use this parameter. Use `Group` instead.
769
1015
  #
770
- # @option params [required, String] :group_name
771
- # The name of the resource group for which you want to update its
772
- # description.
1016
+ # @option params [String] :group
1017
+ # The name or the ARN of the resource group to modify.
773
1018
  #
774
1019
  # @option params [String] :description
775
- # The description of the resource group. Descriptions can have a maximum
776
- # of 511 characters, including letters, numbers, hyphens, underscores,
777
- # punctuation, and spaces.
1020
+ # The new description that you want to update the resource group with.
1021
+ # Descriptions can contain letters, numbers, hyphens, underscores,
1022
+ # periods, and spaces.
778
1023
  #
779
1024
  # @return [Types::UpdateGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
780
1025
  #
@@ -783,8 +1028,9 @@ module Aws::ResourceGroups
783
1028
  # @example Request syntax with placeholder values
784
1029
  #
785
1030
  # resp = client.update_group({
786
- # group_name: "GroupName", # required
787
- # description: "GroupDescription",
1031
+ # group_name: "GroupName",
1032
+ # group: "GroupString",
1033
+ # description: "Description",
788
1034
  # })
789
1035
  #
790
1036
  # @example Response structure
@@ -804,12 +1050,15 @@ module Aws::ResourceGroups
804
1050
 
805
1051
  # Updates the resource query of a group.
806
1052
  #
807
- # @option params [required, String] :group_name
808
- # The name of the resource group for which you want to edit the query.
1053
+ # @option params [String] :group_name
1054
+ # Don't use this parameter. Use `Group` instead.
1055
+ #
1056
+ # @option params [String] :group
1057
+ # The name or the ARN of the resource group to query.
809
1058
  #
810
1059
  # @option params [required, Types::ResourceQuery] :resource_query
811
- # The resource query that determines which AWS resources are members of
812
- # the resource group.
1060
+ # The resource query to determine which AWS resources are members of
1061
+ # this resource group.
813
1062
  #
814
1063
  # @return [Types::UpdateGroupQueryOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
815
1064
  #
@@ -818,7 +1067,8 @@ module Aws::ResourceGroups
818
1067
  # @example Request syntax with placeholder values
819
1068
  #
820
1069
  # resp = client.update_group_query({
821
- # group_name: "GroupName", # required
1070
+ # group_name: "GroupName",
1071
+ # group: "GroupString",
822
1072
  # resource_query: { # required
823
1073
  # type: "TAG_FILTERS_1_0", # required, accepts TAG_FILTERS_1_0, CLOUDFORMATION_STACK_1_0
824
1074
  # query: "Query", # required
@@ -853,7 +1103,7 @@ module Aws::ResourceGroups
853
1103
  params: params,
854
1104
  config: config)
855
1105
  context[:gem_name] = 'aws-sdk-resourcegroups'
856
- context[:gem_version] = '1.26.0'
1106
+ context[:gem_version] = '1.27.0'
857
1107
  Seahorse::Client::Request.new(handlers, context)
858
1108
  end
859
1109