update-file-system — AWS CLI 2.0.34 Command Reference

Description

Use this operation to update the configuration of an existing Amazon FSx file system. For an Amazon FSx for Lustre file system, you can update only the WeeklyMaintenanceStartTime. For an Amazon for Windows File Server file system, you can update the following properties:

• AutomaticBackupRetentionDays

• DailyAutomaticBackupStartTime

• SelfManagedActiveDirectoryConfiguration

• StorageCapacity

• ThroughputCapacity

• WeeklyMaintenanceStartTime

You can update multiple properties in a single request.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Options

--file-system-id (string)

Identifies the file system that you are updating.

--client-request-token (string)

A string of up to 64 ASCII characters that Amazon FSx uses to ensure idempotent updates. This string is automatically filled on your behalf when you use the AWS Command Line Interface (AWS CLI) or an AWS SDK.

--storage-capacity (integer)

Use this parameter to increase the storage capacity of an Amazon FSx for Windows File Server file system. Specifies the storage capacity target value, GiB, for the file system you’re updating. The storage capacity target value must be at least 10 percent (%) greater than the current storage capacity value. In order to increase storage capacity, the file system needs to have at least 16 MB/s of throughput capacity. You cannot make a storage capacity increase request if there is an existing storage capacity increase request in progress. For more information, see Managing Storage Capacity .

--windows-configuration (structure)

The configuration updates for an Amazon FSx for Windows File Server file system.

WeeklyMaintenanceStartTime -> (string)

The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC time zone. Where d is the weekday number, from 1 through 7, with 1 = Monday and 7 = Sunday.

DailyAutomaticBackupStartTime -> (string)

The preferred time to start the daily automatic backup, in the UTC time zone, for example, 02:00

AutomaticBackupRetentionDays -> (integer)

The number of days to retain automatic daily backups. Setting this to zero (0) disables automatic daily backups. You can retain automatic daily backups for a maximum of 35 days. For more information, see Working with Automatic Daily Backups .

ThroughputCapacity -> (integer)

Sets the target value for a file system’s throughput capacity, in MB/s, that you are updating the file system to. Valid values are 8, 16, 32, 64, 128, 256, 512, 1024, 2048. You cannot make a throughput capacity update request if there is an existing throughput capacity update request in progress. For more information, see Managing Throughput Capacity .

SelfManagedActiveDirectoryConfiguration -> (structure)

The configuration Amazon FSx uses to join the Windows File Server instance to the self-managed Microsoft AD directory. You cannot make a self-managed Microsoft AD update request if there is an existing self-managed Microsoft AD update request in progress.

UserName -> (string)

The user name for the service account on your self-managed AD domain that Amazon FSx will use to join to your AD domain. This account must have the permission to join computers to the domain in the organizational unit provided in OrganizationalUnitDistinguishedName .

Password -> (string)

The password for the service account on your self-managed AD domain that Amazon FSx will use to join to your AD domain.

DnsIps -> (list)

A list of up to two IP addresses of DNS servers or domain controllers in the self-managed AD directory.

(string)

Shorthand Syntax:

WeeklyMaintenanceStartTime=string,DailyAutomaticBackupStartTime=string,AutomaticBackupRetentionDays=integer,ThroughputCapacity=integer,SelfManagedActiveDirectoryConfiguration={UserName=string,Password=string,DnsIps=[string,string]}

JSON Syntax:

{ "WeeklyMaintenanceStartTime": "string", "DailyAutomaticBackupStartTime": "string", "AutomaticBackupRetentionDays": integer, "ThroughputCapacity": integer, "SelfManagedActiveDirectoryConfiguration": { "UserName": "string", "Password": "string", "DnsIps": ["string", ...] }}

--lustre-configuration (structure)

The configuration object for Amazon FSx for Lustre file systems used in the UpdateFileSystem operation.

WeeklyMaintenanceStartTime -> (string)

The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC time zone. d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday.

DailyAutomaticBackupStartTime -> (string)

A recurring daily time, in the format HH:MM . HH is the zero-padded hour of the day (0-23), and MM is the zero-padded minute of the hour. For example, 05:00 specifies 5 AM daily.

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 35 days. The default is 0.

AutoImportPolicy -> (string)

Use this property to turn the Autoimport feature on and off. AutoImport enables your FSx for Lustre file system to automatically update its contents with changes that have been made to its linked Amazon S3 data repository. You can set the policy to have one the following values:

• NONE - (Default) Autoimport is turned off. Changes to your S3 repository will not be reflected on the FSx file system.

• NEW - Autoimport is turned on; only new files in the linked S3 repository will be imported to the FSx file system. Updates to existing files and deleted files will not be imported to the FSx file system.

• NEW_CHANGED - Autoimport is turned on; new files and changes to existing files in the linked S3 repository will be imported to the FSx file system. Files deleted in S3 are not deleted in the FSx file system.

• NEW_CHANGED_DELETED - Autoimport is turned on; new files, changes to existing files, and deleted files in the linked S3 repository will be imported to the FSx file system.

Shorthand Syntax:

WeeklyMaintenanceStartTime=string,DailyAutomaticBackupStartTime=string,AutomaticBackupRetentionDays=integer,AutoImportPolicy=string

JSON Syntax:

{ "WeeklyMaintenanceStartTime": "string", "DailyAutomaticBackupStartTime": "string", "AutomaticBackupRetentionDays": integer, "AutoImportPolicy": "NONE"|"NEW"|"NEW_CHANGED"}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

--cli-auto-prompt (boolean) Automatically prompt for CLI input parameters.

See ‘aws help’ for descriptions of global parameters.