aws-sdk-recyclebin 1.2.0 → 1.4.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: 1633ced0f15467ee60961a123b8ec0d2f5f2dd94f136f8aa89267a1ecb2233d6
4
- data.tar.gz: 1ac59bdac54405abd789764f149cb90d105c4a9dabdd04fea870d352838ff746
3
+ metadata.gz: 3ccbca1c97b923c10868fea20ab404f0ddf185217ac1b867f8f3b46bf614e987
4
+ data.tar.gz: cee4ff3768a7ea7152f6a8565338d6b29b6568f38de3d1b3d5bae244676c42aa
5
5
  SHA512:
6
- metadata.gz: f168cd6828f59d26c623c1be7edc1e8ba294d471a405c60126a6c7865ed18555f1d8c737bd117d2d079b2adf28ae3f6d8ed305bf1d8800fb7a451c4437452603
7
- data.tar.gz: c3f307aad8f60ce1d52a04ced5c66d68a68ef22b3f2e60ce8e7ee3752dd0b873e35086c900f0f094a7da1905b6f3465198ebc03d8bda14591ef4f782ff163705
6
+ metadata.gz: 426a3592957f19314b42b52af7e212663bb85e015ed94cd9dd25c86144146fc8b8780c593ba49f0e761953b4a77d4b558990eb7c3839d90dc7321e13b9de2658
7
+ data.tar.gz: 785025e6accc66f1aa1d73b23335a97aa2b5c8a2d1acf39f41a742817b447b52368e5f625ac7b84669d8e15dbb72ee3b1b441fef4a879877e5ce9521221ad523
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.4.0 (2022-02-03)
5
+ ------------------
6
+
7
+ * Feature - Add EC2 Image recycle bin support.
8
+
9
+ 1.3.0 (2022-02-03)
10
+ ------------------
11
+
12
+ * Feature - Add EC2 Image recycle bin support.
13
+
4
14
  1.2.0 (2021-12-21)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.2.0
1
+ 1.4.0
@@ -28,6 +28,7 @@ require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
30
  require 'aws-sdk-core/plugins/defaults_mode.rb'
31
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
31
32
  require 'aws-sdk-core/plugins/signature_v4.rb'
32
33
  require 'aws-sdk-core/plugins/protocols/rest_json.rb'
33
34
 
@@ -75,6 +76,7 @@ module Aws::RecycleBin
75
76
  add_plugin(Aws::Plugins::TransferEncoding)
76
77
  add_plugin(Aws::Plugins::HttpChecksum)
77
78
  add_plugin(Aws::Plugins::DefaultsMode)
79
+ add_plugin(Aws::Plugins::RecursionDetection)
78
80
  add_plugin(Aws::Plugins::SignatureV4)
79
81
  add_plugin(Aws::Plugins::Protocols::RestJson)
80
82
 
@@ -348,7 +350,8 @@ module Aws::RecycleBin
348
350
  # @!group API Operations
349
351
 
350
352
  # Creates a Recycle Bin retention rule. For more information, see [
351
- # Create Recycle Bin retention rules][1] in the *Amazon EC2 User Guide*.
353
+ # Create Recycle Bin retention rules][1] in the *Amazon Elastic Compute
354
+ # Cloud User Guide*.
352
355
  #
353
356
  #
354
357
  #
@@ -359,26 +362,35 @@ module Aws::RecycleBin
359
362
  # to retain resources.
360
363
  #
361
364
  # @option params [String] :description
362
- # A brief description for the retention rule.
365
+ # The retention rule description.
363
366
  #
364
367
  # @option params [Array<Types::Tag>] :tags
365
368
  # Information about the tags to assign to the retention rule.
366
369
  #
367
370
  # @option params [required, String] :resource_type
368
371
  # The resource type to be retained by the retention rule. Currently,
369
- # only Amazon EBS snapshots are supported.
372
+ # only Amazon EBS snapshots and EBS-backed AMIs are supported. To retain
373
+ # snapshots, specify `EBS_SNAPSHOT`. To retain EBS-backed AMIs, specify
374
+ # `EC2_IMAGE`.
370
375
  #
371
376
  # @option params [Array<Types::ResourceTag>] :resource_tags
372
- # Information about the resource tags to use to identify resources that
373
- # are to be retained by the retention rule. The retention rule retains
374
- # only deleted snapshots that have one or more of the specified tag key
375
- # and value pairs. If a snapshot is deleted, but it does not have any of
376
- # the specified tag key and value pairs, it is immediately deleted
377
- # without being retained by the retention rule.
377
+ # Specifies the resource tags to use to identify resources that are to
378
+ # be retained by a tag-level retention rule. For tag-level retention
379
+ # rules, only deleted resources, of the specified resource type, that
380
+ # have one or more of the specified tag key and value pairs are
381
+ # retained. If a resource is deleted, but it does not have any of the
382
+ # specified tag key and value pairs, it is immediately deleted without
383
+ # being retained by the retention rule.
378
384
  #
379
385
  # You can add the same tag key and value pair to a maximum or five
380
386
  # retention rules.
381
387
  #
388
+ # To create a Region-level retention rule, omit this parameter. A
389
+ # Region-level retention rule does not have any resource tags specified.
390
+ # It retains all deleted resources of the specified resource type in the
391
+ # Region in which the rule is created, even if the resources are not
392
+ # tagged.
393
+ #
382
394
  # @return [Types::CreateRuleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
383
395
  #
384
396
  # * {Types::CreateRuleResponse#identifier #identifier} => String
@@ -403,7 +415,7 @@ module Aws::RecycleBin
403
415
  # value: "TagValue", # required
404
416
  # },
405
417
  # ],
406
- # resource_type: "EBS_SNAPSHOT", # required, accepts EBS_SNAPSHOT
418
+ # resource_type: "EBS_SNAPSHOT", # required, accepts EBS_SNAPSHOT, EC2_IMAGE
407
419
  # resource_tags: [
408
420
  # {
409
421
  # resource_tag_key: "ResourceTagKey", # required
@@ -421,7 +433,7 @@ module Aws::RecycleBin
421
433
  # resp.tags #=> Array
422
434
  # resp.tags[0].key #=> String
423
435
  # resp.tags[0].value #=> String
424
- # resp.resource_type #=> String, one of "EBS_SNAPSHOT"
436
+ # resp.resource_type #=> String, one of "EBS_SNAPSHOT", "EC2_IMAGE"
425
437
  # resp.resource_tags #=> Array
426
438
  # resp.resource_tags[0].resource_tag_key #=> String
427
439
  # resp.resource_tags[0].resource_tag_value #=> String
@@ -437,14 +449,15 @@ module Aws::RecycleBin
437
449
  end
438
450
 
439
451
  # Deletes a Recycle Bin retention rule. For more information, see [
440
- # Delete Recycle Bin retention rules][1] in the *Amazon EC2 User Guide*.
452
+ # Delete Recycle Bin retention rules][1] in the *Amazon Elastic Compute
453
+ # Cloud User Guide*.
441
454
  #
442
455
  #
443
456
  #
444
457
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recycle-bin-working-with-rules.html#recycle-bin-delete-rule
445
458
  #
446
459
  # @option params [required, String] :identifier
447
- # The unique ID of the retention rule to delete.
460
+ # The unique ID of the retention rule.
448
461
  #
449
462
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
450
463
  #
@@ -487,7 +500,7 @@ module Aws::RecycleBin
487
500
  #
488
501
  # resp.identifier #=> String
489
502
  # resp.description #=> String
490
- # resp.resource_type #=> String, one of "EBS_SNAPSHOT"
503
+ # resp.resource_type #=> String, one of "EBS_SNAPSHOT", "EC2_IMAGE"
491
504
  # resp.retention_period.retention_period_value #=> Integer
492
505
  # resp.retention_period.retention_period_unit #=> String, one of "DAYS"
493
506
  # resp.resource_tags #=> Array
@@ -507,22 +520,23 @@ module Aws::RecycleBin
507
520
  # Lists the Recycle Bin retention rules in the Region.
508
521
  #
509
522
  # @option params [Integer] :max_results
510
- # The maximum number of results to return for the request in a single
511
- # page. The remaining results can be seen by sending another request
512
- # with the returned `nextToken` value. This value can be between 5 and
513
- # 500. If `maxResults` is given a larger value than 500, you receive an
514
- # error.
523
+ # The maximum number of results to return with a single call. To
524
+ # retrieve the remaining results, make another call with the returned
525
+ # `NextToken` value.
515
526
  #
516
527
  # @option params [String] :next_token
517
- # The token to use to retrieve the next page of results.
528
+ # The token for the next page of results.
518
529
  #
519
530
  # @option params [required, String] :resource_type
520
531
  # The resource type retained by the retention rule. Only retention rules
521
- # that retain the specified resource type are listed.
532
+ # that retain the specified resource type are listed. Currently, only
533
+ # Amazon EBS snapshots and EBS-backed AMIs are supported. To list
534
+ # retention rules that retain snapshots, specify `EBS_SNAPSHOT`. To list
535
+ # retention rules that retain EBS-backed AMIs, specify `EC2_IMAGE`.
522
536
  #
523
537
  # @option params [Array<Types::ResourceTag>] :resource_tags
524
- # The tags used to identify resources that are to be retained by the
525
- # retention rule.
538
+ # Information about the resource tags used to identify resources that
539
+ # are retained by the retention rule.
526
540
  #
527
541
  # @return [Types::ListRulesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
528
542
  #
@@ -536,7 +550,7 @@ module Aws::RecycleBin
536
550
  # resp = client.list_rules({
537
551
  # max_results: 1,
538
552
  # next_token: "NextToken",
539
- # resource_type: "EBS_SNAPSHOT", # required, accepts EBS_SNAPSHOT
553
+ # resource_type: "EBS_SNAPSHOT", # required, accepts EBS_SNAPSHOT, EC2_IMAGE
540
554
  # resource_tags: [
541
555
  # {
542
556
  # resource_tag_key: "ResourceTagKey", # required
@@ -563,11 +577,10 @@ module Aws::RecycleBin
563
577
  req.send_request(options)
564
578
  end
565
579
 
566
- # Lists the tags assigned a specific resource.
580
+ # Lists the tags assigned to a retention rule.
567
581
  #
568
582
  # @option params [required, String] :resource_arn
569
- # The Amazon Resource Name (ARN) of the resource for which to list the
570
- # tags.
583
+ # The Amazon Resource Name (ARN) of the retention rule.
571
584
  #
572
585
  # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
573
586
  #
@@ -594,14 +607,13 @@ module Aws::RecycleBin
594
607
  req.send_request(options)
595
608
  end
596
609
 
597
- # Assigns tags to the specified resource.
610
+ # Assigns tags to the specified retention rule.
598
611
  #
599
612
  # @option params [required, String] :resource_arn
600
- # The Amazon Resource Name (ARN) of the resource to which to assign the
601
- # tags.
613
+ # The Amazon Resource Name (ARN) of the retention rule.
602
614
  #
603
615
  # @option params [required, Array<Types::Tag>] :tags
604
- # Information about the tags to assign to the resource.
616
+ # Information about the tags to assign to the retention rule.
605
617
  #
606
618
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
607
619
  #
@@ -626,14 +638,14 @@ module Aws::RecycleBin
626
638
  req.send_request(options)
627
639
  end
628
640
 
629
- # Unassigns a tag from a resource.
641
+ # Unassigns a tag from a retention rule.
630
642
  #
631
643
  # @option params [required, String] :resource_arn
632
- # The Amazon Resource Name (ARN) of the resource from which to unassign
633
- # the tags.
644
+ # The Amazon Resource Name (ARN) of the retention rule.
634
645
  #
635
646
  # @option params [required, Array<String>] :tag_keys
636
- # Information about the tags to unassign from the resource.
647
+ # The tag keys of the tags to unassign. All tags that have the specified
648
+ # tag key are unassigned.
637
649
  #
638
650
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
639
651
  #
@@ -654,15 +666,15 @@ module Aws::RecycleBin
654
666
  end
655
667
 
656
668
  # Updates an existing Recycle Bin retention rule. For more information,
657
- # see [ Update Recycle Bin retention rules][1] in the *Amazon EC2 User
658
- # Guide*.
669
+ # see [ Update Recycle Bin retention rules][1] in the *Amazon Elastic
670
+ # Compute Cloud User Guide*.
659
671
  #
660
672
  #
661
673
  #
662
674
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/recycle-bin-working-with-rules.html#recycle-bin-update-rule
663
675
  #
664
676
  # @option params [required, String] :identifier
665
- # The unique ID of the retention rule to update.
677
+ # The unique ID of the retention rule.
666
678
  #
667
679
  # @option params [Types::RetentionPeriod] :retention_period
668
680
  # Information about the retention period for which the retention rule is
@@ -673,19 +685,28 @@ module Aws::RecycleBin
673
685
  #
674
686
  # @option params [String] :resource_type
675
687
  # The resource type to be retained by the retention rule. Currently,
676
- # only Amazon EBS snapshots are supported.
688
+ # only Amazon EBS snapshots and EBS-backed AMIs are supported. To retain
689
+ # snapshots, specify `EBS_SNAPSHOT`. To retain EBS-backed AMIs, specify
690
+ # `EC2_IMAGE`.
677
691
  #
678
692
  # @option params [Array<Types::ResourceTag>] :resource_tags
679
- # Information about the resource tags to use to identify resources that
680
- # are to be retained by the retention rule. The retention rule retains
681
- # only deleted snapshots that have one or more of the specified tag key
682
- # and value pairs. If a snapshot is deleted, but it does not have any of
683
- # the specified tag key and value pairs, it is immediately deleted
684
- # without being retained by the retention rule.
693
+ # Specifies the resource tags to use to identify resources that are to
694
+ # be retained by a tag-level retention rule. For tag-level retention
695
+ # rules, only deleted resources, of the specified resource type, that
696
+ # have one or more of the specified tag key and value pairs are
697
+ # retained. If a resource is deleted, but it does not have any of the
698
+ # specified tag key and value pairs, it is immediately deleted without
699
+ # being retained by the retention rule.
685
700
  #
686
701
  # You can add the same tag key and value pair to a maximum or five
687
702
  # retention rules.
688
703
  #
704
+ # To create a Region-level retention rule, omit this parameter. A
705
+ # Region-level retention rule does not have any resource tags specified.
706
+ # It retains all deleted resources of the specified resource type in the
707
+ # Region in which the rule is created, even if the resources are not
708
+ # tagged.
709
+ #
689
710
  # @return [Types::UpdateRuleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
690
711
  #
691
712
  # * {Types::UpdateRuleResponse#identifier #identifier} => String
@@ -704,7 +725,7 @@ module Aws::RecycleBin
704
725
  # retention_period_unit: "DAYS", # required, accepts DAYS
705
726
  # },
706
727
  # description: "Description",
707
- # resource_type: "EBS_SNAPSHOT", # accepts EBS_SNAPSHOT
728
+ # resource_type: "EBS_SNAPSHOT", # accepts EBS_SNAPSHOT, EC2_IMAGE
708
729
  # resource_tags: [
709
730
  # {
710
731
  # resource_tag_key: "ResourceTagKey", # required
@@ -719,7 +740,7 @@ module Aws::RecycleBin
719
740
  # resp.retention_period.retention_period_value #=> Integer
720
741
  # resp.retention_period.retention_period_unit #=> String, one of "DAYS"
721
742
  # resp.description #=> String
722
- # resp.resource_type #=> String, one of "EBS_SNAPSHOT"
743
+ # resp.resource_type #=> String, one of "EBS_SNAPSHOT", "EC2_IMAGE"
723
744
  # resp.resource_tags #=> Array
724
745
  # resp.resource_tags[0].resource_tag_key #=> String
725
746
  # resp.resource_tags[0].resource_tag_value #=> String
@@ -747,7 +768,7 @@ module Aws::RecycleBin
747
768
  params: params,
748
769
  config: config)
749
770
  context[:gem_name] = 'aws-sdk-recyclebin'
750
- context[:gem_version] = '1.2.0'
771
+ context[:gem_version] = '1.4.0'
751
772
  Seahorse::Client::Request.new(handlers, context)
