- Navigation GuideYou are on a Command (operation) page with structural examples. Use the navigation breadcrumb if you would like to return to the Client landing page.
UpdateFileSystemCommand
Use this operation to update the configuration of an existing Amazon FSx file system. You can update multiple properties in a single request.
For FSx for Windows File Server file systems, you can update the following properties:
-
AuditLogConfiguration
-
AutomaticBackupRetentionDays
-
DailyAutomaticBackupStartTime
-
SelfManagedActiveDirectoryConfiguration
-
StorageCapacity
-
StorageType
-
ThroughputCapacity
-
DiskIopsConfiguration
-
WeeklyMaintenanceStartTime
For FSx for Lustre file systems, you can update the following properties:
-
AutoImportPolicy
-
AutomaticBackupRetentionDays
-
DailyAutomaticBackupStartTime
-
DataCompressionType
-
FileSystemTypeVersion
-
LogConfiguration
-
LustreRootSquashConfiguration
-
MetadataConfiguration
-
PerUnitStorageThroughput
-
StorageCapacity
-
WeeklyMaintenanceStartTime
For FSx for ONTAP file systems, you can update the following properties:
-
AddRouteTableIds
-
AutomaticBackupRetentionDays
-
DailyAutomaticBackupStartTime
-
DiskIopsConfiguration
-
FsxAdminPassword
-
HAPairs
-
RemoveRouteTableIds
-
StorageCapacity
-
ThroughputCapacity
-
ThroughputCapacityPerHAPair
-
WeeklyMaintenanceStartTime
For FSx for OpenZFS file systems, you can update the following properties:
-
AddRouteTableIds
-
AutomaticBackupRetentionDays
-
CopyTagsToBackups
-
CopyTagsToVolumes
-
DailyAutomaticBackupStartTime
-
DiskIopsConfiguration
-
ReadCacheConfiguration
-
RemoveRouteTableIds
-
StorageCapacity
-
ThroughputCapacity
-
WeeklyMaintenanceStartTime
Example Syntax
Use a bare-bones client and the command you need to make an API call.
import { FSxClient, UpdateFileSystemCommand } from "@aws-sdk/client-fsx"; // ES Modules import
// const { FSxClient, UpdateFileSystemCommand } = require("@aws-sdk/client-fsx"); // CommonJS import
const client = new FSxClient(config);
const input = { // UpdateFileSystemRequest
FileSystemId: "STRING_VALUE", // required
ClientRequestToken: "STRING_VALUE",
StorageCapacity: Number("int"),
WindowsConfiguration: { // UpdateFileSystemWindowsConfiguration
WeeklyMaintenanceStartTime: "STRING_VALUE",
DailyAutomaticBackupStartTime: "STRING_VALUE",
AutomaticBackupRetentionDays: Number("int"),
ThroughputCapacity: Number("int"),
SelfManagedActiveDirectoryConfiguration: { // SelfManagedActiveDirectoryConfigurationUpdates
UserName: "STRING_VALUE",
Password: "STRING_VALUE",
DnsIps: [ // DnsIps
"STRING_VALUE",
],
DomainName: "STRING_VALUE",
OrganizationalUnitDistinguishedName: "STRING_VALUE",
FileSystemAdministratorsGroup: "STRING_VALUE",
},
AuditLogConfiguration: { // WindowsAuditLogCreateConfiguration
FileAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
FileShareAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
AuditLogDestination: "STRING_VALUE",
},
DiskIopsConfiguration: { // DiskIopsConfiguration
Mode: "AUTOMATIC" || "USER_PROVISIONED",
Iops: Number("long"),
},
},
LustreConfiguration: { // UpdateFileSystemLustreConfiguration
WeeklyMaintenanceStartTime: "STRING_VALUE",
DailyAutomaticBackupStartTime: "STRING_VALUE",
AutomaticBackupRetentionDays: Number("int"),
AutoImportPolicy: "NONE" || "NEW" || "NEW_CHANGED" || "NEW_CHANGED_DELETED",
DataCompressionType: "NONE" || "LZ4",
LogConfiguration: { // LustreLogCreateConfiguration
Level: "DISABLED" || "WARN_ONLY" || "ERROR_ONLY" || "WARN_ERROR", // required
Destination: "STRING_VALUE",
},
RootSquashConfiguration: { // LustreRootSquashConfiguration
RootSquash: "STRING_VALUE",
NoSquashNids: [ // LustreNoSquashNids
"STRING_VALUE",
],
},
PerUnitStorageThroughput: Number("int"),
MetadataConfiguration: { // UpdateFileSystemLustreMetadataConfiguration
Iops: Number("int"),
Mode: "AUTOMATIC" || "USER_PROVISIONED",
},
},
OntapConfiguration: { // UpdateFileSystemOntapConfiguration
AutomaticBackupRetentionDays: Number("int"),
DailyAutomaticBackupStartTime: "STRING_VALUE",
FsxAdminPassword: "STRING_VALUE",
WeeklyMaintenanceStartTime: "STRING_VALUE",
DiskIopsConfiguration: {
Mode: "AUTOMATIC" || "USER_PROVISIONED",
Iops: Number("long"),
},
ThroughputCapacity: Number("int"),
AddRouteTableIds: [ // RouteTableIds
"STRING_VALUE",
],
RemoveRouteTableIds: [
"STRING_VALUE",
],
ThroughputCapacityPerHAPair: Number("int"),
HAPairs: Number("int"),
},
OpenZFSConfiguration: { // UpdateFileSystemOpenZFSConfiguration
AutomaticBackupRetentionDays: Number("int"),
CopyTagsToBackups: true || false,
CopyTagsToVolumes: true || false,
DailyAutomaticBackupStartTime: "STRING_VALUE",
ThroughputCapacity: Number("int"),
WeeklyMaintenanceStartTime: "STRING_VALUE",
DiskIopsConfiguration: {
Mode: "AUTOMATIC" || "USER_PROVISIONED",
Iops: Number("long"),
},
AddRouteTableIds: [
"STRING_VALUE",
],
RemoveRouteTableIds: [
"STRING_VALUE",
],
ReadCacheConfiguration: { // OpenZFSReadCacheConfiguration
SizingMode: "NO_CACHE" || "USER_PROVISIONED" || "PROPORTIONAL_TO_THROUGHPUT_CAPACITY",
SizeGiB: Number("int"),
},
},
StorageType: "SSD" || "HDD" || "INTELLIGENT_TIERING",
FileSystemTypeVersion: "STRING_VALUE",
};
const command = new UpdateFileSystemCommand(input);
const response = await client.send(command);
// { // UpdateFileSystemResponse
// FileSystem: { // FileSystem
// OwnerId: "STRING_VALUE",
// CreationTime: new Date("TIMESTAMP"),
// FileSystemId: "STRING_VALUE",
// FileSystemType: "WINDOWS" || "LUSTRE" || "ONTAP" || "OPENZFS",
// Lifecycle: "AVAILABLE" || "CREATING" || "FAILED" || "DELETING" || "MISCONFIGURED" || "UPDATING" || "MISCONFIGURED_UNAVAILABLE",
// FailureDetails: { // FileSystemFailureDetails
// Message: "STRING_VALUE",
// },
// StorageCapacity: Number("int"),
// StorageType: "SSD" || "HDD" || "INTELLIGENT_TIERING",
// VpcId: "STRING_VALUE",
// SubnetIds: [ // SubnetIds
// "STRING_VALUE",
// ],
// NetworkInterfaceIds: [ // NetworkInterfaceIds
// "STRING_VALUE",
// ],
// DNSName: "STRING_VALUE",
// KmsKeyId: "STRING_VALUE",
// ResourceARN: "STRING_VALUE",
// Tags: [ // Tags
// { // Tag
// Key: "STRING_VALUE", // required
// Value: "STRING_VALUE", // required
// },
// ],
// WindowsConfiguration: { // WindowsFileSystemConfiguration
// ActiveDirectoryId: "STRING_VALUE",
// SelfManagedActiveDirectoryConfiguration: { // SelfManagedActiveDirectoryAttributes
// DomainName: "STRING_VALUE",
// OrganizationalUnitDistinguishedName: "STRING_VALUE",
// FileSystemAdministratorsGroup: "STRING_VALUE",
// UserName: "STRING_VALUE",
// DnsIps: [ // DnsIps
// "STRING_VALUE",
// ],
// },
// DeploymentType: "MULTI_AZ_1" || "SINGLE_AZ_1" || "SINGLE_AZ_2",
// RemoteAdministrationEndpoint: "STRING_VALUE",
// PreferredSubnetId: "STRING_VALUE",
// PreferredFileServerIp: "STRING_VALUE",
// ThroughputCapacity: Number("int"),
// MaintenanceOperationsInProgress: [ // FileSystemMaintenanceOperations
// "PATCHING" || "BACKING_UP",
// ],
// WeeklyMaintenanceStartTime: "STRING_VALUE",
// DailyAutomaticBackupStartTime: "STRING_VALUE",
// AutomaticBackupRetentionDays: Number("int"),
// CopyTagsToBackups: true || false,
// Aliases: [ // Aliases
// { // Alias
// Name: "STRING_VALUE",
// Lifecycle: "AVAILABLE" || "CREATING" || "DELETING" || "CREATE_FAILED" || "DELETE_FAILED",
// },
// ],
// AuditLogConfiguration: { // WindowsAuditLogConfiguration
// FileAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
// FileShareAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
// AuditLogDestination: "STRING_VALUE",
// },
// DiskIopsConfiguration: { // DiskIopsConfiguration
// Mode: "AUTOMATIC" || "USER_PROVISIONED",
// Iops: Number("long"),
// },
// },
// LustreConfiguration: { // LustreFileSystemConfiguration
// WeeklyMaintenanceStartTime: "STRING_VALUE",
// DataRepositoryConfiguration: { // DataRepositoryConfiguration
// Lifecycle: "CREATING" || "AVAILABLE" || "MISCONFIGURED" || "UPDATING" || "DELETING" || "FAILED",
// ImportPath: "STRING_VALUE",
// ExportPath: "STRING_VALUE",
// ImportedFileChunkSize: Number("int"),
// AutoImportPolicy: "NONE" || "NEW" || "NEW_CHANGED" || "NEW_CHANGED_DELETED",
// FailureDetails: { // DataRepositoryFailureDetails
// Message: "STRING_VALUE",
// },
// },
// DeploymentType: "SCRATCH_1" || "SCRATCH_2" || "PERSISTENT_1" || "PERSISTENT_2",
// PerUnitStorageThroughput: Number("int"),
// MountName: "STRING_VALUE",
// DailyAutomaticBackupStartTime: "STRING_VALUE",
// AutomaticBackupRetentionDays: Number("int"),
// CopyTagsToBackups: true || false,
// DriveCacheType: "NONE" || "READ",
// DataCompressionType: "NONE" || "LZ4",
// LogConfiguration: { // LustreLogConfiguration
// Level: "DISABLED" || "WARN_ONLY" || "ERROR_ONLY" || "WARN_ERROR", // required
// Destination: "STRING_VALUE",
// },
// RootSquashConfiguration: { // LustreRootSquashConfiguration
// RootSquash: "STRING_VALUE",
// NoSquashNids: [ // LustreNoSquashNids
// "STRING_VALUE",
// ],
// },
// MetadataConfiguration: { // FileSystemLustreMetadataConfiguration
// Iops: Number("int"),
// Mode: "AUTOMATIC" || "USER_PROVISIONED", // required
// },
// EfaEnabled: true || false,
// },
// AdministrativeActions: [ // AdministrativeActions
// { // AdministrativeAction
// AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE" || "THROUGHPUT_OPTIMIZATION" || "IOPS_OPTIMIZATION" || "STORAGE_TYPE_OPTIMIZATION" || "MISCONFIGURED_STATE_RECOVERY" || "VOLUME_UPDATE_WITH_SNAPSHOT" || "VOLUME_INITIALIZE_WITH_SNAPSHOT" || "DOWNLOAD_DATA_FROM_BACKUP",
// ProgressPercent: Number("int"),
// RequestTime: new Date("TIMESTAMP"),
// Status: "FAILED" || "IN_PROGRESS" || "PENDING" || "COMPLETED" || "UPDATED_OPTIMIZING" || "OPTIMIZING",
// TargetFileSystemValues: {
// OwnerId: "STRING_VALUE",
// CreationTime: new Date("TIMESTAMP"),
// FileSystemId: "STRING_VALUE",
// FileSystemType: "WINDOWS" || "LUSTRE" || "ONTAP" || "OPENZFS",
// Lifecycle: "AVAILABLE" || "CREATING" || "FAILED" || "DELETING" || "MISCONFIGURED" || "UPDATING" || "MISCONFIGURED_UNAVAILABLE",
// FailureDetails: {
// Message: "STRING_VALUE",
// },
// StorageCapacity: Number("int"),
// StorageType: "SSD" || "HDD" || "INTELLIGENT_TIERING",
// VpcId: "STRING_VALUE",
// SubnetIds: [
// "STRING_VALUE",
// ],
// NetworkInterfaceIds: [
// "STRING_VALUE",
// ],
// DNSName: "STRING_VALUE",
// KmsKeyId: "STRING_VALUE",
// ResourceARN: "STRING_VALUE",
// Tags: [
// {
// Key: "STRING_VALUE", // required
// Value: "STRING_VALUE", // required
// },
// ],
// WindowsConfiguration: {
// ActiveDirectoryId: "STRING_VALUE",
// SelfManagedActiveDirectoryConfiguration: {
// DomainName: "STRING_VALUE",
// OrganizationalUnitDistinguishedName: "STRING_VALUE",
// FileSystemAdministratorsGroup: "STRING_VALUE",
// UserName: "STRING_VALUE",
// DnsIps: [
// "STRING_VALUE",
// ],
// },
// DeploymentType: "MULTI_AZ_1" || "SINGLE_AZ_1" || "SINGLE_AZ_2",
// RemoteAdministrationEndpoint: "STRING_VALUE",
// PreferredSubnetId: "STRING_VALUE",
// PreferredFileServerIp: "STRING_VALUE",
// ThroughputCapacity: Number("int"),
// MaintenanceOperationsInProgress: [
// "PATCHING" || "BACKING_UP",
// ],
// WeeklyMaintenanceStartTime: "STRING_VALUE",
// DailyAutomaticBackupStartTime: "STRING_VALUE",
// AutomaticBackupRetentionDays: Number("int"),
// CopyTagsToBackups: true || false,
// Aliases: [
// {
// Name: "STRING_VALUE",
// Lifecycle: "AVAILABLE" || "CREATING" || "DELETING" || "CREATE_FAILED" || "DELETE_FAILED",
// },
// ],
// AuditLogConfiguration: {
// FileAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
// FileShareAccessAuditLogLevel: "DISABLED" || "SUCCESS_ONLY" || "FAILURE_ONLY" || "SUCCESS_AND_FAILURE", // required
// AuditLogDestination: "STRING_VALUE",
// },
// DiskIopsConfiguration: {
// Mode: "AUTOMATIC" || "USER_PROVISIONED",
// Iops: Number("long"),
// },
// },
// LustreConfiguration: {
// WeeklyMaintenanceStartTime: "STRING_VALUE",
// DataRepositoryConfiguration: {
// Lifecycle: "CREATING" || "AVAILABLE" || "MISCONFIGURED" || "UPDATING" || "DELETING" || "FAILED",
// ImportPath: "STRING_VALUE",
// ExportPath: "STRING_VALUE",
// ImportedFileChunkSize: Number("int"),
// AutoImportPolicy: "NONE" || "NEW" || "NEW_CHANGED" || "NEW_CHANGED_DELETED",
// FailureDetails: {
// Message: "STRING_VALUE",
// },
// },
// DeploymentType: "SCRATCH_1" || "SCRATCH_2" || "PERSISTENT_1" || "PERSISTENT_2",
// PerUnitStorageThroughput: Number("int"),
// MountName: "STRING_VALUE",
// DailyAutomaticBackupStartTime: "STRING_VALUE",
// AutomaticBackupRetentionDays: Number("int"),
// CopyTagsToBackups: true || false,
// DriveCacheType: "NONE" || "READ",
// DataCompressionType: "NONE" || "LZ4",
// LogConfiguration: {
// Level: "DISABLED" || "WARN_ONLY" || "ERROR_ONLY" || "WARN_ERROR", // required
// Destination: "STRING_VALUE",
// },
// RootSquashConfiguration: {
// RootSquash: "STRING_VALUE",
// NoSquashNids: [
// "STRING_VALUE",
// ],
// },
// MetadataConfiguration: {
// Iops: Number("int"),
// Mode: "AUTOMATIC" || "USER_PROVISIONED", // required
// },
// EfaEnabled: true || false,
// },
// AdministrativeActions: [
// {
// AdministrativeActionType: "FILE_SYSTEM_UPDATE" || "STORAGE_OPTIMIZATION" || "FILE_SYSTEM_ALIAS_ASSOCIATION" || "FILE_SYSTEM_ALIAS_DISASSOCIATION" || "VOLUME_UPDATE" || "SNAPSHOT_UPDATE" || "RELEASE_NFS_V3_LOCKS" || "VOLUME_RESTORE" || "THROUGHPUT_OPTIMIZATION" || "IOPS_OPTIMIZATION" || "STORAGE_TYPE_OPTIMIZATION" || "MISCONFIGURED_STATE_RECOVERY" || "VOLUME_UPDATE_WITH_SNAPSHOT" || "VOLUME_INITIALIZE_WITH_SNAPSHOT" || "DOWNLOAD_DATA_FROM_BACKUP",
// ProgressPercent: Number("int"),
// RequestTime: new Date("TIMESTAMP"),
// Status: "FAILED" || "IN_PROGRESS" || "PENDING" || "COMPLETED" || "UPDATED_OPTIMIZING" || "OPTIMIZING",
// TargetFileSystemValues: "<FileSystem>",
// FailureDetails: { // AdministrativeActionFailureDetails
// Message: "STRING_VALUE",
// },
// TargetVolumeValues: { // Volume
// CreationTime: new Date("TIMESTAMP"),
// FileSystemId: "STRING_VALUE",
// Lifecycle: "CREATING" || "CREATED" || "DELETING" || "FAILED" || "MISCONFIGURED" || "PENDING" || "AVAILABLE",
// Name: "STRING_VALUE",
// OntapConfiguration: { // OntapVolumeConfiguration
// FlexCacheEndpointType: "NONE" || "ORIGIN" || "CACHE",
// JunctionPath: "STRING_VALUE",
// SecurityStyle: "UNIX" || "NTFS" || "MIXED",
// SizeInMegabytes: Number("int"),
// StorageEfficiencyEnabled: true || false,
// StorageVirtualMachineId: "STRING_VALUE",
// StorageVirtualMachineRoot: true || false,
// TieringPolicy: { // TieringPolicy
// CoolingPeriod: Number("int"),
// Name: "SNAPSHOT_ONLY" || "AUTO" || "ALL" || "NONE",
// },
// UUID: "STRING_VALUE",
// OntapVolumeType: "RW" || "DP" || "LS",
// SnapshotPolicy: "STRING_VALUE",
// CopyTagsToBackups: true || false,
// SnaplockConfiguration: { // SnaplockConfiguration
// AuditLogVolume: true || false,
// AutocommitPeriod: { // AutocommitPeriod
// Type: "MINUTES" || "HOURS" || "DAYS" || "MONTHS" || "YEARS" || "NONE", // required
// Value: Number("int"),
// },
// PrivilegedDelete: "DISABLED" || "ENABLED" || "PERMANENTLY_DISABLED",
// RetentionPeriod: { // SnaplockRetentionPeriod
// DefaultRetention: { // RetentionPeriod
// Type: "SECONDS" || "MINUTES" || "HOURS" || "DAYS" || "MONTHS" || "YEARS" || "INFINITE" || "UNSPECIFIED", // required
// Value: Number("int"),
// },
// MinimumRetention: {
// Type: "SECONDS" || "MINUTES" || "HOURS" || "DAYS" || "MONTHS" || "YEARS" || "INFINITE" || "UNSPECIFIED", // required
// Value: Number("int"),
// },
// MaximumRetention: {
// Type: "SECONDS" || "MINUTES" || "HOURS" || "DAYS" || "MONTHS" || "YEARS" || "INFINITE" || "UNSPECIFIED", // required
// Value: Number("int"),
// },
// },
// SnaplockType: "COMPLIANCE" || "ENTERPRISE",
// VolumeAppendModeEnabled: true || false,
// },
// VolumeStyle: "FLEXVOL" || "FLEXGROUP",
// AggregateConfiguration: { // AggregateConfiguration
// Aggregates: [ // Aggregates
// "STRING_VALUE",
// ],
// TotalConstituents: Number("int"),
// },
// SizeInBytes: Number("long"),
// },
// ResourceARN: "STRING_VALUE",
// Tags: "<Tags>",
// VolumeId: "STRING_VALUE",
// VolumeType: "ONTAP" || "OPENZFS",
// LifecycleTransitionReason: { // LifecycleTransitionReason
// Message: "STRING_VALUE",
// },
// AdministrativeActions: "<AdministrativeActions>",
// OpenZFSConfiguration: { // OpenZFSVolumeConfiguration
// ParentVolumeId: "STRING_VALUE",
// VolumePath: "STRING_VALUE",
// StorageCapacityReservationGiB: Number("int"),
// StorageCapacityQuotaGiB: Number("int"),
// RecordSizeKiB: Number("int"),
// DataCompressionType: "NONE" || "ZSTD" || "LZ4",
// CopyTagsToSnapshots: true || false,
// OriginSnapshot: { // OpenZFSOriginSnapshotConfiguration
// SnapshotARN: "STRING_VALUE",
// CopyStrategy: "CLONE" || "FULL_COPY" || "INCREMENTAL_COPY",
// },
// ReadOnly: true || false,
// NfsExports: [ // OpenZFSNfsExports
// { // OpenZFSNfsExport
// ClientConfigurations: [ // OpenZFSClientConfigurations // required
// { // OpenZFSClientConfiguration
// Clients: "STRING_VALUE", // required
// Options: [ // OpenZFSNfsExportOptions // required
// "STRING_VALUE",
// ],
// },
// ],
// },
// ],
// UserAndGroupQuotas: [ // OpenZFSUserAndGroupQuotas
// { // OpenZFSUserOrGroupQuota
// Type: "USER" || "GROUP", // required
// Id: Number("int"), // required
// StorageCapacityQuotaGiB: Number("int"), // required
// },
// ],
// RestoreToSnapshot: "STRING_VALUE",
// DeleteIntermediateSnaphots: true || false,
// DeleteClonedVolumes: true || false,
// DeleteIntermediateData: true || false,
// SourceSnapshotARN: "STRING_VALUE",
// DestinationSnapshot: "STRING_VALUE",
// CopyStrategy: "CLONE" || "FULL_COPY" || "INCREMENTAL_COPY",
// },
// },
// TargetSnapshotValues: { // Snapshot
// ResourceARN: "STRING_VALUE",
// SnapshotId: "STRING_VALUE",
// Name: "STRING_VALUE",
// VolumeId: "STRING_VALUE",
// CreationTime: new Date("TIMESTAMP"),
// Lifecycle: "PENDING" || "CREATING" || "DELETING" || "AVAILABLE",
// LifecycleTransitionReason: {
// Message: "STRING_VALUE",
// },
// Tags: "<Tags>",
// AdministrativeActions: "<AdministrativeActions>",
// },
// TotalTransferBytes: Number("long"),
// RemainingTransferBytes: Number("long"),
// },
// ],
// OntapConfiguration: { // OntapFileSystemConfiguration
// AutomaticBackupRetentionDays: Number("int"),
// DailyAutomaticBackupStartTime: "STRING_VALUE",
// DeploymentType: "MULTI_AZ_1" || "SINGLE_AZ_1" || "SINGLE_AZ_2" || "MULTI_AZ_2",
// EndpointIpAddressRange: "STRING_VALUE",
// Endpoints: { // FileSystemEndpoints
// Intercluster: { // FileSystemEndpoint
// DNSName: "STRING_VALUE",
// IpAddresses: [ // OntapEndpointIpAddresses
// "STRING_VALUE",
// ],
// },
// Management: {
// DNSName: "STRING_VALUE",
// IpAddresses: [
// "STRING_VALUE",
// ],
// },
// },
// DiskIopsConfiguration: {
// Mode: "AUTOMATIC" || "USER_PROVISIONED",
// Iops: Number("long"),
// },
// PreferredSubnetId: "STRING_VALUE",
// RouteTableIds: [ // RouteTableIds
// "STRING_VALUE",
// ],
// ThroughputCapacity: Number("int"),
// WeeklyMaintenanceStartTime: "STRING_VALUE",
// FsxAdminPassword: "STRING_VALUE",
// HAPairs: Number("int"),
// ThroughputCapacityPerHAPair: Number("int"),
// },
// FileSystemTypeVersion: "STRING_VALUE",
// OpenZFSConfiguration: { // OpenZFSFileSystemConfiguration
// AutomaticBackupRetentionDays: Number("int"),
// CopyTagsToBackups: true || false,
// CopyTagsToVolumes: true || false,
// DailyAutomaticBackupStartTime: "STRING_VALUE",
// DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2" || "SINGLE_AZ_HA_1" || "SINGLE_AZ_HA_2" || "MULTI_AZ_1",
// ThroughputCapacity: Number("int"),
// WeeklyMaintenanceStartTime: "STRING_VALUE",
// DiskIopsConfiguration: {
// Mode: "AUTOMATIC" || "USER_PROVISIONED",
// Iops: Number("long"),
// },
// RootVolumeId: "STRING_VALUE",
// PreferredSubnetId: "STRING_VALUE",
// EndpointIpAddressRange: "STRING_VALUE",
// RouteTableIds: [
// "STRING_VALUE",
// ],
// EndpointIpAddress: "STRING_VALUE",
// ReadCacheConfiguration: { // OpenZFSReadCacheConfiguration
// SizingMode: "NO_CACHE" || "USER_PROVISIONED" || "PROPORTIONAL_TO_THROUGHPUT_CAPACITY",
// SizeGiB: Number("int"),
// },
// },
// },
// FailureDetails: {
// Message: "STRING_VALUE",
// },
// TargetVolumeValues: {
// CreationTime: new Date("TIMESTAMP"),
// FileSystemId: "STRING_VALUE",
// Lifecycle: "CREATING" || "CREATED" || "DELETING" || "FAILED" || "MISCONFIGURED" || "PENDING" || "AVAILABLE",
// Name: "STRING_VALUE",
// OntapConfiguration: {
// FlexCacheEndpointType: "NONE" || "ORIGIN" || "CACHE",
// JunctionPath: "STRING_VALUE",
// SecurityStyle: "UNIX" || "NTFS" || "MIXED",
// SizeInMegabytes: Number("int"),
// StorageEfficiencyEnabled: true || false,
// StorageVirtualMachineId: "STRING_VALUE",
// StorageVirtualMachineRoot: true || false,
// TieringPolicy: {
// CoolingPeriod: Number("int"),
// Name: "SNAPSHOT_ONLY" || "AUTO" || "ALL" || "NONE",
// },
// UUID: "STRING_VALUE",
// OntapVolumeType: "RW" || "DP" || "LS",
// SnapshotPolicy: "STRING_VALUE",
// CopyTagsToBackups: true || false,
// SnaplockConfiguration: {
// AuditLogVolume: true || false,
// AutocommitPeriod: {
// Type: "MINUTES" || "HOURS" || "DAYS" || "MONTHS" || "YEARS" || "NONE", // required
// Value: Number("int"),
// },
// PrivilegedDelete: "DISABLED" || "ENABLED" || "PERMANENTLY_DISABLED",
// RetentionPeriod: {
// DefaultRetention: {
// Type: "SECONDS" || "MINUTES" || "HOURS" || "DAYS" || "MONTHS" || "YEARS" || "INFINITE" || "UNSPECIFIED", // required
// Value: Number("int"),
// },
// MinimumRetention: {
// Type: "SECONDS" || "MINUTES" || "HOURS" || "DAYS" || "MONTHS" || "YEARS" || "INFINITE" || "UNSPECIFIED", // required
// Value: Number("int"),
// },
// MaximumRetention: "<RetentionPeriod>", // required
// },
// SnaplockType: "COMPLIANCE" || "ENTERPRISE",
// VolumeAppendModeEnabled: true || false,
// },
// VolumeStyle: "FLEXVOL" || "FLEXGROUP",
// AggregateConfiguration: {
// Aggregates: [
// "STRING_VALUE",
// ],
// TotalConstituents: Number("int"),
// },
// SizeInBytes: Number("long"),
// },
// ResourceARN: "STRING_VALUE",
// Tags: "<Tags>",
// VolumeId: "STRING_VALUE",
// VolumeType: "ONTAP" || "OPENZFS",
// LifecycleTransitionReason: {
// Message: "STRING_VALUE",
// },
// AdministrativeActions: "<AdministrativeActions>",
// OpenZFSConfiguration: {
// ParentVolumeId: "STRING_VALUE",
// VolumePath: "STRING_VALUE",
// StorageCapacityReservationGiB: Number("int"),
// StorageCapacityQuotaGiB: Number("int"),
// RecordSizeKiB: Number("int"),
// DataCompressionType: "NONE" || "ZSTD" || "LZ4",
// CopyTagsToSnapshots: true || false,
// OriginSnapshot: {
// SnapshotARN: "STRING_VALUE",
// CopyStrategy: "CLONE" || "FULL_COPY" || "INCREMENTAL_COPY",
// },
// ReadOnly: true || false,
// NfsExports: [
// {
// ClientConfigurations: [ // required
// {
// Clients: "STRING_VALUE", // required
// Options: [ // required
// "STRING_VALUE",
// ],
// },
// ],
// },
// ],
// UserAndGroupQuotas: [
// {
// Type: "USER" || "GROUP", // required
// Id: Number("int"), // required
// StorageCapacityQuotaGiB: Number("int"), // required
// },
// ],
// RestoreToSnapshot: "STRING_VALUE",
// DeleteIntermediateSnaphots: true || false,
// DeleteClonedVolumes: true || false,
// DeleteIntermediateData: true || false,
// SourceSnapshotARN: "STRING_VALUE",
// DestinationSnapshot: "STRING_VALUE",
// CopyStrategy: "CLONE" || "FULL_COPY" || "INCREMENTAL_COPY",
// },
// },
// TargetSnapshotValues: {
// ResourceARN: "STRING_VALUE",
// SnapshotId: "STRING_VALUE",
// Name: "STRING_VALUE",
// VolumeId: "STRING_VALUE",
// CreationTime: new Date("TIMESTAMP"),
// Lifecycle: "PENDING" || "CREATING" || "DELETING" || "AVAILABLE",
// LifecycleTransitionReason: {
// Message: "STRING_VALUE",
// },
// Tags: "<Tags>",
// AdministrativeActions: "<AdministrativeActions>",
// },
// TotalTransferBytes: Number("long"),
// RemainingTransferBytes: Number("long"),
// },
// ],
// OntapConfiguration: {
// AutomaticBackupRetentionDays: Number("int"),
// DailyAutomaticBackupStartTime: "STRING_VALUE",
// DeploymentType: "MULTI_AZ_1" || "SINGLE_AZ_1" || "SINGLE_AZ_2" || "MULTI_AZ_2",
// EndpointIpAddressRange: "STRING_VALUE",
// Endpoints: {
// Intercluster: {
// DNSName: "STRING_VALUE",
// IpAddresses: [
// "STRING_VALUE",
// ],
// },
// Management: {
// DNSName: "STRING_VALUE",
// IpAddresses: [
// "STRING_VALUE",
// ],
// },
// },
// DiskIopsConfiguration: {
// Mode: "AUTOMATIC" || "USER_PROVISIONED",
// Iops: Number("long"),
// },
// PreferredSubnetId: "STRING_VALUE",
// RouteTableIds: [
// "STRING_VALUE",
// ],
// ThroughputCapacity: Number("int"),
// WeeklyMaintenanceStartTime: "STRING_VALUE",
// FsxAdminPassword: "STRING_VALUE",
// HAPairs: Number("int"),
// ThroughputCapacityPerHAPair: Number("int"),
// },
// FileSystemTypeVersion: "STRING_VALUE",
// OpenZFSConfiguration: {
// AutomaticBackupRetentionDays: Number("int"),
// CopyTagsToBackups: true || false,
// CopyTagsToVolumes: true || false,
// DailyAutomaticBackupStartTime: "STRING_VALUE",
// DeploymentType: "SINGLE_AZ_1" || "SINGLE_AZ_2" || "SINGLE_AZ_HA_1" || "SINGLE_AZ_HA_2" || "MULTI_AZ_1",
// ThroughputCapacity: Number("int"),
// WeeklyMaintenanceStartTime: "STRING_VALUE",
// DiskIopsConfiguration: "<DiskIopsConfiguration>",
// RootVolumeId: "STRING_VALUE",
// PreferredSubnetId: "STRING_VALUE",
// EndpointIpAddressRange: "STRING_VALUE",
// RouteTableIds: [
// "STRING_VALUE",
// ],
// EndpointIpAddress: "STRING_VALUE",
// ReadCacheConfiguration: {
// SizingMode: "NO_CACHE" || "USER_PROVISIONED" || "PROPORTIONAL_TO_THROUGHPUT_CAPACITY",
// SizeGiB: Number("int"),
// },
// },
// },
// };
Example Usage
UpdateFileSystemCommand Input
Parameter | Type | Description |
---|
Parameter | Type | Description |
---|---|---|
FileSystemId Required | string | undefined | The ID of the file system that you are updating. |
ClientRequestToken | string | undefined | A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent updates. This string is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK. |
FileSystemTypeVersion | string | undefined | The Lustre version you are updating an FSx for Lustre file system to. Valid values are |
LustreConfiguration | UpdateFileSystemLustreConfiguration | undefined | The configuration object for Amazon FSx for Lustre file systems used in the |
OntapConfiguration | UpdateFileSystemOntapConfiguration | undefined | The configuration updates for an Amazon FSx for NetApp ONTAP file system. |
OpenZFSConfiguration | UpdateFileSystemOpenZFSConfiguration | undefined | The configuration updates for an FSx for OpenZFS file system. |
StorageCapacity | number | undefined | Use this parameter to increase the storage capacity of an FSx for Windows File Server, FSx for Lustre, FSx for OpenZFS, or FSx for ONTAP file system. Specifies the storage capacity target value, in GiB, to increase the storage capacity for the file system that you're updating. You can't make a storage capacity increase request if there is an existing storage capacity increase request in progress. For Lustre file systems, the storage capacity target value can be the following:
For more information, see Managing storage and throughput capacity in the FSx for Lustre User Guide. For FSx for OpenZFS file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. For more information, see Managing storage capacity in the FSx for OpenZFS User Guide. For Windows file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. To increase storage capacity, the file system must have at least 16 MBps of throughput capacity. For more information, see Managing storage capacity in the Amazon FSxfor Windows File Server User Guide. For ONTAP file systems, the storage capacity target value must be at least 10 percent greater than the current storage capacity value. For more information, see Managing storage capacity and provisioned IOPS in the Amazon FSx for NetApp ONTAP User Guide. |
StorageType | StorageType | undefined | Specifies the file system's storage type. |
WindowsConfiguration | UpdateFileSystemWindowsConfiguration | undefined | The configuration updates for an Amazon FSx for Windows File Server file system. |
UpdateFileSystemCommand Output
Parameter | Type | Description |
---|
Parameter | Type | Description |
---|---|---|
$metadata Required | ResponseMetadata | Metadata pertaining to this request. |
FileSystem | FileSystem | undefined | A description of the file system that was updated. |
Throws
Name | Fault | Details |
---|
Name | Fault | Details |
---|---|---|
BadRequest | client | A generic error indicating a failure with a client request. |
FileSystemNotFound | client | No Amazon FSx file systems were found based upon supplied parameters. |
IncompatibleParameterError | client | The error returned when a second request is received with the same client request token but different parameters settings. A client request token should always uniquely identify a single request. |
InternalServerError | server | A generic error indicating a server-side failure. |
InvalidNetworkSettings | client | One or more network settings specified in the request are invalid. |
MissingFileSystemConfiguration | client | A file system configuration is required for this operation. |
ServiceLimitExceeded | client | An error indicating that a particular service limit was exceeded. You can increase some service limits by contacting Amazon Web Services Support. |
UnsupportedOperation | client | The requested operation is not supported for this resource or API. |
FSxServiceException | Base exception class for all service exceptions from FSx service. |