Expand description
Data structures used by operation inputs/outputs.
Modules§
Structs§
- Advanced
Backup Setting The backup options for each resource type.
- Backup
Job Contains detailed information about a backup job.
- Backup
JobSummary This is a summary of jobs created or running within the most recent 30 days.
The returned summary may contain the following: Region, Account, State, RestourceType, MessageCategory, StartTime, EndTime, and Count of included jobs.
- Backup
Plan Contains an optional backup plan display name and an array of
BackupRule
objects, each of which specifies a backup rule. Each rule in a backup plan is a separate scheduled task and can back up a different selection of Amazon Web Services resources.- Backup
Plan Input Contains an optional backup plan display name and an array of
BackupRule
objects, each of which specifies a backup rule. Each rule in a backup plan is a separate scheduled task.- Backup
Plan Templates List Member An object specifying metadata associated with a backup plan template.
- Backup
Plans List Member Contains metadata about a backup plan.
- Backup
Rule Specifies a scheduled task used to back up a selection of resources.
- Backup
Rule Input Specifies a scheduled task used to back up a selection of resources.
- Backup
Selection Used to specify a set of resources to a backup plan.
We recommend that you specify conditions, tags, or resources to include or exclude. Otherwise, Backup attempts to select all supported and opted-in storage resources, which could have unintended cost implications.
For more information, see Assigning resources programmatically.
- Backup
Selections List Member Contains metadata about a
BackupSelection
object.- Backup
Vault List Member Contains metadata about a backup vault.
- Calculated
Lifecycle Contains
DeleteAt
andMoveToColdStorageAt
timestamps, which are used to specify a lifecycle for a recovery point.The lifecycle defines when a protected resource is transitioned to cold storage and when it expires. Backup transitions and expires backups automatically according to the lifecycle that you define.
Backups transitioned to cold storage must be stored in cold storage for a minimum of 90 days. Therefore, the “retention” setting must be 90 days greater than the “transition to cold after days” setting. The “transition to cold after days” setting cannot be changed after a backup has been transitioned to cold.
Resource types that can transition to cold storage are listed in the Feature availability by resource table. Backup ignores this expression for other resource types.
- Condition
Contains an array of triplets made up of a condition type (such as
StringEquals
), a key, and a value. Used to filter resources using their tags and assign them to a backup plan. Case sensitive.- Condition
Parameter Includes information about tags you define to assign tagged resources to a backup plan.
Include the prefix
aws:ResourceTag
in your tags. For example,"aws:ResourceTag/TagKey1": "Value1"
.- Conditions
Contains information about which resources to include or exclude from a backup plan using their tags. Conditions are case sensitive.
- Control
Input Parameter The parameters for a control. A control can have zero, one, or more than one parameter. An example of a control with two parameters is: "backup plan frequency is at least
daily
and the retention period is at least1 year
". The first parameter isdaily
. The second parameter is1 year
.- Control
Scope A framework consists of one or more controls. Each control has its own control scope. The control scope can include one or more resource types, a combination of a tag key and value, or a combination of one resource type and one resource ID. If no scope is specified, evaluations for the rule are triggered when any resource in your recording group changes in configuration.
To set a control scope that includes all of a particular resource, leave the
ControlScope
empty or do not pass it when callingCreateFramework
.- Copy
Action The details of the copy operation.
- CopyJob
Contains detailed information about a copy job.
- Copy
JobSummary This is a summary of copy jobs created or running within the most recent 30 days.
The returned summary may contain the following: Region, Account, State, RestourceType, MessageCategory, StartTime, EndTime, and Count of included jobs.
- Date
Range This is a resource filter containing FromDate: DateTime and ToDate: DateTime. Both values are required. Future DateTime values are not permitted.
The date and time are in Unix format and Coordinated Universal Time (UTC), and it is accurate to milliseconds ((milliseconds are optional). For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
- Framework
Contains detailed information about a framework. Frameworks contain controls, which evaluate and report on your backup events and resources. Frameworks generate daily compliance results.
- Framework
Control Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
- Index
Action This is an optional array within a BackupRule.
IndexAction consists of one ResourceTypes.
- Indexed
Recovery Point This is a recovery point that has an associated backup index.
Only recovery points with a backup index can be included in a search.
- KeyValue
Pair of two related strings. Allowed characters are letters, white space, and numbers that can be represented in UTF-8 and the following characters:
+ - = . _ : /
- Latest
MpaApproval Team Update Contains information about the latest update to an MPA approval team association.
- Latest
Revoke Request Contains information about the latest request to revoke access to a backup vault.
- Legal
Hold A legal hold is an administrative tool that helps prevent backups from being deleted while under a hold. While the hold is in place, backups under a hold cannot be deleted and lifecycle policies that would alter the backup status (such as transition to cold storage) are delayed until the legal hold is removed. A backup can have more than one legal hold. Legal holds are applied to one or more backups (also known as recovery points). These backups can be filtered by resource types and by resource IDs.
- Lifecycle
Specifies the time period, in days, before a recovery point transitions to cold storage or is deleted.
Backups transitioned to cold storage must be stored in cold storage for a minimum of 90 days. Therefore, on the console, the retention setting must be 90 days greater than the transition to cold after days setting. The transition to cold after days setting can't be changed after a backup has been transitioned to cold.
Resource types that can transition to cold storage are listed in the Feature availability by resource table. Backup ignores this expression for other resource types.
To remove the existing lifecycle and retention periods and keep your recovery points indefinitely, specify -1 for
MoveToColdStorageAfterDays
andDeleteAfterDays
.- Protected
Resource A structure that contains information about a backed-up resource.
- Protected
Resource Conditions The conditions that you define for resources in your restore testing plan using tags.
- Recovery
Point ByBackup Vault Contains detailed information about the recovery points stored in a backup vault.
- Recovery
Point ByResource Contains detailed information about a saved recovery point.
- Recovery
Point Creator Contains information about the backup plan and rule that Backup used to initiate the recovery point backup.
- Recovery
Point Member This is a recovery point which is a child (nested) recovery point of a parent (composite) recovery point. These recovery points can be disassociated from their parent (composite) recovery point, in which case they will no longer be a member.
- Recovery
Point Selection This specifies criteria to assign a set of resources, such as resource types or backup vaults.
- Report
Delivery Channel Contains information from your report plan about where to deliver your reports, specifically your Amazon S3 bucket name, S3 key prefix, and the formats of your reports.
- Report
Destination Contains information from your report job about your report destination.
- Report
Job Contains detailed information about a report job. A report job compiles a report based on a report plan and publishes it to Amazon S3.
- Report
Plan Contains detailed information about a report plan.
- Report
Setting Contains detailed information about a report setting.
- Restore
Access Backup Vault List Member Contains information about a restore access backup vault.
- Restore
JobCreator Contains information about the restore testing plan that Backup used to initiate the restore job.
- Restore
JobSummary This is a summary of restore jobs created or running within the most recent 30 days.
The returned summary may contain the following: Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime, and Count of included jobs.
- Restore
Jobs List Member Contains metadata about a restore job.
- Restore
Testing Plan ForCreate This contains metadata about a restore testing plan.
- Restore
Testing Plan ForGet This contains metadata about a restore testing plan.
- Restore
Testing Plan ForList This contains metadata about a restore testing plan.
- Restore
Testing Plan ForUpdate This contains metadata about a restore testing plan.
- Restore
Testing Recovery Point Selection RecoveryPointSelection
has five parameters (three required and two optional). The values you specify determine which recovery point is included in the restore test. You must indicate withAlgorithm
if you want the latest recovery point within yourSelectionWindowDays
or if you want a random recovery point, and you must indicate throughIncludeVaults
from which vaults the recovery points can be chosen.Algorithm
(required) Valid values: "LATEST_WITHIN_WINDOW
" or "RANDOM_WITHIN_WINDOW
".Recovery point types
(required) Valid values: "SNAPSHOT
" and/or "CONTINUOUS
". IncludeSNAPSHOT
to restore only snapshot recovery points; includeCONTINUOUS
to restore continuous recovery points (point in time restore / PITR); use both to restore either a snapshot or a continuous recovery point. The recovery point will be determined by the value forAlgorithm
.IncludeVaults (required). You must include one or more backup vaults. Use the wildcard \["*"\] or specific ARNs.
SelectionWindowDays
(optional) Value must be an integer (in days) from 1 to 365. If not included, the value defaults to30
.ExcludeVaults
(optional). You can choose to input one or more specific backup vault ARNs to exclude those vaults' contents from restore eligibility. Or, you can include a list of selectors. If this parameter and its value are not included, it defaults to empty list.- Restore
Testing Selection ForCreate This contains metadata about a specific restore testing selection.
ProtectedResourceType is required, such as Amazon EBS or Amazon EC2.
This consists of
RestoreTestingSelectionName
,ProtectedResourceType
, and one of the following:-
ProtectedResourceArns
-
ProtectedResourceConditions
Each protected resource type can have one single value.
A restore testing selection can include a wildcard value ("*") for
ProtectedResourceArns
along withProtectedResourceConditions
. Alternatively, you can include up to 30 specific protected resource ARNs inProtectedResourceArns
.ProtectedResourceConditions
examples include asStringEquals
andStringNotEquals
.-
- Restore
Testing Selection ForGet This contains metadata about a restore testing selection.
- Restore
Testing Selection ForList This contains metadata about a restore testing selection.
- Restore
Testing Selection ForUpdate This contains metadata about a restore testing selection.
Enums§
- Aggregation
Period - When writing a match expression against
AggregationPeriod
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Backup
JobState - When writing a match expression against
BackupJobState
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Backup
JobStatus - When writing a match expression against
BackupJobStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Backup
Vault Event - When writing a match expression against
BackupVaultEvent
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Condition
Type - When writing a match expression against
ConditionType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Copy
JobState - When writing a match expression against
CopyJobState
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Copy
JobStatus - When writing a match expression against
CopyJobStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Index
- When writing a match expression against
Index
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Index
Status - When writing a match expression against
IndexStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Legal
Hold Status - When writing a match expression against
LegalHoldStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - MpaRevoke
Session Status - When writing a match expression against
MpaRevokeSessionStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - MpaSession
Status - When writing a match expression against
MpaSessionStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Recovery
Point Status - When writing a match expression against
RecoveryPointStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Restore
Deletion Status - When writing a match expression against
RestoreDeletionStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Restore
JobState - When writing a match expression against
RestoreJobState
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Restore
JobStatus - When writing a match expression against
RestoreJobStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Restore
Testing Recovery Point Selection Algorithm - When writing a match expression against
RestoreTestingRecoveryPointSelectionAlgorithm
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Restore
Testing Recovery Point Type - When writing a match expression against
RestoreTestingRecoveryPointType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Restore
Validation Status - When writing a match expression against
RestoreValidationStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Storage
Class - When writing a match expression against
StorageClass
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Vault
State - When writing a match expression against
VaultState
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Vault
Type - When writing a match expression against
VaultType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature.