Backup - Amazon FSx
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Backup

A backup of an Amazon FSx for Windows File Server, Amazon FSx for Lustre file system, Amazon FSx for NetApp ONTAP volume, or Amazon FSx for OpenZFS file system.

Contents

BackupId

The ID of the backup.

Type: String

Length Constraints: Minimum length of 12. Maximum length of 128.

Pattern: ^(backup-[0-9a-f]{8,})$

Required: Yes

CreationTime

The time when a particular backup was created.

Type: Timestamp

Required: Yes

FileSystem

The metadata of the file system associated with the backup. This metadata is persisted even if the file system is deleted.

Type: FileSystem object

Required: Yes

Lifecycle

The lifecycle status of the backup.

  • AVAILABLE - The backup is fully available.

  • PENDING - For user-initiated backups on Lustre file systems only; Amazon FSx hasn't started creating the backup.

  • CREATING - Amazon FSx is creating the backup.

  • TRANSFERRING - For user-initiated backups on Lustre file systems only; Amazon FSx is transferring the backup to Amazon S3.

  • COPYING - Amazon FSx is copying the backup.

  • DELETED - Amazon FSx deleted the backup and it's no longer available.

  • FAILED - Amazon FSx couldn't finish the backup.

Type: String

Valid Values: AVAILABLE | CREATING | TRANSFERRING | DELETED | FAILED | PENDING | COPYING

Required: Yes

Type

The type of the file-system backup.

Type: String

Valid Values: AUTOMATIC | USER_INITIATED | AWS_BACKUP

Required: Yes

DirectoryInformation

The configuration of the self-managed Microsoft Active Directory directory to which the Windows File Server instance is joined.

Type: ActiveDirectoryBackupAttributes object

Required: No

FailureDetails

Details explaining any failures that occurred when creating a backup.

Type: BackupFailureDetails object

Required: No

KmsKeyId

The ID of the Amazon Key Management Service (Amazon KMS) key used to encrypt the backup of the Amazon FSx file system's data at rest.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: ^.{1,2048}$

Required: No

OwnerId

An Amazon Web Services account ID. This ID is a 12-digit number that you use to construct Amazon Resource Names (ARNs) for resources.

Type: String

Length Constraints: Fixed length of 12.

Pattern: ^\d{12}$

Required: No

ProgressPercent

Displays the current percent of progress of an asynchronous task.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: No

ResourceARN

The Amazon Resource Name (ARN) for the backup resource.

Type: String

Length Constraints: Minimum length of 8. Maximum length of 512.

Pattern: ^arn:(?=[^:]+:fsx:[^:]+:\d{12}:)((|(?=[a-z0-9-.]{1,63})(?!\d{1,3}(\.\d{1,3}){3})(?![^:]*-{2})(?![^:]*-\.)(?![^:]*\.-)[a-z0-9].*(?<!-)):){4}(?!/).{0,1024}$

Required: No

ResourceType

Specifies the resource type that's backed up.

Type: String

Valid Values: FILE_SYSTEM | VOLUME

Required: No

SizeInBytes

The size of the backup in bytes. This represents the amount of data that the file system would contain if you restore this backup.

Type: Long

Valid Range: Minimum value of 0.

Required: No

SourceBackupId

The ID of the source backup. Specifies the backup that you are copying.

Type: String

Length Constraints: Minimum length of 12. Maximum length of 128.

Pattern: ^(backup-[0-9a-f]{8,})$

Required: No

SourceBackupRegion

The source Region of the backup. Specifies the Region from where this backup is copied.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 20.

Pattern: ^[a-z0-9-]{1,20}$

Required: No

Tags

The tags associated with a particular file system.

Type: Array of Tag objects

Array Members: Minimum number of 1 item. Maximum number of 50 items.

Required: No

Volume

Describes an Amazon FSx volume.

Type: Volume object

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: