Client library for Amazon FSx
npm install --save @datafire/amazonaws_fsx
let amazonaws_fsx = require('@datafire/amazonaws_fsx').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
.then(data => {
console.log(data);
});
Amazon FSx is a fully managed service that makes it easy for storage and application administrators to launch and use shared file storage.
amazonaws_fsx.AssociateFileSystemAliases({
"FileSystemId": null,
"Aliases": null
}, context)
- input
object
- Aliases required
- items AlternateDNSName
- ClientRequestToken ClientRequestToken
- FileSystemId required
- Aliases required
amazonaws_fsx.CancelDataRepositoryTask({
"TaskId": null
}, context)
- input
object
- TaskId required
amazonaws_fsx.CreateBackup({
"FileSystemId": null
}, context)
- input
object
- ClientRequestToken
- FileSystemId required
- Tags
- items Tag
- output CreateBackupResponse
amazonaws_fsx.CreateDataRepositoryTask({
"Type": null,
"FileSystemId": "",
"Report": null
}, context)
- input
object
- ClientRequestToken ClientRequestToken
- FileSystemId required FileSystemId
- Paths
- items DataRepositoryTaskPath
- Report required
- Enabled required
- Format
- Path
- Scope
- Tags Tags
- Type required
amazonaws_fsx.CreateFileSystem({
"FileSystemType": null,
"StorageCapacity": null,
"SubnetIds": null
}, context)
- input
object
- ClientRequestToken
- FileSystemType required
- KmsKeyId KmsKeyId
- LustreConfiguration CreateFileSystemLustreConfiguration
- SecurityGroupIds
- items SecurityGroupId
- StorageCapacity required
- StorageType
- SubnetIds required
- items SubnetId
- Tags
- items Tag
- WindowsConfiguration
- ActiveDirectoryId
- Aliases
- items AlternateDNSName
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- PreferredSubnetId
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryConfiguration
- ThroughputCapacity required
- WeeklyMaintenanceStartTime
- output CreateFileSystemResponse
amazonaws_fsx.CreateFileSystemFromBackup({
"BackupId": "",
"SubnetIds": null
}, context)
- input
object
- BackupId required BackupId
- ClientRequestToken
- LustreConfiguration CreateFileSystemLustreConfiguration
- SecurityGroupIds
- items SecurityGroupId
- StorageType
- SubnetIds required
- items SubnetId
- Tags
- items Tag
- WindowsConfiguration
- ActiveDirectoryId
- Aliases
- items AlternateDNSName
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- PreferredSubnetId
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryConfiguration
- ThroughputCapacity required
- WeeklyMaintenanceStartTime
amazonaws_fsx.DeleteBackup({
"BackupId": null
}, context)
- input
object
- BackupId required
- ClientRequestToken
- output DeleteBackupResponse
amazonaws_fsx.DeleteFileSystem({
"FileSystemId": null
}, context)
- input
object
- ClientRequestToken
- FileSystemId required
- LustreConfiguration DeleteFileSystemLustreConfiguration
- WindowsConfiguration DeleteFileSystemWindowsConfiguration
- output DeleteFileSystemResponse
amazonaws_fsx.DescribeBackups({}, context)
- input
object
- output DescribeBackupsResponse
amazonaws_fsx.DescribeDataRepositoryTasks({}, context)
- input
object
- MaxResults
string
- NextToken
string
- Filters
- items DataRepositoryTaskFilter
- MaxResults MaxResults
- NextToken NextToken
- TaskIds
- items TaskId
- MaxResults
amazonaws_fsx.DescribeFileSystemAliases({
"FileSystemId": null
}, context)
- input
object
- MaxResults
string
- NextToken
string
- ClientRequestToken ClientRequestToken
- FileSystemId required
- MaxResults
- NextToken
- MaxResults
amazonaws_fsx.DescribeFileSystems({}, context)
- input
object
- MaxResults
string
- NextToken
string
- FileSystemIds
- items FileSystemId
- MaxResults
- NextToken
- MaxResults
- output DescribeFileSystemsResponse
amazonaws_fsx.DisassociateFileSystemAliases({
"FileSystemId": null,
"Aliases": null
}, context)
- input
object
- Aliases required
- items AlternateDNSName
- ClientRequestToken ClientRequestToken
- FileSystemId required
- Aliases required
amazonaws_fsx.ListTagsForResource({
"ResourceARN": null
}, context)
- input
object
- MaxResults
- NextToken
- ResourceARN required
- output ListTagsForResourceResponse
amazonaws_fsx.TagResource({
"ResourceARN": null,
"Tags": null
}, context)
- input
object
- ResourceARN required
- Tags required
- items Tag
- output TagResourceResponse
amazonaws_fsx.UntagResource({
"ResourceARN": null,
"TagKeys": null
}, context)
- input
object
- ResourceARN required
- TagKeys required
- items TagKey
- output UntagResourceResponse
amazonaws_fsx.UpdateFileSystem({
"FileSystemId": null
}, context)
- input
object
- ClientRequestToken
- FileSystemId required
- LustreConfiguration UpdateFileSystemLustreConfiguration
- StorageCapacity
- WindowsConfiguration
- AutomaticBackupRetentionDays
- DailyAutomaticBackupStartTime
- SelfManagedActiveDirectoryConfiguration
- DnsIps
- items IpAddress
- Password
- UserName
- DnsIps
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- output UpdateFileSystemResponse
- AWSAccountId
string
: An AWS account ID. This ID is a 12-digit number that you use to construct Amazon Resource Names (ARNs) for resources.
- ActiveDirectoryBackupAttributes
object
: The Microsoft AD attributes of the Amazon FSx for Windows File Server file system.- ActiveDirectoryId
- DomainName
- ActiveDirectoryFullyQualifiedName
string
- AdministrativeAction
object
: Describes a specific Amazon FSx administrative action for the current Windows or Lustre file system.- AdministrativeActionType AdministrativeActionType
- FailureDetails AdministrativeActionFailureDetails
- ProgressPercent
- RequestTime
- Status
- TargetFileSystemValues
- AdministrativeActions
- items AdministrativeAction
- CreationTime
- DNSName
- FailureDetails FileSystemFailureDetails
- FileSystemId
- FileSystemType
- KmsKeyId
- Lifecycle
- LustreConfiguration LustreFileSystemConfiguration
- NetworkInterfaceIds
- items NetworkInterfaceId
- OwnerId
- ResourceARN
- StorageCapacity
- StorageType
- SubnetIds
- items SubnetId
- Tags
- items Tag
- VpcId
- WindowsConfiguration
- ActiveDirectoryId
- Aliases Aliases
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- MaintenanceOperationsInProgress
- PreferredFileServerIp
- PreferredSubnetId
- RemoteAdministrationEndpoint
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryAttributes
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- AdministrativeActions
- AdministrativeActionFailureDetails
object
: Provides information about a failed administrative action.- Message
- AdministrativeActionType
string
(values: FILE_SYSTEM_UPDATE, STORAGE_OPTIMIZATION, FILE_SYSTEM_ALIAS_ASSOCIATION, FILE_SYSTEM_ALIAS_DISASSOCIATION):Describes the type of administrative action, as follows:
-
FILE_SYSTEM_UPDATE
- A file system update administrative action initiated by the user from the Amazon FSx console, API (UpdateFileSystem), or CLI (update-file-system). -
STORAGE_OPTIMIZATION
- Once theFILE_SYSTEM_UPDATE
task to increase a file system's storage capacity completes successfully, aSTORAGE_OPTIMIZATION
task starts.-
For Windows, storage optimization is the process of migrating the file system data to the new, larger disks.
-
For Lustre, storage optimization consists of rebalancing the data across the existing and newly added file servers.
You can track the storage optimization progress using the
ProgressPercent
property. WhenSTORAGE_OPTIMIZATION
completes successfully, the parentFILE_SYSTEM_UPDATE
action status changes toCOMPLETED
. For more information, see Managing storage capacity in the Amazon FSx for Windows File Server User Guide and Managing storage and throughput capacity in the Amazon FSx for Lustre User Guide. -
-
FILE_SYSTEM_ALIAS_ASSOCIATION
- A file system update to associate a new DNS alias with the file system. For more information, see . -
FILE_SYSTEM_ALIAS_DISASSOCIATION
- A file system update to disassociate a DNS alias from the file system. For more information, see .
-
- AdministrativeActions
array
- items AdministrativeAction
- Alias
object
: A DNS alias that is associated with the file system. You can use a DNS alias to access a file system using user-defined DNS names, in addition to the default DNS name that Amazon FSx assigns to the file system. For more information, see DNS aliases in the FSx for Windows File Server User Guide.- Lifecycle
- Name
- AliasLifecycle
string
(values: AVAILABLE, CREATING, DELETING, CREATE_FAILED, DELETE_FAILED)
- Aliases
array
: An array of one or more DNS aliases that are currently associated with the Amazon FSx file system. Aliases allow you to use existing DNS names to access the data in your Amazon FSx file system. You can associate up to 50 aliases with a file system at any time. You can associate additional DNS aliases after you create the file system using the AssociateFileSystemAliases operation. You can remove DNS aliases from the file system after it is created using the DisassociateFileSystemAliases operation. You only need to specify the alias name in the request payload. For more information, see DNS aliases.- items Alias
- AlternateDNSName
string
- AlternateDNSNames
array
- items AlternateDNSName
- ArchivePath
string
- AssociateFileSystemAliasesRequest
object
: The request object specifying one or more DNS alias names to associate with an Amazon FSx for Windows File Server file system.- Aliases required
- items AlternateDNSName
- ClientRequestToken ClientRequestToken
- FileSystemId required
- Aliases required
- AssociateFileSystemAliasesResponse
object
: The system generated response showing the DNS aliases that Amazon FSx is attempting to associate with the file system. Use the API operation to monitor the status of the aliases Amazon FSx is associating with the file system. It can take up to 2.5 minutes for the alias status to change fromCREATING
toAVAILABLE
.- Aliases
- items Alias
- Aliases
- AutoImportPolicyType
string
(values: NONE, NEW, NEW_CHANGED)
- AutomaticBackupRetentionDays
integer
: The number of days to retain automatic backups. Setting this to 0 disables automatic backups. You can retain automatic backups for a maximum of 90 days. The default is 0.
- Backup
object
:A backup of an Amazon FSx file system. For more information see:
- BackupId required
- CreationTime required
- DirectoryInformation
- ActiveDirectoryId
- DomainName
- FailureDetails
- Message
- FileSystem required
- AdministrativeActions
- items AdministrativeAction
- CreationTime
- DNSName
- FailureDetails FileSystemFailureDetails
- FileSystemId
- FileSystemType
- KmsKeyId
- Lifecycle
- LustreConfiguration LustreFileSystemConfiguration
- NetworkInterfaceIds
- items NetworkInterfaceId
- OwnerId
- ResourceARN
- StorageCapacity
- StorageType
- SubnetIds
- items SubnetId
- Tags
- items Tag
- VpcId
- WindowsConfiguration
- ActiveDirectoryId
- Aliases Aliases
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- MaintenanceOperationsInProgress
- PreferredFileServerIp
- PreferredSubnetId
- RemoteAdministrationEndpoint
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryAttributes
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- AdministrativeActions
- KmsKeyId
- Lifecycle required
- ProgressPercent ProgressPercent
- ResourceARN
- Tags
- items Tag
- Type required
- BackupFailureDetails
object
: If backup creation fails, this structure contains the details of that failure.- Message
- BackupId
string
: The ID of the backup. Specifies the backup to use if you're creating a file system from an existing backup.
- BackupIds
array
: A list of backup IDs.- items BackupId
- BackupLifecycle
string
(values: AVAILABLE, CREATING, TRANSFERRING, DELETED, FAILED, PENDING):The lifecycle status of the backup.
-
AVAILABLE
- The backup is fully available. -
PENDING
- For user-initiated backups on Lustre file systems only; Amazon FSx has not started creating the backup. -
CREATING
- Amazon FSx is creating the new user-intiated backup -
TRANSFERRING
- For user-initiated backups on Lustre file systems only; Amazon FSx is backing up the file system. -
DELETED
- Amazon FSx deleted the backup and it is no longer available. -
FAILED
- Amazon FSx could not complete the backup.
-
- BackupType
string
(values: AUTOMATIC, USER_INITIATED, AWS_BACKUP): The type of the backup.
- Backups
array
: A list of file system backups.- items Backup
- CancelDataRepositoryTaskRequest
object
: Cancels a data repository task.- TaskId required
- CancelDataRepositoryTaskResponse
object
- Lifecycle
- TaskId
- ClientRequestToken
string
: (Optional) An idempotency token for resource creation, in a string of up to 64 ASCII characters. This token is automatically filled on your behalf when you use the AWS Command Line Interface (AWS CLI) or an AWS SDK.
- CompletionReport
object
: Provides a report detailing the data repository task results of the files processed that match the criteria specified in the reportScope
parameter. FSx delivers the report to the file system's linked data repository in Amazon S3, using the path specified in the reportPath
parameter. You can specify whether or not a report gets generated for a task using theEnabled
parameter.- Enabled required
- Format
- Path
- Scope
- CreateBackupRequest
object
: The request object for theCreateBackup
operation.- ClientRequestToken
- FileSystemId required
- Tags
- items Tag
- CreateBackupResponse
object
: The response object for theCreateBackup
operation.- Backup
- BackupId required
- CreationTime required
- DirectoryInformation
- ActiveDirectoryId
- DomainName
- FailureDetails
- Message
- FileSystem required
- AdministrativeActions
- items AdministrativeAction
- CreationTime
- DNSName
- FailureDetails FileSystemFailureDetails
- FileSystemId
- FileSystemType
- KmsKeyId
- Lifecycle
- LustreConfiguration LustreFileSystemConfiguration
- NetworkInterfaceIds
- items NetworkInterfaceId
- OwnerId
- ResourceARN
- StorageCapacity
- StorageType
- SubnetIds
- items SubnetId
- Tags
- items Tag
- VpcId
- WindowsConfiguration
- ActiveDirectoryId
- Aliases Aliases
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- MaintenanceOperationsInProgress
- PreferredFileServerIp
- PreferredSubnetId
- RemoteAdministrationEndpoint
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryAttributes
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- AdministrativeActions
- KmsKeyId
- Lifecycle required
- ProgressPercent ProgressPercent
- ResourceARN
- Tags
- items Tag
- Type required
- Backup
- CreateDataRepositoryTaskRequest
object
- ClientRequestToken ClientRequestToken
- FileSystemId required FileSystemId
- Paths
- items DataRepositoryTaskPath
- Report required
- Enabled required
- Format
- Path
- Scope
- Tags Tags
- Type required
- CreateDataRepositoryTaskResponse
object
- DataRepositoryTask
- CreationTime required CreationTime
- EndTime
- FailureDetails
- Message ErrorMessage
- FileSystemId required FileSystemId
- Lifecycle required
- Paths
- items DataRepositoryTaskPath
- Report CompletionReport
- ResourceARN ResourceARN
- StartTime
- Status
- FailedCount
- LastUpdatedTime
- SucceededCount
- TotalCount
- Tags Tags
- TaskId required
- Type required
- DataRepositoryTask
- CreateFileSystemFromBackupRequest
object
: The request object for theCreateFileSystemFromBackup
operation.- BackupId required BackupId
- ClientRequestToken
- LustreConfiguration CreateFileSystemLustreConfiguration
- SecurityGroupIds
- items SecurityGroupId
- StorageType
- SubnetIds required
- items SubnetId
- Tags
- items Tag
- WindowsConfiguration
- ActiveDirectoryId
- Aliases
- items AlternateDNSName
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- PreferredSubnetId
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryConfiguration
- ThroughputCapacity required
- WeeklyMaintenanceStartTime
- CreateFileSystemFromBackupResponse
object
: The response object for theCreateFileSystemFromBackup
operation.- FileSystem
- AdministrativeActions
- items AdministrativeAction
- CreationTime
- DNSName
- FailureDetails FileSystemFailureDetails
- FileSystemId
- FileSystemType
- KmsKeyId
- Lifecycle
- LustreConfiguration LustreFileSystemConfiguration
- NetworkInterfaceIds
- items NetworkInterfaceId
- OwnerId
- ResourceARN
- StorageCapacity
- StorageType
- SubnetIds
- items SubnetId
- Tags
- items Tag
- VpcId
- WindowsConfiguration
- ActiveDirectoryId
- Aliases Aliases
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- MaintenanceOperationsInProgress
- PreferredFileServerIp
- PreferredSubnetId
- RemoteAdministrationEndpoint
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryAttributes
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- AdministrativeActions
- FileSystem
- CreateFileSystemLustreConfiguration
object
: The Lustre configuration for the file system being created.- AutoImportPolicy
- AutomaticBackupRetentionDays AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime DailyTime
- DeploymentType
- DriveCacheType
- ExportPath
- ImportPath
- ImportedFileChunkSize
- PerUnitStorageThroughput
- WeeklyMaintenanceStartTime
- CreateFileSystemRequest
object
: The request object used to create a new Amazon FSx file system.- ClientRequestToken
- FileSystemType required
- KmsKeyId KmsKeyId
- LustreConfiguration CreateFileSystemLustreConfiguration
- SecurityGroupIds
- items SecurityGroupId
- StorageCapacity required
- StorageType
- SubnetIds required
- items SubnetId
- Tags
- items Tag
- WindowsConfiguration
- ActiveDirectoryId
- Aliases
- items AlternateDNSName
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- PreferredSubnetId
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryConfiguration
- ThroughputCapacity required
- WeeklyMaintenanceStartTime
- CreateFileSystemResponse
object
: The response object returned after the file system is created.- FileSystem
- AdministrativeActions
- items AdministrativeAction
- CreationTime
- DNSName
- FailureDetails FileSystemFailureDetails
- FileSystemId
- FileSystemType
- KmsKeyId
- Lifecycle
- LustreConfiguration LustreFileSystemConfiguration
- NetworkInterfaceIds
- items NetworkInterfaceId
- OwnerId
- ResourceARN
- StorageCapacity
- StorageType
- SubnetIds
- items SubnetId
- Tags
- items Tag
- VpcId
- WindowsConfiguration
- ActiveDirectoryId
- Aliases Aliases
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- MaintenanceOperationsInProgress
- PreferredFileServerIp
- PreferredSubnetId
- RemoteAdministrationEndpoint
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryAttributes
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- AdministrativeActions
- FileSystem
- CreateFileSystemWindowsConfiguration
object
: The configuration object for the Microsoft Windows file system used inCreateFileSystem
andCreateFileSystemFromBackup
operations.- ActiveDirectoryId
- Aliases
- items AlternateDNSName
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- PreferredSubnetId
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryConfiguration
- ThroughputCapacity required
- WeeklyMaintenanceStartTime
- CreationTime
string
: The time that the resource was created, in seconds (since 1970-01-01T00:00:00Z), also known as Unix time.
- DNSName
string
: The Domain Name Service (DNS) name for the file system. You can mount your file system using its DNS name.
- DailyTime
string
: A recurring daily time, in the formatHH:MM
.HH
is the zero-padded hour of the day (0-23), andMM
is the zero-padded minute of the hour. For example,05:00
specifies 5 AM daily.
- DataRepositoryConfiguration
object
: The data repository configuration object for Lustre file systems returned in the response of theCreateFileSystem
operation.- AutoImportPolicy
- ExportPath
- FailureDetails DataRepositoryFailureDetails
- ImportPath
- ImportedFileChunkSize
- Lifecycle
- DataRepositoryFailureDetails
object
: Provides detailed information about the data respository if itsLifecycle
is set toMISCONFIGURED
.- Message ErrorMessage
- DataRepositoryLifecycle
string
(values: CREATING, AVAILABLE, MISCONFIGURED, UPDATING, DELETING)
- DataRepositoryTask
object
: A description of the data repository task. You use data repository tasks to perform bulk transfer operations between your Amazon FSx file system and its linked data repository.- CreationTime required CreationTime
- EndTime
- FailureDetails
- Message ErrorMessage
- FileSystemId required FileSystemId
- Lifecycle required
- Paths
- items DataRepositoryTaskPath
- Report CompletionReport
- ResourceARN ResourceARN
- StartTime
- Status
- FailedCount
- LastUpdatedTime
- SucceededCount
- TotalCount
- Tags Tags
- TaskId required
- Type required
- DataRepositoryTaskFailureDetails
object
: Provides information about why a data repository task failed. Only populated when the taskLifecycle
is set toFAILED
.- Message ErrorMessage
- DataRepositoryTaskFilter
object
: (Optional) An array of filter objects you can use to filter the response of data repository tasks you will see in the the response. You can filter the tasks returned in the response by one or more file system IDs, task lifecycles, and by task type. A filter object consists of a filterName
, and one or moreValues
for the filter.- Name
- Values
- DataRepositoryTaskFilterName
string
(values: file-system-id, task-lifecycle)
- DataRepositoryTaskFilterValue
string
- DataRepositoryTaskFilterValues
array
- DataRepositoryTaskFilters
array
- items DataRepositoryTaskFilter
- DataRepositoryTaskLifecycle
string
(values: PENDING, EXECUTING, FAILED, SUCCEEDED, CANCELED, CANCELING)
- DataRepositoryTaskPath
string
- DataRepositoryTaskPaths
array
- items DataRepositoryTaskPath
- DataRepositoryTaskStatus
object
: Provides the task status showing a running total of the total number of files to be processed, the number successfully processed, and the number of files the task failed to process.- FailedCount
- LastUpdatedTime
- SucceededCount
- TotalCount
- DataRepositoryTaskType
string
(values: EXPORT_TO_REPOSITORY)
- DataRepositoryTasks
array
- items DataRepositoryTask
- DeleteBackupRequest
object
: The request object forDeleteBackup
operation.- BackupId required
- ClientRequestToken
- DeleteBackupResponse
object
: The response object forDeleteBackup
operation.- BackupId
- Lifecycle
- DeleteFileSystemLustreConfiguration
object
: The configuration object for the Amazon FSx for Lustre file system being deleted in theDeleteFileSystem
operation.- FinalBackupTags
- items Tag
- SkipFinalBackup
- FinalBackupTags
- DeleteFileSystemLustreResponse
object
: The response object for the Amazon FSx for Lustre file system being deleted in theDeleteFileSystem
operation.- FinalBackupId
- FinalBackupTags
- items Tag
- DeleteFileSystemRequest
object
: The request object forDeleteFileSystem
operation.- ClientRequestToken
- FileSystemId required
- LustreConfiguration DeleteFileSystemLustreConfiguration
- WindowsConfiguration DeleteFileSystemWindowsConfiguration
- DeleteFileSystemResponse
object
: The response object for theDeleteFileSystem
operation.- FileSystemId
- Lifecycle
- LustreResponse DeleteFileSystemLustreResponse
- WindowsResponse DeleteFileSystemWindowsResponse
- DeleteFileSystemWindowsConfiguration
object
: The configuration object for the Microsoft Windows file system used in theDeleteFileSystem
operation.- FinalBackupTags
- items Tag
- SkipFinalBackup
- FinalBackupTags
- DeleteFileSystemWindowsResponse
object
: The response object for the Microsoft Windows file system used in theDeleteFileSystem
operation.- FinalBackupId
- FinalBackupTags
- items Tag
- DescribeBackupsRequest
object
: The request object forDescribeBackups
operation.
- DescribeBackupsResponse
object
: Response object forDescribeBackups
operation.- Backups
- items Backup
- NextToken
- Backups
- DescribeDataRepositoryTasksRequest
object
- Filters
- items DataRepositoryTaskFilter
- MaxResults MaxResults
- NextToken NextToken
- TaskIds
- items TaskId
- Filters
- DescribeDataRepositoryTasksResponse
object
- DataRepositoryTasks
- items DataRepositoryTask
- NextToken NextToken
- DataRepositoryTasks
- DescribeFileSystemAliasesRequest
object
: The request object forDescribeFileSystemAliases
operation.- ClientRequestToken ClientRequestToken
- FileSystemId required
- MaxResults
- NextToken
- DescribeFileSystemAliasesResponse
object
: The response object forDescribeFileSystemAliases
operation.- Aliases
- items Alias
- NextToken
- Aliases
- DescribeFileSystemsRequest
object
: The request object forDescribeFileSystems
operation.- FileSystemIds
- items FileSystemId
- MaxResults
- NextToken
- FileSystemIds
- DescribeFileSystemsResponse
object
: The response object forDescribeFileSystems
operation.- FileSystems
- items FileSystem
- NextToken
- FileSystems
- DirectoryId
string
- DirectoryPassword
string
- DirectoryUserName
string
- DisassociateFileSystemAliasesRequest
object
: The request object of DNS aliases to disassociate from an Amazon FSx for Windows File Server file system.- Aliases required
- items AlternateDNSName
- ClientRequestToken ClientRequestToken
- FileSystemId required
- Aliases required
- DisassociateFileSystemAliasesResponse
object
: The system generated response showing the DNS aliases that Amazon FSx is attempting to disassociate from the file system. Use the API operation to monitor the status of the aliases Amazon FSx is removing from the file system.- Aliases
- items Alias
- Aliases
- DnsIps
array
- items IpAddress
- DriveCacheType
string
(values: NONE, READ)
- EndTime
string
- ErrorMessage
string
: A detailed error message.
- FailedCount
integer
- FileSystem
object
: A description of a specific Amazon FSx file system.- AdministrativeActions
- items AdministrativeAction
- CreationTime
- DNSName
- FailureDetails FileSystemFailureDetails
- FileSystemId
- FileSystemType
- KmsKeyId
- Lifecycle
- LustreConfiguration LustreFileSystemConfiguration
- NetworkInterfaceIds
- items NetworkInterfaceId
- OwnerId
- ResourceARN
- StorageCapacity
- StorageType
- SubnetIds
- items SubnetId
- Tags
- items Tag
- VpcId
- WindowsConfiguration
- ActiveDirectoryId
- Aliases Aliases
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- MaintenanceOperationsInProgress
- PreferredFileServerIp
- PreferredSubnetId
- RemoteAdministrationEndpoint
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryAttributes
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- AdministrativeActions
- FileSystemAdministratorsGroupName
string
- FileSystemFailureDetails
object
: A structure providing details of any failures that occur when creating the file system has failed.- Message
- FileSystemId
string
: The globally unique ID of the file system, assigned by Amazon FSx.
- FileSystemIds
array
: A list ofFileSystemId
s.- items FileSystemId
- FileSystemLifecycle
string
(values: AVAILABLE, CREATING, FAILED, DELETING, MISCONFIGURED, UPDATING): The lifecycle status of the file system.
- FileSystemMaintenanceOperation
string
(values: PATCHING, BACKING_UP): An enumeration specifying the currently ongoing maintenance operation.
- FileSystemMaintenanceOperations
array
: A list of maintenance operations.
- FileSystemType
string
(values: WINDOWS, LUSTRE): The type of file system.
- FileSystems
array
: A list of file systems.- items FileSystem
- Filter
object
: A filter used to restrict the results of describe calls. You can use multiple filters to return results that meet all applied filter requirements.- Name
- Values
- items FilterValue
- FilterName
string
(values: file-system-id, backup-type, file-system-type): The name for a filter.
- FilterValue
string
: The value for a filter.
- FilterValues
array
: A list of filter values.- items FilterValue
- Filters
array
: A list ofFilter
elements.- items Filter
- Flag
boolean
- IpAddress
string
- KmsKeyId
string
: The ID of the AWS Key Management Service (AWS KMS) key used to encrypt the file system's data for Amazon FSx for Windows File Server file systems and Amazon FSx for LustrePERSISTENT_1
file systems at rest. In either case, if not specified, the Amazon FSx managed key is used. The Amazon FSx for LustreSCRATCH_1
andSCRATCH_2
file systems are always encrypted at rest using Amazon FSx managed keys. For more information, see Encrypt in the AWS Key Management Service API Reference.
- LastUpdatedTime
string
- ListTagsForResourceRequest
object
: The request object forListTagsForResource
operation.- MaxResults
- NextToken
- ResourceARN required
- ListTagsForResourceResponse
object
: The response object forListTagsForResource
operation.- NextToken
- Tags
- items Tag
- LustreDeploymentType
string
(values: SCRATCH_1, SCRATCH_2, PERSISTENT_1)
- LustreFileSystemConfiguration
object
: The configuration for the Amazon FSx for Lustre file system.- AutomaticBackupRetentionDays AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime DailyTime
- DataRepositoryConfiguration DataRepositoryConfiguration
- DeploymentType
- DriveCacheType
- MountName
- PerUnitStorageThroughput
- WeeklyMaintenanceStartTime
- LustreFileSystemMountName
string
- MaxResults
integer
: The maximum number of resources to return in the response. This value must be an integer greater than zero.
- Megabytes
integer
- MegabytesPerSecond
integer
: Sustained throughput of an Amazon FSx file system in MBps.
- NetworkInterfaceId
string
: An elastic network interface ID. An elastic network interface is a logical networking component in a virtual private cloud (VPC) that represents a virtual network card. For more information, see Elastic Network Interfaces in the Amazon EC2 User Guide for Linux Instances.
- NetworkInterfaceIds
array
: A list of network interface IDs.- items NetworkInterfaceId
- NextToken
string
: (Optional) Opaque pagination token returned from a previous operation (String). If present, this token indicates from what point you can continue processing the request, where the previousNextToken
value left off.
- OrganizationalUnitDistinguishedName
string
- PerUnitStorageThroughput
integer
- ProgressPercent
integer
: The current percent of progress of an asynchronous task.
- ReportFormat
string
(values: REPORT_CSV_20191124)
- ReportScope
string
(values: FAILED_FILES_ONLY)
- RequestTime
string
- ResourceARN
string
: The Amazon Resource Name (ARN) for a given resource. ARNs uniquely identify AWS resources. We require an ARN when you need to specify a resource unambiguously across all of AWS. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces in the AWS General Reference.
- SecurityGroupId
string
: The ID of your Amazon EC2 security group. This ID is used to control network access to the endpoint that Amazon FSx creates on your behalf in each subnet. For more information, see Amazon EC2 Security Groups for Linux Instances in the Amazon EC2 User Guide.
- SecurityGroupIds
array
: A list of security group IDs.- items SecurityGroupId
- SelfManagedActiveDirectoryAttributes
object
: The configuration of the self-managed Microsoft Active Directory (AD) directory to which the Windows File Server instance is joined.- DnsIps
- items IpAddress
- DomainName
- FileSystemAdministratorsGroup
- OrganizationalUnitDistinguishedName
- UserName
- DnsIps
- SelfManagedActiveDirectoryConfiguration
object
: The configuration that Amazon FSx uses to join the Windows File Server instance to your self-managed (including on-premises) Microsoft Active Directory (AD) directory.- DnsIps required
- items IpAddress
- DomainName required
- FileSystemAdministratorsGroup
- OrganizationalUnitDistinguishedName
- Password required
- UserName required
- DnsIps required
- SelfManagedActiveDirectoryConfigurationUpdates
object
: The configuration that Amazon FSx uses to join the Windows File Server instance to a self-managed Microsoft Active Directory (AD) directory.- DnsIps
- items IpAddress
- Password
- UserName
- DnsIps
- StartTime
string
- Status
string
(values: FAILED, IN_PROGRESS, PENDING, COMPLETED, UPDATED_OPTIMIZING)
- StorageCapacity
integer
: The storage capacity for your Amazon FSx file system, in gibibytes.
- StorageType
string
(values: SSD, HDD): The storage type for your Amazon FSx file system.
- SubnetId
string
: The ID for a subnet. A subnet is a range of IP addresses in your virtual private cloud (VPC). For more information, see VPC and Subnets in the Amazon VPC User Guide.
- SubnetIds
array
: A list of subnet IDs. Currently, you can specify only one subnet ID in a call to theCreateFileSystem
operation.- items SubnetId
- SucceededCount
integer
- Tag
object
: Specifies a key-value pair for a resource tag.- Key required
- Value required
- TagKey
string
: A string of 1 to 128 characters that specifies the key for a tag. Tag keys must be unique for the resource to which they are attached.
- TagKeys
array
: A list ofTagKey
values, with a maximum of 50 elements.- items TagKey
- TagResourceRequest
object
: The request object for theTagResource
operation.- ResourceARN required
- Tags required
- items Tag
- TagResourceResponse
object
: The response object for theTagResource
operation.
- TagValue
string
: A string of 0 to 256 characters that specifies the value for a tag. Tag values can be null and don't have to be unique in a tag set.
- Tags
array
: A list ofTag
values, with a maximum of 50 elements.- items Tag
- TaskId
string
- TaskIds
array
- items TaskId
- TotalCount
integer
- UntagResourceRequest
object
: The request object forUntagResource
action.- ResourceARN required
- TagKeys required
- items TagKey
- UntagResourceResponse
object
: The response object forUntagResource
action.
- UpdateFileSystemLustreConfiguration
object
: The configuration object for Amazon FSx for Lustre file systems used in theUpdateFileSystem
operation.- AutoImportPolicy
- AutomaticBackupRetentionDays AutomaticBackupRetentionDays
- DailyAutomaticBackupStartTime DailyTime
- WeeklyMaintenanceStartTime
- UpdateFileSystemRequest
object
: The request object for theUpdateFileSystem
operation.- ClientRequestToken
- FileSystemId required
- LustreConfiguration UpdateFileSystemLustreConfiguration
- StorageCapacity
- WindowsConfiguration
- AutomaticBackupRetentionDays
- DailyAutomaticBackupStartTime
- SelfManagedActiveDirectoryConfiguration
- DnsIps
- items IpAddress
- Password
- UserName
- DnsIps
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- UpdateFileSystemResponse
object
: The response object for theUpdateFileSystem
operation.- FileSystem
- AdministrativeActions
- items AdministrativeAction
- CreationTime
- DNSName
- FailureDetails FileSystemFailureDetails
- FileSystemId
- FileSystemType
- KmsKeyId
- Lifecycle
- LustreConfiguration LustreFileSystemConfiguration
- NetworkInterfaceIds
- items NetworkInterfaceId
- OwnerId
- ResourceARN
- StorageCapacity
- StorageType
- SubnetIds
- items SubnetId
- Tags
- items Tag
- VpcId
- WindowsConfiguration
- ActiveDirectoryId
- Aliases Aliases
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- MaintenanceOperationsInProgress
- PreferredFileServerIp
- PreferredSubnetId
- RemoteAdministrationEndpoint
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryAttributes
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- AdministrativeActions
- FileSystem
- UpdateFileSystemWindowsConfiguration
object
: Updates the configuration for an existing Amazon FSx for Windows File Server file system. Amazon FSx only overwrites existing properties with non-null values provided in the request.- AutomaticBackupRetentionDays
- DailyAutomaticBackupStartTime
- SelfManagedActiveDirectoryConfiguration
- DnsIps
- items IpAddress
- Password
- UserName
- DnsIps
- ThroughputCapacity
- WeeklyMaintenanceStartTime
- VpcId
string
: The ID of your virtual private cloud (VPC). For more information, see VPC and Subnets in the Amazon VPC User Guide.
- WeeklyTime
string
:A recurring weekly time, in the format
D:HH:MM
.D
is the day of the week, for which 1 represents Monday and 7 represents Sunday. For further details, see the ISO-8601 spec as described on Wikipedia.HH
is the zero-padded hour of the day (0-23), andMM
is the zero-padded minute of the hour.For example,
1:05:00
specifies maintenance at 5 AM Monday.
- WindowsDeploymentType
string
(values: MULTI_AZ_1, SINGLE_AZ_1, SINGLE_AZ_2)
- WindowsFileSystemConfiguration
object
: The configuration for this Microsoft Windows file system.- ActiveDirectoryId
- Aliases Aliases
- AutomaticBackupRetentionDays
- CopyTagsToBackups
- DailyAutomaticBackupStartTime
- DeploymentType
- MaintenanceOperationsInProgress
- PreferredFileServerIp
- PreferredSubnetId
- RemoteAdministrationEndpoint
- SelfManagedActiveDirectoryConfiguration SelfManagedActiveDirectoryAttributes
- ThroughputCapacity
- WeeklyMaintenanceStartTime