752
773
  end
753
774
 
@@ -25,7 +25,7 @@ module Aws::RecycleBin
25
25
  # value: "TagValue", # required
26
26
  # },
27
27
  # ],
28
- # resource_type: "EBS_SNAPSHOT", # required, accepts EBS_SNAPSHOT
28
+ # resource_type: "EBS_SNAPSHOT", # required, accepts EBS_SNAPSHOT, EC2_IMAGE
29
29
  # resource_tags: [
30
30
  # {
31
31
  # resource_tag_key: "ResourceTagKey", # required
@@ -40,7 +40,7 @@ module Aws::RecycleBin
40
40
  # @return [Types::RetentionPeriod]
41
41
  #
42
42
  # @!attribute [rw] description
43
- # A brief description for the retention rule.
43
+ # The retention rule description.
44
44
  # @return [String]
45
45
  #
46
46
  # @!attribute [rw] tags
@@ -49,19 +49,28 @@ module Aws::RecycleBin
49
49
  #
50
50
  # @!attribute [rw] resource_type
51
51
  # The resource type to be retained by the retention rule. Currently,
52
- # only Amazon EBS snapshots are supported.
52
+ # only Amazon EBS snapshots and EBS-backed AMIs are supported. To
53
+ # retain snapshots, specify `EBS_SNAPSHOT`. To retain EBS-backed AMIs,
54
+ # specify `EC2_IMAGE`.
53
55
  # @return [String]
54
56
  #
55
57
  # @!attribute [rw] resource_tags
56
- # Information about the resource tags to use to identify resources
57
- # that are to be retained by the retention rule. The retention rule
58
- # retains only deleted snapshots that have one or more of the
59
- # specified tag key and value pairs. If a snapshot is deleted, but it
60
- # does not have any of the specified tag key and value pairs, it is
61
- # immediately deleted without being retained by the retention rule.
58
+ # Specifies the resource tags to use to identify resources that are to
59
+ # be retained by a tag-level retention rule. For tag-level retention
60
+ # rules, only deleted resources, of the specified resource type, that
61
+ # have one or more of the specified tag key and value pairs are
62
+ # retained. If a resource is deleted, but it does not have any of the
63
+ # specified tag key and value pairs, it is immediately deleted without
64
+ # being retained by the retention rule.
62
65
  #
63
66
  # You can add the same tag key and value pair to a maximum or five
64
67
  # retention rules.
68
+ #
69
+ # To create a Region-level retention rule, omit this parameter. A
70
+ # Region-level retention rule does not have any resource tags
71
+ # specified. It retains all deleted resources of the specified
72
+ # resource type in the Region in which the rule is created, even if
73
+ # the resources are not tagged.
65
74
  # @return [Array<Types::ResourceTag>]
66
75
  #
67
76
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/CreateRuleRequest AWS API Documentation
@@ -77,12 +86,12 @@ module Aws::RecycleBin
77
86
  end
78
87
 
79
88
  # @!attribute [rw] identifier
80
- # The unique identifier of the retention rule.
89
+ # The unique ID of the retention rule.
81
90
  # @return [String]
82
91
  #
83
92
  # @!attribute [rw] retention_period
84
- # Information about the retention period for which a retention rule is
85
- # to retain resources.
93
+ # Information about the retention period for which the retention rule
94
+ # is to retain resources.
86
95
  # @return [Types::RetentionPeriod]
87
96
  #
88
97
  # @!attribute [rw] description
@@ -90,7 +99,7 @@ module Aws::RecycleBin
90
99
  # @return [String]
91
100
  #
92
101
  # @!attribute [rw] tags
93
- # The tags assigned to the retention rule.
102
+ # Information about the tags assigned to the retention rule.
94
103
  # @return [Array<Types::Tag>]
95
104
  #
96
105
  # @!attribute [rw] resource_type
@@ -104,7 +113,7 @@ module Aws::RecycleBin
104
113
  #
105
114
  # @!attribute [rw] status
106
115
  # The state of the retention rule. Only retention rules that are in
107
- # the `available` state retain snapshots.
116
+ # the `available` state retain resources.
108
117
  # @return [String]
109
118
  #
110
119
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/CreateRuleResponse AWS API Documentation
@@ -129,7 +138,7 @@ module Aws::RecycleBin
129
138
  # }
130
139
  #
131
140
  # @!attribute [rw] identifier
132
- # The unique ID of the retention rule to delete.
141
+ # The unique ID of the retention rule.
133
142
  # @return [String]
134
143
  #
135
144
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/DeleteRuleRequest AWS API Documentation
@@ -168,27 +177,26 @@ module Aws::RecycleBin
168
177
  # @return [String]
169
178
  #
170
179
  # @!attribute [rw] description
171
- # The description assigned to the retention rule.
180
+ # The retention rule description.
172
181
  # @return [String]
173
182
  #
174
183
  # @!attribute [rw] resource_type
175
- # The resource type retained by the retention rule. Currently, only
176
- # Amazon EBS snapshots are supported.
184
+ # The resource type retained by the retention rule.
177
185
  # @return [String]
178
186
  #
179
187
  # @!attribute [rw] retention_period
180
- # Information about the period for which the retention rule retains
181
- # resources.
188
+ # Information about the retention period for which the retention rule
189
+ # is to retain resources.
182
190
  # @return [Types::RetentionPeriod]
183
191
  #
184
192
  # @!attribute [rw] resource_tags
185
- # The resource tags used to identify resources that are to be retained
186
- # by the retention rule.
193
+ # Information about the resource tags used to identify resources that
194
+ # are retained by the retention rule.
187
195
  # @return [Array<Types::ResourceTag>]
188
196
  #
189
197
  # @!attribute [rw] status
190
198
  # The state of the retention rule. Only retention rules that are in
191
- # the `available` state retain snapshots.
199
+ # the `available` state retain resources.
192
200
  # @return [String]
193
201
  #
194
202
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/GetRuleResponse AWS API Documentation
@@ -224,7 +232,7 @@ module Aws::RecycleBin
224
232
  # {
225
233
  # max_results: 1,
226
234
  # next_token: "NextToken",
227
- # resource_type: "EBS_SNAPSHOT", # required, accepts EBS_SNAPSHOT
235
+ # resource_type: "EBS_SNAPSHOT", # required, accepts EBS_SNAPSHOT, EC2_IMAGE
228
236
  # resource_tags: [
229
237
  # {
230
238
  # resource_tag_key: "ResourceTagKey", # required
@@ -234,25 +242,27 @@ module Aws::RecycleBin
234
242
  # }
235
243
  #
236
244
  # @!attribute [rw] max_results
237
- # The maximum number of results to return for the request in a single
238
- # page. The remaining results can be seen by sending another request
239
- # with the returned `nextToken` value. This value can be between 5 and
240
- # 500. If `maxResults` is given a larger value than 500, you receive
241
- # an error.
245
+ # The maximum number of results to return with a single call. To
246
+ # retrieve the remaining results, make another call with the returned
247
+ # `NextToken` value.
242
248
  # @return [Integer]
243
249
  #
244
250
  # @!attribute [rw] next_token
245
- # The token to use to retrieve the next page of results.
251
+ # The token for the next page of results.
246
252
  # @return [String]
247
253
  #
248
254
  # @!attribute [rw] resource_type
249
255
  # The resource type retained by the retention rule. Only retention
250
- # rules that retain the specified resource type are listed.
256
+ # rules that retain the specified resource type are listed. Currently,
257
+ # only Amazon EBS snapshots and EBS-backed AMIs are supported. To list
258
+ # retention rules that retain snapshots, specify `EBS_SNAPSHOT`. To
259
+ # list retention rules that retain EBS-backed AMIs, specify
260
+ # `EC2_IMAGE`.
251
261
  # @return [String]
252
262
  #
253
263
  # @!attribute [rw] resource_tags
254
- # The tags used to identify resources that are to be retained by the
255
- # retention rule.
264
+ # Information about the resource tags used to identify resources that
265
+ # are retained by the retention rule.
256
266
  # @return [Array<Types::ResourceTag>]
257
267
  #
258
268
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/ListRulesRequest AWS API Documentation
@@ -292,8 +302,7 @@ module Aws::RecycleBin
292
302
  # }
293
303
  #
294
304
  # @!attribute [rw] resource_arn
295
- # The Amazon Resource Name (ARN) of the resource for which to list the
296
- # tags.
305
+ # The Amazon Resource Name (ARN) of the retention rule.
297
306
  # @return [String]
298
307
  #
299
308
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/ListTagsForResourceRequest AWS API Documentation
@@ -305,7 +314,7 @@ module Aws::RecycleBin
305
314
  end
306
315
 
307
316
  # @!attribute [rw] tags
308
- # Information about the tags assigned to the resource.
317
+ # Information about the tags assigned to the retention rule.
309
318
  # @return [Array<Types::Tag>]
310
319
  #
311
320
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/ListTagsForResourceResponse AWS API Documentation
@@ -334,8 +343,8 @@ module Aws::RecycleBin
334
343
  include Aws::Structure
335
344
  end
336
345
 
337
- # Information about a resource tag used to identify resources that are
338
- # to be retained by a Recycle Bin retention rule.
346
+ # Information about the resource tags used to identify resources that
347
+ # are retained by the retention rule.
339
348
  #
340
349
  # @note When making an API call, you may pass ResourceTag
341
350
  # data as a hash:
@@ -362,7 +371,7 @@ module Aws::RecycleBin
362
371
  include Aws::Structure
363
372
  end
364
373
 
365
- # Information about the retention period for which a retention rule is
374
+ # Information about the retention period for which the retention rule is
366
375
  # to retain resources.
367
376
  #
368
377
  # @note When making an API call, you may pass RetentionPeriod
@@ -400,12 +409,12 @@ module Aws::RecycleBin
400
409
  # @return [String]
401
410
  #
402
411
  # @!attribute [rw] description
403
- # The description for the retention rule.
412
+ # The retention rule description.
404
413
  # @return [String]
405
414
  #
406
415
  # @!attribute [rw] retention_period
407
416
  # Information about the retention period for which the retention rule
408
- # retains resources
417
+ # is to retain resources.
409
418
  # @return [Types::RetentionPeriod]
410
419
  #
411
420
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/RuleSummary AWS API Documentation
@@ -437,7 +446,7 @@ module Aws::RecycleBin
437
446
  include Aws::Structure
438
447
  end
439
448
 
440
- # Information about the tags assigned to a Recycle Bin retention rule.
449
+ # Information about the tags to assign to the retention rule.
441
450
  #
442
451
  # @note When making an API call, you may pass Tag
443
452
  # data as a hash:
@@ -478,12 +487,11 @@ module Aws::RecycleBin
478
487
  # }
479
488
  #
480
489
  # @!attribute [rw] resource_arn
481
- # The Amazon Resource Name (ARN) of the resource to which to assign
482
- # the tags.
490
+ # The Amazon Resource Name (ARN) of the retention rule.
483
491
  # @return [String]
484
492
  #
485
493
  # @!attribute [rw] tags
486
- # Information about the tags to assign to the resource.
494
+ # Information about the tags to assign to the retention rule.
487
495
  # @return [Array<Types::Tag>]
488
496
  #
489
497
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/TagResourceRequest AWS API Documentation
@@ -508,12 +516,12 @@ module Aws::RecycleBin
508
516
  # }
509
517
  #
510
518
  # @!attribute [rw] resource_arn
511
- # The Amazon Resource Name (ARN) of the resource from which to
512
- # unassign the tags.
519
+ # The Amazon Resource Name (ARN) of the retention rule.
513
520
  # @return [String]
514
521
  #
515
522
  # @!attribute [rw] tag_keys
516
- # Information about the tags to unassign from the resource.
523
+ # The tag keys of the tags to unassign. All tags that have the
524
+ # specified tag key are unassigned.
517
525
  # @return [Array<String>]
518
526
  #
519
527
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/UntagResourceRequest AWS API Documentation
@@ -539,7 +547,7 @@ module Aws::RecycleBin
539
547
  # retention_period_unit: "DAYS", # required, accepts DAYS
540
548
  # },
541
549
  # description: "Description",
542
- # resource_type: "EBS_SNAPSHOT", # accepts EBS_SNAPSHOT
550
+ # resource_type: "EBS_SNAPSHOT", # accepts EBS_SNAPSHOT, EC2_IMAGE
543
551
  # resource_tags: [
544
552
  # {
545
553
  # resource_tag_key: "ResourceTagKey", # required
@@ -549,7 +557,7 @@ module Aws::RecycleBin
549
557
  # }
550
558
  #
551
559
  # @!attribute [rw] identifier
552
- # The unique ID of the retention rule to update.
560
+ # The unique ID of the retention rule.
553
561
  # @return [String]
554
562
  #
555
563
  # @!attribute [rw] retention_period
@@ -563,19 +571,28 @@ module Aws::RecycleBin
563
571
  #
564
572
  # @!attribute [rw] resource_type
565
573
  # The resource type to be retained by the retention rule. Currently,
566
- # only Amazon EBS snapshots are supported.
574
+ # only Amazon EBS snapshots and EBS-backed AMIs are supported. To
575
+ # retain snapshots, specify `EBS_SNAPSHOT`. To retain EBS-backed AMIs,
576
+ # specify `EC2_IMAGE`.
567
577
  # @return [String]
568
578
  #
569
579
  # @!attribute [rw] resource_tags
570
- # Information about the resource tags to use to identify resources
571
- # that are to be retained by the retention rule. The retention rule
572
- # retains only deleted snapshots that have one or more of the
573
- # specified tag key and value pairs. If a snapshot is deleted, but it
574
- # does not have any of the specified tag key and value pairs, it is
575
- # immediately deleted without being retained by the retention rule.
580
+ # Specifies the resource tags to use to identify resources that are to
581
+ # be retained by a tag-level retention rule. For tag-level retention
582
+ # rules, only deleted resources, of the specified resource type, that
583
+ # have one or more of the specified tag key and value pairs are
584
+ # retained. If a resource is deleted, but it does not have any of the
585
+ # specified tag key and value pairs, it is immediately deleted without
586
+ # being retained by the retention rule.
576
587
  #
577
588
  # You can add the same tag key and value pair to a maximum or five
578
589
  # retention rules.
590
+ #
591
+ # To create a Region-level retention rule, omit this parameter. A
592
+ # Region-level retention rule does not have any resource tags
593
+ # specified. It retains all deleted resources of the specified
594
+ # resource type in the Region in which the rule is created, even if
595
+ # the resources are not tagged.
579
596
  # @return [Array<Types::ResourceTag>]
580
597
  #
581
598
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/UpdateRuleRequest AWS API Documentation
@@ -595,8 +612,8 @@ module Aws::RecycleBin
595
612
  # @return [String]
596
613
  #
597
614
  # @!attribute [rw] retention_period
598
- # Information about the retention period for which a retention rule is
599
- # to retain resources.
615
+ # Information about the retention period for which the retention rule
616
+ # is to retain resources.
600
617
  # @return [Types::RetentionPeriod]
601
618
  #
602
619
  # @!attribute [rw] description
@@ -614,7 +631,7 @@ module Aws::RecycleBin
614
631
  #
615
632
  # @!attribute [rw] status
616
633
  # The state of the retention rule. Only retention rules that are in
617
- # the `available` state retain snapshots.
634
+ # the `available` state retain resources.
618
635
  # @return [String]
619
636
  #
620
637
  # @see http://docs.aws.amazon.com/goto/WebAPI/rbin-2021-06-15/UpdateRuleResponse AWS API Documentation
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-recyclebin/customizations'
48
48
  # @!group service
49
49
  module Aws::RecycleBin
50
50
 
51
- GEM_VERSION = '1.2.0'
51
+ GEM_VERSION = '1.4.0'
52
52
 
53
53
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-recyclebin
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.2.0
4
+ version: 1.4.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: 2021-12-21 00:00:00.000000000 Z
11
+ date: 2022-02-03 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.125.0
22
+ version: 3.126.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.125.0
32
+ version: 3.126.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement