aws-sdk-resourcegroups 1.78.0 → 1.80.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: 3caa1375efd29f0507c59cdf2642df21f93b942baba55bade96064263ac556e2
4
- data.tar.gz: 27e4973bc25d868dff4f77fd5843100761a8a3bd7ffee7d35080852fc5e85725
3
+ metadata.gz: ae64df3076832da8cc7ef5a11635cb1a4c9879f44dbfd331d8ad65201fae08ca
4
+ data.tar.gz: 657f4b58ebaa287d884a5c893db8198ce2d3d228752ce7bc4435917e40aab8c1
5
5
  SHA512:
6
- metadata.gz: 13bbca6da24648a28fcbe99fd2cfc3291c5b7f487b69b5e97b8774508a661ea78e1b34fc9dd652feb6f0d15ccd626a3cb2eb9c9181ff20edbc5ccd8e12e0eb08
7
- data.tar.gz: d3b8b06140bd740b55dc095c5d6791288fbed4fd0e725548edcddbdd63436f44038c73c5bcc2c28cec95bd0edbea7c017849cb530a1d640b5c2a281bdb7042a0
6
+ metadata.gz: 5b971ce699191bfaf8ca568b4ef424184b65145d8a6c49bac622d380180d3c82fcac183b8bc90fd388d43ae788fe0bd1ed9e7a8430829df2003b4f600dbebfd4
7
+ data.tar.gz: b49502abd1424e30715e103648152e637497d7dbc6bc4d54b74f042c8a3a4a3ed5a92b6cb156b42e5b0a1c3d96ae20a798c3a81c2a58c15000977ec9e8cf90eb
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.80.0 (2025-04-16)
5
+ ------------------
6
+
7
+ * Feature - Resource Groups: TagSyncTasks can be created with ResourceQuery
8
+
9
+ 1.79.0 (2025-02-18)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
4
14
  1.78.0 (2025-02-06)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.78.0
1
+ 1.80.0
@@ -7,34 +7,34 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
- require 'seahorse/client/plugins/content_length.rb'
11
- require 'aws-sdk-core/plugins/credentials_configuration.rb'
12
- require 'aws-sdk-core/plugins/logging.rb'
13
- require 'aws-sdk-core/plugins/param_converter.rb'
14
- require 'aws-sdk-core/plugins/param_validator.rb'
15
- require 'aws-sdk-core/plugins/user_agent.rb'
16
- require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
17
- require 'aws-sdk-core/plugins/retry_errors.rb'
18
- require 'aws-sdk-core/plugins/global_configuration.rb'
19
- require 'aws-sdk-core/plugins/regional_endpoint.rb'
20
- require 'aws-sdk-core/plugins/endpoint_discovery.rb'
21
- require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
- require 'aws-sdk-core/plugins/response_paging.rb'
23
- require 'aws-sdk-core/plugins/stub_responses.rb'
24
- require 'aws-sdk-core/plugins/idempotency_token.rb'
25
- require 'aws-sdk-core/plugins/invocation_id.rb'
26
- require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
27
- require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
28
- require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
29
- require 'aws-sdk-core/plugins/transfer_encoding.rb'
30
- require 'aws-sdk-core/plugins/http_checksum.rb'
31
- require 'aws-sdk-core/plugins/checksum_algorithm.rb'
32
- require 'aws-sdk-core/plugins/request_compression.rb'
33
- require 'aws-sdk-core/plugins/defaults_mode.rb'
34
- require 'aws-sdk-core/plugins/recursion_detection.rb'
35
- require 'aws-sdk-core/plugins/telemetry.rb'
36
- require 'aws-sdk-core/plugins/sign.rb'
37
- require 'aws-sdk-core/plugins/protocols/rest_json.rb'
10
+ require 'seahorse/client/plugins/content_length'
11
+ require 'aws-sdk-core/plugins/credentials_configuration'
12
+ require 'aws-sdk-core/plugins/logging'
13
+ require 'aws-sdk-core/plugins/param_converter'
14
+ require 'aws-sdk-core/plugins/param_validator'
15
+ require 'aws-sdk-core/plugins/user_agent'
16
+ require 'aws-sdk-core/plugins/helpful_socket_errors'
17
+ require 'aws-sdk-core/plugins/retry_errors'
18
+ require 'aws-sdk-core/plugins/global_configuration'
19
+ require 'aws-sdk-core/plugins/regional_endpoint'
20
+ require 'aws-sdk-core/plugins/endpoint_discovery'
21
+ require 'aws-sdk-core/plugins/endpoint_pattern'
22
+ require 'aws-sdk-core/plugins/response_paging'
23
+ require 'aws-sdk-core/plugins/stub_responses'
24
+ require 'aws-sdk-core/plugins/idempotency_token'
25
+ require 'aws-sdk-core/plugins/invocation_id'
26
+ require 'aws-sdk-core/plugins/jsonvalue_converter'
27
+ require 'aws-sdk-core/plugins/client_metrics_plugin'
28
+ require 'aws-sdk-core/plugins/client_metrics_send_plugin'
29
+ require 'aws-sdk-core/plugins/transfer_encoding'
30
+ require 'aws-sdk-core/plugins/http_checksum'
31
+ require 'aws-sdk-core/plugins/checksum_algorithm'
32
+ require 'aws-sdk-core/plugins/request_compression'
33
+ require 'aws-sdk-core/plugins/defaults_mode'
34
+ require 'aws-sdk-core/plugins/recursion_detection'
35
+ require 'aws-sdk-core/plugins/telemetry'
36
+ require 'aws-sdk-core/plugins/sign'
37
+ require 'aws-sdk-core/plugins/protocols/rest_json'
38
38
 
39
39
  module Aws::ResourceGroups
40
40
  # An API client for ResourceGroups. To construct a client, you need to configure a `:region` and `:credentials`.
@@ -898,6 +898,7 @@ module Aws::ResourceGroups
898
898
  # * {Types::GetTagSyncTaskOutput#task_arn #task_arn} => String
899
899
  # * {Types::GetTagSyncTaskOutput#tag_key #tag_key} => String
900
900
  # * {Types::GetTagSyncTaskOutput#tag_value #tag_value} => String
901
+ # * {Types::GetTagSyncTaskOutput#resource_query #resource_query} => Types::ResourceQuery
901
902
  # * {Types::GetTagSyncTaskOutput#role_arn #role_arn} => String
902
903
  # * {Types::GetTagSyncTaskOutput#status #status} => String
903
904
  # * {Types::GetTagSyncTaskOutput#error_message #error_message} => String
@@ -916,6 +917,8 @@ module Aws::ResourceGroups
916
917
  # resp.task_arn #=> String
917
918
  # resp.tag_key #=> String
918
919
  # resp.tag_value #=> String
920
+ # resp.resource_query.type #=> String, one of "TAG_FILTERS_1_0", "CLOUDFORMATION_STACK_1_0"
921
+ # resp.resource_query.query #=> String
919
922
  # resp.role_arn #=> String
920
923
  # resp.status #=> String, one of "ACTIVE", "ERROR"
921
924
  # resp.error_message #=> String
@@ -1244,7 +1247,7 @@ module Aws::ResourceGroups
1244
1247
  #
1245
1248
  # * `AWS::AppRegistry::Application`
1246
1249
  #
1247
- # * `AWS::AppRegistry::ApplicationResourceGroups`
1250
+ # * `AWS::AppRegistry::ApplicationResourceGroup`
1248
1251
  #
1249
1252
  # * `AWS::CloudFormation::Stack`
1250
1253
  #
@@ -1376,6 +1379,8 @@ module Aws::ResourceGroups
1376
1379
  # resp.tag_sync_tasks[0].task_arn #=> String
1377
1380
  # resp.tag_sync_tasks[0].tag_key #=> String
1378
1381
  # resp.tag_sync_tasks[0].tag_value #=> String
1382
+ # resp.tag_sync_tasks[0].resource_query.type #=> String, one of "TAG_FILTERS_1_0", "CLOUDFORMATION_STACK_1_0"
1383
+ # resp.tag_sync_tasks[0].resource_query.query #=> String
1379
1384
  # resp.tag_sync_tasks[0].role_arn #=> String
1380
1385
  # resp.tag_sync_tasks[0].status #=> String, one of "ACTIVE", "ERROR"
1381
1386
  # resp.tag_sync_tasks[0].error_message #=> String
@@ -1532,7 +1537,15 @@ module Aws::ResourceGroups
1532
1537
  end
1533
1538
 
1534
1539
  # Creates a new tag-sync task to onboard and sync resources tagged with
1535
- # a specific tag key-value pair to an application.
1540
+ # a specific tag key-value pair to an application. To start a tag-sync
1541
+ # task, you need a [resource tagging role][1]. The resource tagging role
1542
+ # grants permissions to tag and untag applications resources and must
1543
+ # include a trust policy that allows Resource Groups to assume the role
1544
+ # and perform resource tagging tasks on your behalf.
1545
+ #
1546
+ # For instructions on creating a tag-sync task, see [Create a tag-sync
1547
+ # using the Resource Groups API][2] in the *Amazon Web Services Service
1548
+ # Catalog AppRegistry Administrator Guide*.
1536
1549
  #
1537
1550
  # **Minimum permissions**
1538
1551
  #
@@ -1544,20 +1557,72 @@ module Aws::ResourceGroups
1544
1557
  #
1545
1558
  # * `iam:PassRole` on the role provided in the request
1546
1559
  #
1560
+ #
1561
+ #
1562
+ # [1]: https://docs.aws.amazon.com/servicecatalog/latest/arguide/app-tag-sync.html#tag-sync-role
1563
+ # [2]: https://docs.aws.amazon.com/servicecatalog/latest/arguide/app-tag-sync.html#create-tag-sync
1564
+ #
1547
1565
  # @option params [required, String] :group
1548
1566
  # The Amazon resource name (ARN) or name of the application group for
1549
1567
  # which you want to create a tag-sync task.
1550
1568
  #
1551
- # @option params [required, String] :tag_key
1569
+ # @option params [String] :tag_key
1552
1570
  # The tag key. Resources tagged with this tag key-value pair will be
1553
1571
  # added to the application. If a resource with this tag is later
1554
1572
  # untagged, the tag-sync task removes the resource from the application.
1555
1573
  #
1556
- # @option params [required, String] :tag_value
1574
+ # When using the `TagKey` parameter, you must also specify the
1575
+ # `TagValue` parameter. If you specify a tag key-value pair, you can't
1576
+ # use the `ResourceQuery` parameter.
1577
+ #
1578
+ # @option params [String] :tag_value
1557
1579
  # The tag value. Resources tagged with this tag key-value pair will be
1558
1580
  # added to the application. If a resource with this tag is later
1559
1581
  # untagged, the tag-sync task removes the resource from the application.
1560
1582
  #
1583
+ # When using the `TagValue` parameter, you must also specify the
1584
+ # `TagKey` parameter. If you specify a tag key-value pair, you can't
1585
+ # use the `ResourceQuery` parameter.
1586
+ #
1587
+ # @option params [Types::ResourceQuery] :resource_query
1588
+ # The query you can use to create the tag-sync task. With this method,
1589
+ # all resources matching the query are added to the specified
1590
+ # application group. A `ResourceQuery` specifies both a query `Type` and
1591
+ # a `Query` string as JSON string objects. For more information on
1592
+ # defining a resource query for a tag-sync task, see the tag-based query
1593
+ # type in [ Types of resource group queries][1] in *Resource Groups User
1594
+ # Guide*.
1595
+ #
1596
+ # When using the `ResourceQuery` parameter, you cannot use the `TagKey`
1597
+ # and `TagValue` parameters.
1598
+ #
1599
+ # When you combine all of the elements together into a single string,
1600
+ # any double quotes that are embedded inside another double quote pair
1601
+ # must be escaped by preceding the embedded double quote with a
1602
+ # backslash character (\\). For example, a complete `ResourceQuery`
1603
+ # parameter must be formatted like the following CLI parameter example:
1604
+ #
1605
+ # `--resource-query
1606
+ # '{"Type":"TAG_FILTERS_1_0","Query":"{"ResourceTypeFilters":["AWS::AllSupported"],"TagFilters":[{"Key":"Stage","Values":["Test"]}]}"}'`
1607
+ #
1608
+ # In the preceding example, all of the double quote characters in the
1609
+ # value part of the `Query` element must be escaped because the value
1610
+ # itself is surrounded by double quotes. For more information, see
1611
+ # [Quoting strings][2] in the *Command Line Interface User Guide*.
1612
+ #
1613
+ # For the complete list of resource types that you can use in the array
1614
+ # value for `ResourceTypeFilters`, see [Resources you can use with
1615
+ # Resource Groups and Tag Editor][3] in the *Resource Groups User
1616
+ # Guide*. For example:
1617
+ #
1618
+ # `"ResourceTypeFilters":["AWS::S3::Bucket", "AWS::EC2::Instance"]`
1619
+ #
1620
+ #
1621
+ #
1622
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#getting_started-query_types
1623
+ # [2]: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html
1624
+ # [3]: https://docs.aws.amazon.com/ARG/latest/userguide/supported-resources.html
1625
+ #
1561
1626
  # @option params [required, String] :role_arn
1562
1627
  # The Amazon resource name (ARN) of the role assumed by the service to
1563
1628
  # tag and untag resources on your behalf.
@@ -1569,14 +1634,19 @@ module Aws::ResourceGroups
1569
1634
  # * {Types::StartTagSyncTaskOutput#task_arn #task_arn} => String
1570
1635
  # * {Types::StartTagSyncTaskOutput#tag_key #tag_key} => String
1571
1636
  # * {Types::StartTagSyncTaskOutput#tag_value #tag_value} => String
1637
+ # * {Types::StartTagSyncTaskOutput#resource_query #resource_query} => Types::ResourceQuery
1572
1638
  # * {Types::StartTagSyncTaskOutput#role_arn #role_arn} => String
1573
1639
  #
1574
1640
  # @example Request syntax with placeholder values
1575
1641
  #
1576
1642
  # resp = client.start_tag_sync_task({
1577
1643
  # group: "GroupStringV2", # required
1578
- # tag_key: "TagKey", # required
1579
- # tag_value: "TagValue", # required
1644
+ # tag_key: "TagKey",
1645
+ # tag_value: "TagValue",
1646
+ # resource_query: {
1647
+ # type: "TAG_FILTERS_1_0", # required, accepts TAG_FILTERS_1_0, CLOUDFORMATION_STACK_1_0
1648
+ # query: "Query", # required
1649
+ # },
1580
1650
  # role_arn: "RoleArn", # required
1581
1651
  # })
1582
1652
  #
@@ -1587,6 +1657,8 @@ module Aws::ResourceGroups
1587
1657
  # resp.task_arn #=> String
1588
1658
  # resp.tag_key #=> String
1589
1659
  # resp.tag_value #=> String
1660
+ # resp.resource_query.type #=> String, one of "TAG_FILTERS_1_0", "CLOUDFORMATION_STACK_1_0"
1661
+ # resp.resource_query.query #=> String
1590
1662
  # resp.role_arn #=> String
1591
1663
  #
1592
1664
  # @see http://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/StartTagSyncTask AWS API Documentation
@@ -1945,7 +2017,7 @@ module Aws::ResourceGroups
1945
2017
  tracer: tracer
1946
2018
  )
1947
2019
  context[:gem_name] = 'aws-sdk-resourcegroups'
1948
- context[:gem_version] = '1.78.0'
2020
+ context[:gem_version] = '1.80.0'
1949
2021
  Seahorse::Client::Request.new(handlers, context)
1950
2022
  end
1951
2023
 
@@ -232,6 +232,7 @@ module Aws::ResourceGroups
232
232
  GetTagSyncTaskOutput.add_member(:task_arn, Shapes::ShapeRef.new(shape: TagSyncTaskArn, location_name: "TaskArn"))
233
233
  GetTagSyncTaskOutput.add_member(:tag_key, Shapes::ShapeRef.new(shape: TagKey, location_name: "TagKey"))
234
234
  GetTagSyncTaskOutput.add_member(:tag_value, Shapes::ShapeRef.new(shape: TagValue, location_name: "TagValue"))
235
+ GetTagSyncTaskOutput.add_member(:resource_query, Shapes::ShapeRef.new(shape: ResourceQuery, location_name: "ResourceQuery"))
235
236
  GetTagSyncTaskOutput.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "RoleArn"))
236
237
  GetTagSyncTaskOutput.add_member(:status, Shapes::ShapeRef.new(shape: TagSyncTaskStatus, location_name: "Status"))
237
238
  GetTagSyncTaskOutput.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "ErrorMessage"))
@@ -440,8 +441,9 @@ module Aws::ResourceGroups
440
441
  SearchResourcesOutput.struct_class = Types::SearchResourcesOutput
441
442
 
442
443
  StartTagSyncTaskInput.add_member(:group, Shapes::ShapeRef.new(shape: GroupStringV2, required: true, location_name: "Group"))
443
- StartTagSyncTaskInput.add_member(:tag_key, Shapes::ShapeRef.new(shape: TagKey, required: true, location_name: "TagKey"))
444
- StartTagSyncTaskInput.add_member(:tag_value, Shapes::ShapeRef.new(shape: TagValue, required: true, location_name: "TagValue"))
444
+ StartTagSyncTaskInput.add_member(:tag_key, Shapes::ShapeRef.new(shape: TagKey, location_name: "TagKey"))
445
+ StartTagSyncTaskInput.add_member(:tag_value, Shapes::ShapeRef.new(shape: TagValue, location_name: "TagValue"))
446
+ StartTagSyncTaskInput.add_member(:resource_query, Shapes::ShapeRef.new(shape: ResourceQuery, location_name: "ResourceQuery"))
445
447
  StartTagSyncTaskInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, required: true, location_name: "RoleArn"))
