aws-sdk-dlm 1.51.0 → 1.52.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 +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-dlm/client.rb +36 -1
- data/lib/aws-sdk-dlm/client_api.rb +19 -2
- data/lib/aws-sdk-dlm/types.rb +227 -17
- data/lib/aws-sdk-dlm.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: e3b97ce83c98e75db8602e18cd75e8e4bb66dad9c9f9901675bb9cad2bd706d1
|
|
4
|
+
data.tar.gz: dec512bd9776a088471cf5a9e9ee1a293400c52512070033fa376133e242a3c9
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 36e7a9a15c235e48cc6bc982ffe7091d408fb37125fedf8567d6af1eb468c6b3b604464bc36ad1935c0dc84a9cca65bba138c247391b889540c0dd2bab8b27eb
|
|
7
|
+
data.tar.gz: 96fab2034acfe67a667cfdcba7682e0341870c7c6b91d123867acec702a8f39aa91f055b3cc0657ce43a189601a9cae18cb4cceb48e678a7ebcd7c8845aadfce
|
data/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
Unreleased Changes
|
|
2
2
|
------------------
|
|
3
3
|
|
|
4
|
+
1.52.0 (2022-09-30)
|
|
5
|
+
------------------
|
|
6
|
+
|
|
7
|
+
* Feature - This release adds support for archival of single-volume snapshots created by Amazon Data Lifecycle Manager policies
|
|
8
|
+
|
|
4
9
|
1.51.0 (2022-08-10)
|
|
5
10
|
------------------
|
|
6
11
|
|
data/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.52.0
|
data/lib/aws-sdk-dlm/client.rb
CHANGED
|
@@ -454,6 +454,15 @@ module Aws::DLM
|
|
|
454
454
|
# interval: 1,
|
|
455
455
|
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
456
456
|
# },
|
|
457
|
+
# archive_rule: {
|
|
458
|
+
# retain_rule: { # required
|
|
459
|
+
# retention_archive_tier: { # required
|
|
460
|
+
# count: 1,
|
|
461
|
+
# interval: 1,
|
|
462
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
463
|
+
# },
|
|
464
|
+
# },
|
|
465
|
+
# },
|
|
457
466
|
# },
|
|
458
467
|
# ],
|
|
459
468
|
# parameters: {
|
|
@@ -514,6 +523,13 @@ module Aws::DLM
|
|
|
514
523
|
# Deletes the specified lifecycle policy and halts the automated
|
|
515
524
|
# operations that the policy specified.
|
|
516
525
|
#
|
|
526
|
+
# For more information about deleting a policy, see [Delete lifecycle
|
|
527
|
+
# policies][1].
|
|
528
|
+
#
|
|
529
|
+
#
|
|
530
|
+
#
|
|
531
|
+
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/view-modify-delete.html#delete
|
|
532
|
+
#
|
|
517
533
|
# @option params [required, String] :policy_id
|
|
518
534
|
# The identifier of the lifecycle policy.
|
|
519
535
|
#
|
|
@@ -667,6 +683,9 @@ module Aws::DLM
|
|
|
667
683
|
# resp.policy.policy_details.schedules[0].deprecate_rule.count #=> Integer
|
|
668
684
|
# resp.policy.policy_details.schedules[0].deprecate_rule.interval #=> Integer
|
|
669
685
|
# resp.policy.policy_details.schedules[0].deprecate_rule.interval_unit #=> String, one of "DAYS", "WEEKS", "MONTHS", "YEARS"
|
|
686
|
+
# resp.policy.policy_details.schedules[0].archive_rule.retain_rule.retention_archive_tier.count #=> Integer
|
|
687
|
+
# resp.policy.policy_details.schedules[0].archive_rule.retain_rule.retention_archive_tier.interval #=> Integer
|
|
688
|
+
# resp.policy.policy_details.schedules[0].archive_rule.retain_rule.retention_archive_tier.interval_unit #=> String, one of "DAYS", "WEEKS", "MONTHS", "YEARS"
|
|
670
689
|
# resp.policy.policy_details.parameters.exclude_boot_volume #=> Boolean
|
|
671
690
|
# resp.policy.policy_details.parameters.no_reboot #=> Boolean
|
|
672
691
|
# resp.policy.policy_details.parameters.exclude_data_volume_tags #=> Array
|
|
@@ -783,6 +802,13 @@ module Aws::DLM
|
|
|
783
802
|
|
|
784
803
|
# Updates the specified lifecycle policy.
|
|
785
804
|
#
|
|
805
|
+
# For more information about updating a policy, see [Modify lifecycle
|
|
806
|
+
# policies][1].
|
|
807
|
+
#
|
|
808
|
+
#
|
|
809
|
+
#
|
|
810
|
+
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/view-modify-delete.html#modify
|
|
811
|
+
#
|
|
786
812
|
# @option params [required, String] :policy_id
|
|
787
813
|
# The identifier of the lifecycle policy.
|
|
788
814
|
#
|
|
@@ -882,6 +908,15 @@ module Aws::DLM
|
|
|
882
908
|
# interval: 1,
|
|
883
909
|
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
884
910
|
# },
|
|
911
|
+
# archive_rule: {
|
|
912
|
+
# retain_rule: { # required
|
|
913
|
+
# retention_archive_tier: { # required
|
|
914
|
+
# count: 1,
|
|
915
|
+
# interval: 1,
|
|
916
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
917
|
+
# },
|
|
918
|
+
# },
|
|
919
|
+
# },
|
|
885
920
|
# },
|
|
886
921
|
# ],
|
|
887
922
|
# parameters: {
|
|
@@ -945,7 +980,7 @@ module Aws::DLM
|
|
|
945
980
|
params: params,
|
|
946
981
|
config: config)
|
|
947
982
|
context[:gem_name] = 'aws-sdk-dlm'
|
|
948
|
-
context[:gem_version] = '1.
|
|
983
|
+
context[:gem_version] = '1.52.0'
|
|
949
984
|
Seahorse::Client::Request.new(handlers, context)
|
|
950
985
|
end
|
|
951
986
|
|
|
@@ -16,6 +16,8 @@ module Aws::DLM
|
|
|
16
16
|
Action = Shapes::StructureShape.new(name: 'Action')
|
|
17
17
|
ActionList = Shapes::ListShape.new(name: 'ActionList')
|
|
18
18
|
ActionName = Shapes::StringShape.new(name: 'ActionName')
|
|
19
|
+
ArchiveRetainRule = Shapes::StructureShape.new(name: 'ArchiveRetainRule')
|
|
20
|
+
ArchiveRule = Shapes::StructureShape.new(name: 'ArchiveRule')
|
|
19
21
|
AvailabilityZone = Shapes::StringShape.new(name: 'AvailabilityZone')
|
|
20
22
|
AvailabilityZoneList = Shapes::ListShape.new(name: 'AvailabilityZoneList')
|
|
21
23
|
AwsAccountId = Shapes::StringShape.new(name: 'AwsAccountId')
|
|
@@ -81,6 +83,7 @@ module Aws::DLM
|
|
|
81
83
|
ResourceTypeValues = Shapes::StringShape.new(name: 'ResourceTypeValues')
|
|
82
84
|
ResourceTypeValuesList = Shapes::ListShape.new(name: 'ResourceTypeValuesList')
|
|
83
85
|
RetainRule = Shapes::StructureShape.new(name: 'RetainRule')
|
|
86
|
+
RetentionArchiveTier = Shapes::StructureShape.new(name: 'RetentionArchiveTier')
|
|
84
87
|
RetentionIntervalUnitValues = Shapes::StringShape.new(name: 'RetentionIntervalUnitValues')
|
|
85
88
|
Schedule = Shapes::StructureShape.new(name: 'Schedule')
|
|
86
89
|
ScheduleList = Shapes::ListShape.new(name: 'ScheduleList')
|
|
@@ -90,6 +93,8 @@ module Aws::DLM
|
|
|
90
93
|
ShareRules = Shapes::ListShape.new(name: 'ShareRules')
|
|
91
94
|
ShareTargetAccountList = Shapes::ListShape.new(name: 'ShareTargetAccountList')
|
|
92
95
|
SnapshotOwnerList = Shapes::ListShape.new(name: 'SnapshotOwnerList')
|
|
96
|
+
StandardTierRetainRuleCount = Shapes::IntegerShape.new(name: 'StandardTierRetainRuleCount')
|
|
97
|
+
StandardTierRetainRuleInterval = Shapes::IntegerShape.new(name: 'StandardTierRetainRuleInterval')
|
|
93
98
|
StatusMessage = Shapes::StringShape.new(name: 'StatusMessage')
|
|
94
99
|
String = Shapes::StringShape.new(name: 'String')
|
|
95
100
|
Tag = Shapes::StructureShape.new(name: 'Tag')
|
|
@@ -121,6 +126,12 @@ module Aws::DLM
|
|
|
121
126
|
|
|
122
127
|
ActionList.member = Shapes::ShapeRef.new(shape: Action)
|
|
123
128
|
|
|
129
|
+
ArchiveRetainRule.add_member(:retention_archive_tier, Shapes::ShapeRef.new(shape: RetentionArchiveTier, required: true, location_name: "RetentionArchiveTier"))
|
|
130
|
+
ArchiveRetainRule.struct_class = Types::ArchiveRetainRule
|
|
131
|
+
|
|
132
|
+
ArchiveRule.add_member(:retain_rule, Shapes::ShapeRef.new(shape: ArchiveRetainRule, required: true, location_name: "RetainRule"))
|
|
133
|
+
ArchiveRule.struct_class = Types::ArchiveRule
|
|
134
|
+
|
|
124
135
|
AvailabilityZoneList.member = Shapes::ShapeRef.new(shape: AvailabilityZone)
|
|
125
136
|
|
|
126
137
|
CreateLifecyclePolicyRequest.add_member(:execution_role_arn, Shapes::ShapeRef.new(shape: ExecutionRoleArn, required: true, location_name: "ExecutionRoleArn"))
|
|
@@ -284,11 +295,16 @@ module Aws::DLM
|
|
|
284
295
|
|
|
285
296
|
ResourceTypeValuesList.member = Shapes::ShapeRef.new(shape: ResourceTypeValues)
|
|
286
297
|
|
|
287
|
-
RetainRule.add_member(:count, Shapes::ShapeRef.new(shape:
|
|
288
|
-
RetainRule.add_member(:interval, Shapes::ShapeRef.new(shape:
|
|
298
|
+
RetainRule.add_member(:count, Shapes::ShapeRef.new(shape: StandardTierRetainRuleCount, location_name: "Count"))
|
|
299
|
+
RetainRule.add_member(:interval, Shapes::ShapeRef.new(shape: StandardTierRetainRuleInterval, location_name: "Interval"))
|
|
289
300
|
RetainRule.add_member(:interval_unit, Shapes::ShapeRef.new(shape: RetentionIntervalUnitValues, location_name: "IntervalUnit"))
|
|
290
301
|
RetainRule.struct_class = Types::RetainRule
|
|
291
302
|
|
|
303
|
+
RetentionArchiveTier.add_member(:count, Shapes::ShapeRef.new(shape: Count, location_name: "Count"))
|
|
304
|
+
RetentionArchiveTier.add_member(:interval, Shapes::ShapeRef.new(shape: Interval, location_name: "Interval"))
|
|
305
|
+
RetentionArchiveTier.add_member(:interval_unit, Shapes::ShapeRef.new(shape: RetentionIntervalUnitValues, location_name: "IntervalUnit"))
|
|
306
|
+
RetentionArchiveTier.struct_class = Types::RetentionArchiveTier
|
|
307
|
+
|
|
292
308
|
Schedule.add_member(:name, Shapes::ShapeRef.new(shape: ScheduleName, location_name: "Name"))
|
|
293
309
|
Schedule.add_member(:copy_tags, Shapes::ShapeRef.new(shape: CopyTags, location_name: "CopyTags"))
|
|
294
310
|
Schedule.add_member(:tags_to_add, Shapes::ShapeRef.new(shape: TagsToAddList, location_name: "TagsToAdd"))
|
|
@@ -299,6 +315,7 @@ module Aws::DLM
|
|
|
299
315
|
Schedule.add_member(:cross_region_copy_rules, Shapes::ShapeRef.new(shape: CrossRegionCopyRules, location_name: "CrossRegionCopyRules"))
|
|
300
316
|
Schedule.add_member(:share_rules, Shapes::ShapeRef.new(shape: ShareRules, location_name: "ShareRules"))
|
|
301
317
|
Schedule.add_member(:deprecate_rule, Shapes::ShapeRef.new(shape: DeprecateRule, location_name: "DeprecateRule"))
|
|
318
|
+
Schedule.add_member(:archive_rule, Shapes::ShapeRef.new(shape: ArchiveRule, location_name: "ArchiveRule"))
|
|
302
319
|
Schedule.struct_class = Types::Schedule
|
|
303
320
|
|
|
304
321
|
ScheduleList.member = Shapes::ShapeRef.new(shape: Schedule)
|
data/lib/aws-sdk-dlm/types.rb
CHANGED
|
@@ -50,6 +50,67 @@ module Aws::DLM
|
|
|
50
50
|
include Aws::Structure
|
|
51
51
|
end
|
|
52
52
|
|
|
53
|
+
# **\[Snapshot policies only\]** Specifies information about the archive
|
|
54
|
+
# storage tier retention period.
|
|
55
|
+
#
|
|
56
|
+
# @note When making an API call, you may pass ArchiveRetainRule
|
|
57
|
+
# data as a hash:
|
|
58
|
+
#
|
|
59
|
+
# {
|
|
60
|
+
# retention_archive_tier: { # required
|
|
61
|
+
# count: 1,
|
|
62
|
+
# interval: 1,
|
|
63
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
64
|
+
# },
|
|
65
|
+
# }
|
|
66
|
+
#
|
|
67
|
+
# @!attribute [rw] retention_archive_tier
|
|
68
|
+
# Information about retention period in the Amazon EBS Snapshots
|
|
69
|
+
# Archive. For more information, see [Archive Amazon EBS
|
|
70
|
+
# snapshots][1].
|
|
71
|
+
#
|
|
72
|
+
#
|
|
73
|
+
#
|
|
74
|
+
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/snapshot-archive.html
|
|
75
|
+
# @return [Types::RetentionArchiveTier]
|
|
76
|
+
#
|
|
77
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/dlm-2018-01-12/ArchiveRetainRule AWS API Documentation
|
|
78
|
+
#
|
|
79
|
+
class ArchiveRetainRule < Struct.new(
|
|
80
|
+
:retention_archive_tier)
|
|
81
|
+
SENSITIVE = []
|
|
82
|
+
include Aws::Structure
|
|
83
|
+
end
|
|
84
|
+
|
|
85
|
+
# **\[Snapshot policies only\]** Specifies a snapshot archiving rule for
|
|
86
|
+
# a schedule.
|
|
87
|
+
#
|
|
88
|
+
# @note When making an API call, you may pass ArchiveRule
|
|
89
|
+
# data as a hash:
|
|
90
|
+
#
|
|
91
|
+
# {
|
|
92
|
+
# retain_rule: { # required
|
|
93
|
+
# retention_archive_tier: { # required
|
|
94
|
+
# count: 1,
|
|
95
|
+
# interval: 1,
|
|
96
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
97
|
+
# },
|
|
98
|
+
# },
|
|
99
|
+
# }
|
|
100
|
+
#
|
|
101
|
+
# @!attribute [rw] retain_rule
|
|
102
|
+
# Information about the retention period for the snapshot archiving
|
|
103
|
+
# rule.
|
|
104
|
+
# @return [Types::ArchiveRetainRule]
|
|
105
|
+
#
|
|
106
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/dlm-2018-01-12/ArchiveRule AWS API Documentation
|
|
107
|
+
#
|
|
108
|
+
class ArchiveRule < Struct.new(
|
|
109
|
+
:retain_rule)
|
|
110
|
+
SENSITIVE = []
|
|
111
|
+
include Aws::Structure
|
|
112
|
+
end
|
|
113
|
+
|
|
53
114
|
# @note When making an API call, you may pass CreateLifecyclePolicyRequest
|
|
54
115
|
# data as a hash:
|
|
55
116
|
#
|
|
@@ -130,6 +191,15 @@ module Aws::DLM
|
|
|
130
191
|
# interval: 1,
|
|
131
192
|
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
132
193
|
# },
|
|
194
|
+
# archive_rule: {
|
|
195
|
+
# retain_rule: { # required
|
|
196
|
+
# retention_archive_tier: { # required
|
|
197
|
+
# count: 1,
|
|
198
|
+
# interval: 1,
|
|
199
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
200
|
+
# },
|
|
201
|
+
# },
|
|
202
|
+
# },
|
|
133
203
|
# },
|
|
134
204
|
# ],
|
|
135
205
|
# parameters: {
|
|
@@ -223,8 +293,13 @@ module Aws::DLM
|
|
|
223
293
|
# **\[Snapshot and AMI policies only\]** Specifies when the policy
|
|
224
294
|
# should create snapshots or AMIs.
|
|
225
295
|
#
|
|
226
|
-
# You must specify either
|
|
227
|
-
#
|
|
296
|
+
# <note markdown="1"> * You must specify either **CronExpression**, or **Interval**,
|
|
297
|
+
# **IntervalUnit**, and **Times**.
|
|
298
|
+
#
|
|
299
|
+
# * If you need to specify an ArchiveRule for the schedule, then you
|
|
300
|
+
# must specify a creation frequency of at least 28 days.
|
|
301
|
+
#
|
|
302
|
+
# </note>
|
|
228
303
|
#
|
|
229
304
|
# @note When making an API call, you may pass CreateRule
|
|
230
305
|
# data as a hash:
|
|
@@ -265,8 +340,8 @@ module Aws::DLM
|
|
|
265
340
|
# hh:mm.
|
|
266
341
|
#
|
|
267
342
|
# The operation occurs within a one-hour window following the
|
|
268
|
-
# specified time. If you do not specify a time, Amazon
|
|
269
|
-
# time within the next 24 hours.
|
|
343
|
+
# specified time. If you do not specify a time, Amazon Data Lifecycle
|
|
344
|
+
# Manager selects a time within the next 24 hours.
|
|
270
345
|
# @return [Array<String>]
|
|
271
346
|
#
|
|
272
347
|
# @!attribute [rw] cron_expression
|
|
@@ -674,7 +749,7 @@ module Aws::DLM
|
|
|
674
749
|
end
|
|
675
750
|
|
|
676
751
|
# **\[Snapshot policies only\]** Specifies a rule for enabling fast
|
|
677
|
-
# snapshot restore for snapshots created by
|
|
752
|
+
# snapshot restore for snapshots created by snapshot policies. You can
|
|
678
753
|
# enable fast snapshot restore based on either a count or a time
|
|
679
754
|
# interval.
|
|
680
755
|
#
|
|
@@ -1014,10 +1089,10 @@ module Aws::DLM
|
|
|
1014
1089
|
#
|
|
1015
1090
|
# If you choose to exclude boot volumes and you specify tags that
|
|
1016
1091
|
# consequently exclude all of the additional data volumes attached to an
|
|
1017
|
-
# instance, then Amazon
|
|
1018
|
-
# affected instance, and it will emit a
|
|
1019
|
-
# CloudWatch metric. For more
|
|
1020
|
-
# using Amazon CloudWatch][1].
|
|
1092
|
+
# instance, then Amazon Data Lifecycle Manager will not create any
|
|
1093
|
+
# snapshots for the affected instance, and it will emit a
|
|
1094
|
+
# `SnapshotsCreateFailed` Amazon CloudWatch metric. For more
|
|
1095
|
+
# information, see [Monitor your policies using Amazon CloudWatch][1].
|
|
1021
1096
|
#
|
|
1022
1097
|
#
|
|
1023
1098
|
#
|
|
@@ -1153,6 +1228,15 @@ module Aws::DLM
|
|
|
1153
1228
|
# interval: 1,
|
|
1154
1229
|
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
1155
1230
|
# },
|
|
1231
|
+
# archive_rule: {
|
|
1232
|
+
# retain_rule: { # required
|
|
1233
|
+
# retention_archive_tier: { # required
|
|
1234
|
+
# count: 1,
|
|
1235
|
+
# interval: 1,
|
|
1236
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
1237
|
+
# },
|
|
1238
|
+
# },
|
|
1239
|
+
# },
|
|
1156
1240
|
# },
|
|
1157
1241
|
# ],
|
|
1158
1242
|
# parameters: {
|
|
@@ -1302,12 +1386,36 @@ module Aws::DLM
|
|
|
1302
1386
|
end
|
|
1303
1387
|
|
|
1304
1388
|
# **\[Snapshot and AMI policies only\]** Specifies a retention rule for
|
|
1305
|
-
# snapshots created by snapshot policies or for AMIs created by AMI
|
|
1306
|
-
# policies.
|
|
1307
|
-
#
|
|
1389
|
+
# snapshots created by snapshot policies, or for AMIs created by AMI
|
|
1390
|
+
# policies.
|
|
1391
|
+
#
|
|
1392
|
+
# <note markdown="1"> For snapshot policies that have an ArchiveRule, this retention rule
|
|
1393
|
+
# applies to standard tier retention. When the retention threshold is
|
|
1394
|
+
# met, snapshots are moved from the standard to the archive tier.
|
|
1395
|
+
#
|
|
1396
|
+
# For snapshot policies that do not have an **ArchiveRule**, snapshots
|
|
1397
|
+
# are permanently deleted when this retention threshold is met.
|
|
1398
|
+
#
|
|
1399
|
+
# </note>
|
|
1400
|
+
#
|
|
1401
|
+
# You can retain snapshots based on either a count or a time interval.
|
|
1402
|
+
#
|
|
1403
|
+
# * **Count-based retention**
|
|
1308
1404
|
#
|
|
1309
|
-
#
|
|
1310
|
-
#
|
|
1405
|
+
# You must specify **Count**. If you specify an ArchiveRule for the
|
|
1406
|
+
# schedule, then you can specify a retention count of `0` to archive
|
|
1407
|
+
# snapshots immediately after creation. If you specify a
|
|
1408
|
+
# FastRestoreRule, ShareRule, or a CrossRegionCopyRule, then you must
|
|
1409
|
+
# specify a retention count of `1` or more.
|
|
1410
|
+
#
|
|
1411
|
+
# * **Age-based retention**
|
|
1412
|
+
#
|
|
1413
|
+
# You must specify **Interval** and **IntervalUnit**. If you specify
|
|
1414
|
+
# an ArchiveRule for the schedule, then you can specify a retention
|
|
1415
|
+
# interval of `0` days to archive snapshots immediately after
|
|
1416
|
+
# creation. If you specify a FastRestoreRule, ShareRule, or a
|
|
1417
|
+
# CrossRegionCopyRule, then you must specify a retention interval of
|
|
1418
|
+
# `1` day or more.
|
|
1311
1419
|
#
|
|
1312
1420
|
# @note When making an API call, you may pass RetainRule
|
|
1313
1421
|
# data as a hash:
|
|
@@ -1320,7 +1428,10 @@ module Aws::DLM
|
|
|
1320
1428
|
#
|
|
1321
1429
|
# @!attribute [rw] count
|
|
1322
1430
|
# The number of snapshots to retain for each volume, up to a maximum
|
|
1323
|
-
# of 1000.
|
|
1431
|
+
# of 1000. For example if you want to retain a maximum of three
|
|
1432
|
+
# snapshots, specify `3`. When the fourth snapshot is created, the
|
|
1433
|
+
# oldest retained snapshot is deleted, or it is moved to the archive
|
|
1434
|
+
# tier if you have specified an ArchiveRule.
|
|
1324
1435
|
# @return [Integer]
|
|
1325
1436
|
#
|
|
1326
1437
|
# @!attribute [rw] interval
|
|
@@ -1329,7 +1440,11 @@ module Aws::DLM
|
|
|
1329
1440
|
# @return [Integer]
|
|
1330
1441
|
#
|
|
1331
1442
|
# @!attribute [rw] interval_unit
|
|
1332
|
-
# The unit of time for time-based retention.
|
|
1443
|
+
# The unit of time for time-based retention. For example, to retain
|
|
1444
|
+
# snapshots for 3 months, specify `Interval=3` and
|
|
1445
|
+
# `IntervalUnit=MONTHS`. Once the snapshot has been retained for 3
|
|
1446
|
+
# months, it is deleted, or it is moved to the archive tier if you
|
|
1447
|
+
# have specified an ArchiveRule.
|
|
1333
1448
|
# @return [String]
|
|
1334
1449
|
#
|
|
1335
1450
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dlm-2018-01-12/RetainRule AWS API Documentation
|
|
@@ -1342,6 +1457,66 @@ module Aws::DLM
|
|
|
1342
1457
|
include Aws::Structure
|
|
1343
1458
|
end
|
|
1344
1459
|
|
|
1460
|
+
# **\[Snapshot policies only\]** Describes the retention rule for
|
|
1461
|
+
# archived snapshots. Once the archive retention threshold is met, the
|
|
1462
|
+
# snapshots are permanently deleted from the archive tier.
|
|
1463
|
+
#
|
|
1464
|
+
# <note markdown="1"> The archive retention rule must retain snapshots in the archive tier
|
|
1465
|
+
# for a minimum of 90 days.
|
|
1466
|
+
#
|
|
1467
|
+
# </note>
|
|
1468
|
+
#
|
|
1469
|
+
# For **count-based schedules**, you must specify **Count**. For
|
|
1470
|
+
# **age-based schedules**, you must specify **Interval** and <b>
|
|
1471
|
+
# IntervalUnit</b>.
|
|
1472
|
+
#
|
|
1473
|
+
# For more information about using snapshot archiving, see
|
|
1474
|
+
# [Considerations for snapshot lifecycle policies][1].
|
|
1475
|
+
#
|
|
1476
|
+
#
|
|
1477
|
+
#
|
|
1478
|
+
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-ami-policy.html#dlm-archive
|
|
1479
|
+
#
|
|
1480
|
+
# @note When making an API call, you may pass RetentionArchiveTier
|
|
1481
|
+
# data as a hash:
|
|
1482
|
+
#
|
|
1483
|
+
# {
|
|
1484
|
+
# count: 1,
|
|
1485
|
+
# interval: 1,
|
|
1486
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
1487
|
+
# }
|
|
1488
|
+
#
|
|
1489
|
+
# @!attribute [rw] count
|
|
1490
|
+
# The maximum number of snapshots to retain in the archive storage
|
|
1491
|
+
# tier for each volume. The count must ensure that each snapshot
|
|
1492
|
+
# remains in the archive tier for at least 90 days. For example, if
|
|
1493
|
+
# the schedule creates snapshots every 30 days, you must specify a
|
|
1494
|
+
# count of 3 or more to ensure that each snapshot is archived for at
|
|
1495
|
+
# least 90 days.
|
|
1496
|
+
# @return [Integer]
|
|
1497
|
+
#
|
|
1498
|
+
# @!attribute [rw] interval
|
|
1499
|
+
# Specifies the period of time to retain snapshots in the archive
|
|
1500
|
+
# tier. After this period expires, the snapshot is permanently
|
|
1501
|
+
# deleted.
|
|
1502
|
+
# @return [Integer]
|
|
1503
|
+
#
|
|
1504
|
+
# @!attribute [rw] interval_unit
|
|
1505
|
+
# The unit of time in which to measure the **Interval**. For example,
|
|
1506
|
+
# to retain a snapshots in the archive tier for 6 months, specify
|
|
1507
|
+
# `Interval=6` and `IntervalUnit=MONTHS`.
|
|
1508
|
+
# @return [String]
|
|
1509
|
+
#
|
|
1510
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/dlm-2018-01-12/RetentionArchiveTier AWS API Documentation
|
|
1511
|
+
#
|
|
1512
|
+
class RetentionArchiveTier < Struct.new(
|
|
1513
|
+
:count,
|
|
1514
|
+
:interval,
|
|
1515
|
+
:interval_unit)
|
|
1516
|
+
SENSITIVE = []
|
|
1517
|
+
include Aws::Structure
|
|
1518
|
+
end
|
|
1519
|
+
|
|
1345
1520
|
# **\[Snapshot and AMI policies only\]** Specifies a schedule for a
|
|
1346
1521
|
# snapshot or AMI lifecycle policy.
|
|
1347
1522
|
#
|
|
@@ -1410,6 +1585,15 @@ module Aws::DLM
|
|
|
1410
1585
|
# interval: 1,
|
|
1411
1586
|
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
1412
1587
|
# },
|
|
1588
|
+
# archive_rule: {
|
|
1589
|
+
# retain_rule: { # required
|
|
1590
|
+
# retention_archive_tier: { # required
|
|
1591
|
+
# count: 1,
|
|
1592
|
+
# interval: 1,
|
|
1593
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
1594
|
+
# },
|
|
1595
|
+
# },
|
|
1596
|
+
# },
|
|
1413
1597
|
# }
|
|
1414
1598
|
#
|
|
1415
1599
|
# @!attribute [rw] name
|
|
@@ -1469,6 +1653,22 @@ module Aws::DLM
|
|
|
1469
1653
|
# **\[AMI policies only\]** The AMI deprecation rule for the schedule.
|
|
1470
1654
|
# @return [Types::DeprecateRule]
|
|
1471
1655
|
#
|
|
1656
|
+
# @!attribute [rw] archive_rule
|
|
1657
|
+
# **\[Snapshot policies that target volumes only\]** The snapshot
|
|
1658
|
+
# archiving rule for the schedule. When you specify an archiving rule,
|
|
1659
|
+
# snapshots are automatically moved from the standard tier to the
|
|
1660
|
+
# archive tier once the schedule's retention threshold is met.
|
|
1661
|
+
# Snapshots are then retained in the archive tier for the archive
|
|
1662
|
+
# retention period that you specify.
|
|
1663
|
+
#
|
|
1664
|
+
# For more information about using snapshot archiving, see
|
|
1665
|
+
# [Considerations for snapshot lifecycle policies][1].
|
|
1666
|
+
#
|
|
1667
|
+
#
|
|
1668
|
+
#
|
|
1669
|
+
# [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-ami-policy.html#dlm-archive
|
|
1670
|
+
# @return [Types::ArchiveRule]
|
|
1671
|
+
#
|
|
1472
1672
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dlm-2018-01-12/Schedule AWS API Documentation
|
|
1473
1673
|
#
|
|
1474
1674
|
class Schedule < Struct.new(
|
|
@@ -1481,7 +1681,8 @@ module Aws::DLM
|
|
|
1481
1681
|
:fast_restore_rule,
|
|
1482
1682
|
:cross_region_copy_rules,
|
|
1483
1683
|
:share_rules,
|
|
1484
|
-
:deprecate_rule
|
|
1684
|
+
:deprecate_rule,
|
|
1685
|
+
:archive_rule)
|
|
1485
1686
|
SENSITIVE = []
|
|
1486
1687
|
include Aws::Structure
|
|
1487
1688
|
end
|
|
@@ -1690,6 +1891,15 @@ module Aws::DLM
|
|
|
1690
1891
|
# interval: 1,
|
|
1691
1892
|
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
1692
1893
|
# },
|
|
1894
|
+
# archive_rule: {
|
|
1895
|
+
# retain_rule: { # required
|
|
1896
|
+
# retention_archive_tier: { # required
|
|
1897
|
+
# count: 1,
|
|
1898
|
+
# interval: 1,
|
|
1899
|
+
# interval_unit: "DAYS", # accepts DAYS, WEEKS, MONTHS, YEARS
|
|
1900
|
+
# },
|
|
1901
|
+
# },
|
|
1902
|
+
# },
|
|
1693
1903
|
# },
|
|
1694
1904
|
# ],
|
|
1695
1905
|
# parameters: {
|
data/lib/aws-sdk-dlm.rb
CHANGED
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: aws-sdk-dlm
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.
|
|
4
|
+
version: 1.52.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: 2022-
|
|
11
|
+
date: 2022-09-30 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: aws-sdk-core
|