446
448
  StartTagSyncTaskInput.struct_class = Types::StartTagSyncTaskInput
447
449
 
@@ -450,6 +452,7 @@ module Aws::ResourceGroups
450
452
  StartTagSyncTaskOutput.add_member(:task_arn, Shapes::ShapeRef.new(shape: TagSyncTaskArn, location_name: "TaskArn"))
451
453
  StartTagSyncTaskOutput.add_member(:tag_key, Shapes::ShapeRef.new(shape: TagKey, location_name: "TagKey"))
452
454
  StartTagSyncTaskOutput.add_member(:tag_value, Shapes::ShapeRef.new(shape: TagValue, location_name: "TagValue"))
455
+ StartTagSyncTaskOutput.add_member(:resource_query, Shapes::ShapeRef.new(shape: ResourceQuery, location_name: "ResourceQuery"))
453
456
  StartTagSyncTaskOutput.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "RoleArn"))
454
457
  StartTagSyncTaskOutput.struct_class = Types::StartTagSyncTaskOutput
455
458
 
@@ -468,6 +471,7 @@ module Aws::ResourceGroups
468
471
  TagSyncTaskItem.add_member(:task_arn, Shapes::ShapeRef.new(shape: TagSyncTaskArn, location_name: "TaskArn"))
469
472
  TagSyncTaskItem.add_member(:tag_key, Shapes::ShapeRef.new(shape: TagKey, location_name: "TagKey"))
470
473
  TagSyncTaskItem.add_member(:tag_value, Shapes::ShapeRef.new(shape: TagValue, location_name: "TagValue"))
474
+ TagSyncTaskItem.add_member(:resource_query, Shapes::ShapeRef.new(shape: ResourceQuery, location_name: "ResourceQuery"))
471
475
  TagSyncTaskItem.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "RoleArn"))
472
476
  TagSyncTaskItem.add_member(:status, Shapes::ShapeRef.new(shape: TagSyncTaskStatus, location_name: "Status"))
473
477
  TagSyncTaskItem.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "ErrorMessage"))
@@ -395,6 +395,43 @@ module Aws::ResourceGroups
395
395
  # The tag value.
396
396
  # @return [String]
397
397
  #
398
+ # @!attribute [rw] resource_query
399
+ # The query you can use to define a resource group or a search for
400
+ # resources. A `ResourceQuery` specifies both a query `Type` and a
401
+ # `Query` string as JSON string objects. See the examples section for
402
+ # example JSON strings. For more information about creating a resource
403
+ # group with a resource query, see [Build queries and groups in
404
+ # Resource Groups][1] in the *Resource Groups User Guide*
405
+ #
406
+ # When you combine all of the elements together into a single string,
407
+ # any double quotes that are embedded inside another double quote pair
408
+ # must be escaped by preceding the embedded double quote with a
409
+ # backslash character (\\). For example, a complete `ResourceQuery`
410
+ # parameter must be formatted like the following CLI parameter
411
+ # example:
412
+ #
413
+ # `--resource-query
414
+ # '{"Type":"TAG_FILTERS_1_0","Query":"{"ResourceTypeFilters":["AWS::AllSupported"],"TagFilters":[{"Key":"Stage","Values":["Test"]}]}"}'`
415
+ #
416
+ # In the preceding example, all of the double quote characters in the
417
+ # value part of the `Query` element must be escaped because the value
418
+ # itself is surrounded by double quotes. For more information, see
419
+ # [Quoting strings][2] in the *Command Line Interface User Guide*.
420
+ #
421
+ # For the complete list of resource types that you can use in the
422
+ # array value for `ResourceTypeFilters`, see [Resources you can use
423
+ # with Resource Groups and Tag Editor][3] in the *Resource Groups User
424
+ # Guide*. For example:
425
+ #
426
+ # `"ResourceTypeFilters":["AWS::S3::Bucket", "AWS::EC2::Instance"]`
427
+ #
428
+ #
429
+ #
430
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html
431
+ # [2]: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html
432
+ # [3]: https://docs.aws.amazon.com/ARG/latest/userguide/supported-resources.html
433
+ # @return [Types::ResourceQuery]
434
+ #
398
435
  # @!attribute [rw] role_arn
399
436
  # The Amazon resource name (ARN) of the role assumed by Resource
400
437
  # Groups to tag and untag resources on your behalf.
@@ -439,6 +476,7 @@ module Aws::ResourceGroups
439
476
  :task_arn,
440
477
  :tag_key,
441
478
  :tag_value,
479
+ :resource_query,
442
480
  :role_arn,
443
481
  :status,
444
482
  :error_message,
@@ -1086,7 +1124,7 @@ module Aws::ResourceGroups
1086
1124
  #
1087
1125
  # * `AWS::AppRegistry::Application`
1088
1126
  #
1089
- # * `AWS::AppRegistry::ApplicationResourceGroups`
1127
+ # * `AWS::AppRegistry::ApplicationResourceGroup`
1090
1128
  #
1091
1129
  # * `AWS::CloudFormation::Stack`
1092
1130
  #
@@ -1592,6 +1630,10 @@ module Aws::ResourceGroups
1592
1630
  # added to the application. If a resource with this tag is later
1593
1631
  # untagged, the tag-sync task removes the resource from the
1594
1632
  # application.
1633
+ #
1634
+ # When using the `TagKey` parameter, you must also specify the
1635
+ # `TagValue` parameter. If you specify a tag key-value pair, you
1636
+ # can't use the `ResourceQuery` parameter.
1595
1637
  # @return [String]
1596
1638
  #
1597
1639
  # @!attribute [rw] tag_value
@@ -1599,8 +1641,53 @@ module Aws::ResourceGroups
1599
1641
  # added to the application. If a resource with this tag is later
1600
1642
  # untagged, the tag-sync task removes the resource from the
1601
1643
  # application.
1644
+ #
1645
+ # When using the `TagValue` parameter, you must also specify the
1646
+ # `TagKey` parameter. If you specify a tag key-value pair, you can't
1647
+ # use the `ResourceQuery` parameter.
1602
1648
  # @return [String]
1603
1649
  #
1650
+ # @!attribute [rw] resource_query
1651
+ # The query you can use to create the tag-sync task. With this method,
1652
+ # all resources matching the query are added to the specified
1653
+ # application group. A `ResourceQuery` specifies both a query `Type`
1654
+ # and a `Query` string as JSON string objects. For more information on
1655
+ # defining a resource query for a tag-sync task, see the tag-based
1656
+ # query type in [ Types of resource group queries][1] in *Resource
1657
+ # Groups User Guide*.
1658
+ #
1659
+ # When using the `ResourceQuery` parameter, you cannot use the
1660
+ # `TagKey` and `TagValue` parameters.
1661
+ #
1662
+ # When you combine all of the elements together into a single string,
1663
+ # any double quotes that are embedded inside another double quote pair
1664
+ # must be escaped by preceding the embedded double quote with a
1665
+ # backslash character (\\). For example, a complete `ResourceQuery`
1666
+ # parameter must be formatted like the following CLI parameter
1667
+ # example:
1668
+ #
1669
+ # `--resource-query
1670
+ # '{"Type":"TAG_FILTERS_1_0","Query":"{"ResourceTypeFilters":["AWS::AllSupported"],"TagFilters":[{"Key":"Stage","Values":["Test"]}]}"}'`
1671
+ #
1672
+ # In the preceding example, all of the double quote characters in the
1673
+ # value part of the `Query` element must be escaped because the value
1674
+ # itself is surrounded by double quotes. For more information, see
1675
+ # [Quoting strings][2] in the *Command Line Interface User Guide*.
1676
+ #
1677
+ # For the complete list of resource types that you can use in the
1678
+ # array value for `ResourceTypeFilters`, see [Resources you can use
1679
+ # with Resource Groups and Tag Editor][3] in the *Resource Groups User
1680
+ # Guide*. For example:
1681
+ #
1682
+ # `"ResourceTypeFilters":["AWS::S3::Bucket", "AWS::EC2::Instance"]`
1683
+ #
1684
+ #
1685
+ #
1686
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html#getting_started-query_types
1687
+ # [2]: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html
1688
+ # [3]: https://docs.aws.amazon.com/ARG/latest/userguide/supported-resources.html
1689
+ # @return [Types::ResourceQuery]
1690
+ #
1604
1691
  # @!attribute [rw] role_arn
1605
1692
  # The Amazon resource name (ARN) of the role assumed by the service to
1606
1693
  # tag and untag resources on your behalf.
@@ -1612,6 +1699,7 @@ module Aws::ResourceGroups
1612
1699
  :group,
1613
1700
  :tag_key,
1614
1701
  :tag_value,
1702
+ :resource_query,
1615
1703
  :role_arn)
1616
1704
  SENSITIVE = []
1617
1705
  include Aws::Structure
@@ -1638,6 +1726,43 @@ module Aws::ResourceGroups
1638
1726
  # The tag value of the tag-sync task.
1639
1727
  # @return [String]
1640
1728
  #
1729
+ # @!attribute [rw] resource_query
1730
+ # The query you can use to define a resource group or a search for
1731
+ # resources. A `ResourceQuery` specifies both a query `Type` and a
1732
+ # `Query` string as JSON string objects. See the examples section for
1733
+ # example JSON strings. For more information about creating a resource
1734
+ # group with a resource query, see [Build queries and groups in
1735
+ # Resource Groups][1] in the *Resource Groups User Guide*
1736
+ #
1737
+ # When you combine all of the elements together into a single string,
1738
+ # any double quotes that are embedded inside another double quote pair
1739
+ # must be escaped by preceding the embedded double quote with a
1740
+ # backslash character (\\). For example, a complete `ResourceQuery`
1741
+ # parameter must be formatted like the following CLI parameter
1742
+ # example:
1743
+ #
1744
+ # `--resource-query
1745
+ # '{"Type":"TAG_FILTERS_1_0","Query":"{"ResourceTypeFilters":["AWS::AllSupported"],"TagFilters":[{"Key":"Stage","Values":["Test"]}]}"}'`
1746
+ #
1747
+ # In the preceding example, all of the double quote characters in the
1748
+ # value part of the `Query` element must be escaped because the value
1749
+ # itself is surrounded by double quotes. For more information, see
1750
+ # [Quoting strings][2] in the *Command Line Interface User Guide*.
1751
+ #
1752
+ # For the complete list of resource types that you can use in the
1753
+ # array value for `ResourceTypeFilters`, see [Resources you can use
1754
+ # with Resource Groups and Tag Editor][3] in the *Resource Groups User
1755
+ # Guide*. For example:
1756
+ #
1757
+ # `"ResourceTypeFilters":["AWS::S3::Bucket", "AWS::EC2::Instance"]`
1758
+ #
1759
+ #
1760
+ #
1761
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html
1762
+ # [2]: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html
1763
+ # [3]: https://docs.aws.amazon.com/ARG/latest/userguide/supported-resources.html
1764
+ # @return [Types::ResourceQuery]
1765
+ #
1641
1766
  # @!attribute [rw] role_arn
1642
1767
  # The Amazon resource name (ARN) of the role assumed by the service to
1643
1768
  # tag and untag resources on your behalf.
@@ -1651,6 +1776,7 @@ module Aws::ResourceGroups
1651
1776
  :task_arn,
1652
1777
  :tag_key,
1653
1778
  :tag_value,
1779
+ :resource_query,
1654
1780
  :role_arn)
1655
1781
  SENSITIVE = []
1656
1782
  include Aws::Structure
@@ -1714,6 +1840,43 @@ module Aws::ResourceGroups
1714
1840
  # The tag value.
1715
1841
  # @return [String]
1716
1842
  #
1843
+ # @!attribute [rw] resource_query
1844
+ # The query you can use to define a resource group or a search for
1845
+ # resources. A `ResourceQuery` specifies both a query `Type` and a
1846
+ # `Query` string as JSON string objects. See the examples section for
1847
+ # example JSON strings. For more information about creating a resource
1848
+ # group with a resource query, see [Build queries and groups in
1849
+ # Resource Groups][1] in the *Resource Groups User Guide*
1850
+ #
1851
+ # When you combine all of the elements together into a single string,
1852
+ # any double quotes that are embedded inside another double quote pair
1853
+ # must be escaped by preceding the embedded double quote with a
1854
+ # backslash character (\\). For example, a complete `ResourceQuery`
1855
+ # parameter must be formatted like the following CLI parameter
1856
+ # example:
1857
+ #
1858
+ # `--resource-query
1859
+ # '{"Type":"TAG_FILTERS_1_0","Query":"{"ResourceTypeFilters":["AWS::AllSupported"],"TagFilters":[{"Key":"Stage","Values":["Test"]}]}"}'`
1860
+ #
1861
+ # In the preceding example, all of the double quote characters in the
1862
+ # value part of the `Query` element must be escaped because the value
1863
+ # itself is surrounded by double quotes. For more information, see
1864
+ # [Quoting strings][2] in the *Command Line Interface User Guide*.
1865
+ #
1866
+ # For the complete list of resource types that you can use in the
1867
+ # array value for `ResourceTypeFilters`, see [Resources you can use
1868
+ # with Resource Groups and Tag Editor][3] in the *Resource Groups User
1869
+ # Guide*. For example:
1870
+ #
1871
+ # `"ResourceTypeFilters":["AWS::S3::Bucket", "AWS::EC2::Instance"]`
1872
+ #
1873
+ #
1874
+ #
1875
+ # [1]: https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-query.html
1876
+ # [2]: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html
1877
+ # [3]: https://docs.aws.amazon.com/ARG/latest/userguide/supported-resources.html
1878
+ # @return [Types::ResourceQuery]
1879
+ #
1717
1880
  # @!attribute [rw] role_arn
1718
1881
  # The Amazon resource name (ARN) of the role assumed by the service to
1719
1882
  # tag and untag resources on your behalf.
@@ -1751,6 +1914,7 @@ module Aws::ResourceGroups
1751
1914
  :task_arn,
1752
1915
  :tag_key,
1753
1916
  :tag_value,
1917
+ :resource_query,
1754
1918
  :role_arn,
1755
1919
  :status,
1756
1920
  :error_message,
@@ -54,7 +54,7 @@ module Aws::ResourceGroups
54
54
  autoload :EndpointProvider, 'aws-sdk-resourcegroups/endpoint_provider'
55
55
  autoload :Endpoints, 'aws-sdk-resourcegroups/endpoints'
56
56
 
57
- GEM_VERSION = '1.78.0'
57
+ GEM_VERSION = '1.80.0'
58
58
 
59
59
  end
60
60
 
data/sig/client.rbs CHANGED
@@ -174,6 +174,7 @@ module Aws
174
174
  def task_arn: () -> ::String
175
175
  def tag_key: () -> ::String
176
176
  def tag_value: () -> ::String
177
+ def resource_query: () -> Types::ResourceQuery
177
178
  def role_arn: () -> ::String
178
179
  def status: () -> ("ACTIVE" | "ERROR")
179
180
  def error_message: () -> ::String
@@ -332,13 +333,18 @@ module Aws
332
333
  def task_arn: () -> ::String
333
334
  def tag_key: () -> ::String
334
335
  def tag_value: () -> ::String
336
+ def resource_query: () -> Types::ResourceQuery
335
337
  def role_arn: () -> ::String
336
338
  end
337
339
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ResourceGroups/Client.html#start_tag_sync_task-instance_method
338
340
  def start_tag_sync_task: (
339
341
  group: ::String,
340
- tag_key: ::String,
341
- tag_value: ::String,
342
+ ?tag_key: ::String,
343
+ ?tag_value: ::String,
344
+ ?resource_query: {
345
+ type: ("TAG_FILTERS_1_0" | "CLOUDFORMATION_STACK_1_0"),
346
+ query: ::String
347
+ },
342
348
  role_arn: ::String
343
349
  ) -> _StartTagSyncTaskResponseSuccess
344
350
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StartTagSyncTaskResponseSuccess
data/sig/types.rbs CHANGED
@@ -116,6 +116,7 @@ module Aws::ResourceGroups
116
116
  attr_accessor task_arn: ::String
117
117
  attr_accessor tag_key: ::String
118
118
  attr_accessor tag_value: ::String
119
+ attr_accessor resource_query: Types::ResourceQuery
119
120
  attr_accessor role_arn: ::String
120
121
  attr_accessor status: ("ACTIVE" | "ERROR")
121
122
  attr_accessor error_message: ::String
@@ -363,6 +364,7 @@ module Aws::ResourceGroups
363
364
  attr_accessor group: ::String
364
365
  attr_accessor tag_key: ::String
365
366
  attr_accessor tag_value: ::String
367
+ attr_accessor resource_query: Types::ResourceQuery
366
368
  attr_accessor role_arn: ::String
367
369
  SENSITIVE: []
368
370
  end
@@ -373,6 +375,7 @@ module Aws::ResourceGroups
373
375
  attr_accessor task_arn: ::String
374
376
  attr_accessor tag_key: ::String
375
377
  attr_accessor tag_value: ::String
378
+ attr_accessor resource_query: Types::ResourceQuery
376
379
  attr_accessor role_arn: ::String
377
380
  SENSITIVE: []
378
381
  end
@@ -395,6 +398,7 @@ module Aws::ResourceGroups
395
398
  attr_accessor task_arn: ::String
396
399
  attr_accessor tag_key: ::String
397
400
  attr_accessor tag_value: ::String
401
+ attr_accessor resource_query: Types::ResourceQuery
398
402
  attr_accessor role_arn: ::String
399
403
  attr_accessor status: ("ACTIVE" | "ERROR")
400
404
  attr_accessor error_message: ::String
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.78.0
4
+ version: 1.80.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: 2025-02-06 00:00:00.000000000 Z
11
+ date: 2025-04-16 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core