az storage fs file

Manage files in Azure Data Lake Storage Gen2 account.

Commands

Name	Description	Type	Status
az storage fs file append	Append content to a file in ADLS Gen2 file system.	Core	GA
az storage fs file create	Create a new file in ADLS Gen2 file system.	Core	GA
az storage fs file delete	Delete a file in ADLS Gen2 file system.	Core	GA
az storage fs file download	Download a file from the specified path in ADLS Gen2 file system.	Core	GA
az storage fs file exists	Check for the existence of a file in ADLS Gen2 file system.	Core	GA
az storage fs file list	List files and directories in ADLS Gen2 file system.	Core	GA
az storage fs file metadata	Manage the metadata for file in file system.	Core	GA
az storage fs file metadata show	Return all user-defined metadata for the specified file.	Core	GA
az storage fs file metadata update	Sets one or more user-defined name-value pairs for the specified file system.	Core	GA
az storage fs file move	Move a file in ADLS Gen2 Account.	Core	GA
az storage fs file set-expiry	Sets the time a file will expire and be deleted.	Core	GA
az storage fs file show	Show properties of file in ADLS Gen2 file system.	Core	GA
az storage fs file upload	Upload a file to a file path in ADLS Gen2 file system.	Core	GA

az storage fs file append

Edit

Append content to a file in ADLS Gen2 file system.

az storage fs file append --content
                          --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--sas-token]
                          [--timeout]

Examples

Append content to a file in ADLS Gen2 file system.

az storage fs file append --content "test content test" -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Required Parameters

--content

Content to be appended to file.

--file-system -f

File system name (i.e. container name).

--path -p

The file path in a file system.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Storage account name. Related environment variable: AZURE_STORAGE_ACCOUNT. Must be used in conjunction with either storage account key or a SAS token. If neither are present, the command will try to query the storage account key using the authenticated Azure account. If a large number of storage commands are executed the API quota may be hit.

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

The mode in which to run the command. "login" mode will directly use your login credentials for the authentication. The legacy "key" mode will attempt to query for an account key if no authentication parameters for the account are provided. Environment variable: AZURE_STORAGE_AUTH_MODE.

Property	Value
Accepted values:	key, login

--blob-endpoint

Storage data service endpoint. Must be used in conjunction with either storage account key or a SAS token. You can find each service primary endpoint with az storage account show. Environment variable: AZURE_STORAGE_SERVICE_ENDPOINT.

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--timeout

Request timeout in seconds. Applies to each call to the service.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file create

Edit

Create a new file in ADLS Gen2 file system.

az storage fs file create --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--content-cache --content-cache-control]
                          [--content-disposition]
                          [--content-encoding]
                          [--content-language]
                          [--content-md5]
                          [--content-type]
                          [--metadata]
                          [--permissions]
                          [--sas-token]
                          [--timeout]
                          [--umask]

Examples

Create a new file in ADLS Gen2 file system.

az storage fs file create -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Required Parameters

--file-system -f

File system name (i.e. container name).

--path -p

The file path in a file system.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--content-cache --content-cache-control

The cache control string.

--content-disposition

Conveys additional information about how to process the response payload, and can also be used to attach additional metadata.

--content-encoding

The content encoding type.

--content-language

The content language.

--content-md5

The content's MD5 hash.

--content-type

The content MIME type.

--metadata

Metadata in space-separated key=value pairs. This overwrites any existing metadata.

--permissions

POSIX access permissions for the file owner, the file owning group, and others. Each class may be granted read (4), write (2), or execute (1) permission. Both symbolic (rwxrw-rw-) and 4-digit octal notation (e.g. 0766) are supported. The sticky bit is also supported and in symbolic notation, its represented either by the letter t or T in the final character-place depending on whether the execution bit for the others category is set or unset respectively (e.g. rwxrw-rw- with sticky bit is represented as rwxrw-rwT. A rwxrw-rwx with sticky bit is represented as rwxrw-rwt), absence of t or T indicates sticky bit not set. In 4-digit octal notation, its represented by 1st digit (e.g. 1766 represents rwxrw-rw- with sticky bit and 0766 represents rwxrw-rw- without sticky bit). For more information, please refer to https://learn.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#levels-of-permission.

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--timeout

Request timeout in seconds. Applies to each call to the service.

--umask

When creating a file or directory and the parent folder does not have a default ACL, the umask restricts the permissions of the file or directory to be created. The resulting permission is given by p & ^u, where p is the permission and u is the umask. For more information, please refer to https://learn.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#umask.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file delete

Edit

Delete a file in ADLS Gen2 file system.

az storage fs file delete --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--sas-token]
                          [--timeout]
                          [--yes]

Examples

Delete a file in ADLS Gen2 file system.

az storage fs file delete -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Required Parameters

--file-system -f

File system name (i.e. container name).

--path -p

The file path in a file system.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--timeout

Request timeout in seconds. Applies to each call to the service.

--yes -y

Do not prompt for confirmation.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file download

Edit

Download a file from the specified path in ADLS Gen2 file system.

az storage fs file download --file-system
                            --path
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--destination]
                            [--overwrite {false, true}]
                            [--sas-token]
                            [--timeout]

Examples

Download a file in ADLS Gen2 file system to current path.

az storage fs file download -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Download a file in ADLS Gen2 file system to a specified directory.

az storage fs file download -p dir/a.txt -d test/ -f fsname --account-name myadlsaccount --account-key 0000-0000

Download a file in ADLS Gen2 file system to a specified file path.

az storage fs file download -p dir/a.txt -d test/b.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Required Parameters

--file-system -f

File system name (i.e. container name).

--path -p

The file path in a file system.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--destination -d

The local file where the file or folder will be downloaded to. The source filename will be used if not specified.

--overwrite

Overwrite an existing file when specified. Default value is false.

Property	Value
Default value:	True
Accepted values:	false, true

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--timeout

Request timeout in seconds. Applies to each call to the service.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file exists

Edit

Check for the existence of a file in ADLS Gen2 file system.

az storage fs file exists --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--sas-token]
                          [--timeout]

Examples

Check for the existence of a file in ADLS Gen2 file system.

az storage fs file exists -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Required Parameters

--file-system -f

File system name (i.e. container name).

--path -p

The file path in a file system.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--timeout

Request timeout in seconds. Applies to each call to the service.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file list

Edit

List files and directories in ADLS Gen2 file system.

az storage fs file list --file-system
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--exclude-dir]
                        [--marker]
                        [--num-results]
                        [--path]
                        [--recursive {false, true}]
                        [--sas-token]
                        [--show-next-marker]
                        [--timeout]

Examples

List files and directories in ADLS Gen2 file system.

az storage fs file list -f fsname --account-name myadlsaccount --account-key 0000-0000

List files in ADLS Gen2 file system.

az storage fs file list --exclude-dir -f fsname --account-name myadlsaccount --account-key 0000-0000

List files and directories in a specified path.

az storage fs file list --path dir -f fsname --account-name myadlsaccount --account-key 0000-0000

List files and directories from a specific marker.

az storage fs file list --marker "VBaS6LvPufaqrTANTQvbmV3dHJ5FgAAAA==" -f fsname --account-name myadlsaccount --account-key 0000-0000

Required Parameters

--file-system -f

File system name (i.e. container name).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--exclude-dir

List only files in the given file system.

--marker

An opaque continuation token. This value can be retrieved from the next_marker field of a previous generator object. If specified, this generator will begin returning results from this point.

--num-results

Specify the maximum number of results to return. If the request does not specify num_results or specifies a value greater than 5,000, the server will return up to 5,000 items.

Property	Value
Default value:	5000

--path

Filter the results to return only paths under the specified path.

--recursive

Look into sub-directories recursively when set to true.

Property	Value
Default value:	True
Accepted values:	false, true

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--show-next-marker

Preview

Show nextMarker in result when specified.

--timeout

Request timeout in seconds. Applies to each call to the service.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file move

Edit

Move a file in ADLS Gen2 Account.

az storage fs file move --file-system
                        --new-path
                        --path
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--content-cache --content-cache-control]
                        [--content-disposition]
                        [--content-encoding]
                        [--content-language]
                        [--content-md5]
                        [--content-type]
                        [--sas-token]

Examples

Move a file in ADLS Gen2 Account.

az storage fs file move --new-path new-fs/new-dir/b.txt -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Required Parameters

--file-system -f

File system name (i.e. container name).

--new-path

The new path the users want to move to. The value must have the following format: "{filesystem}/{directory}/{subdirectory}/{file}".

--path -p

The original file path users want to move in a file system.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--content-cache --content-cache-control

The cache control string.

--content-disposition

Conveys additional information about how to process the response payload, and can also be used to attach additional metadata.

--content-encoding

The content encoding type.

--content-language

The content language.

--content-md5

The content's MD5 hash.

--content-type

The content MIME type.

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file set-expiry

Edit

Sets the time a file will expire and be deleted.

az storage fs file set-expiry --expiry-options {Absolute, NeverExpire, RelativeToCreation, RelativeToNow}
                              --file-system
                              --path
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--blob-endpoint]
                              [--connection-string]
                              [--expires-on]
                              [--sas-token]
                              [--timeout]

Required Parameters

--expiry-options

Required. Indicates mode of the expiry time. Possible values include: 'NeverExpire', 'RelativeToCreation', 'RelativeToNow', 'Absolute'.

Property	Value
Accepted values:	Absolute, NeverExpire, RelativeToCreation, RelativeToNow

--file-system -f

File system name (i.e. container name).

--path -p

The file path in a file system.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--expires-on

The time to set the file to expiry. When expiry_options is RelativeTo*, expires_on should be an int in milliseconds. If the type of expires_on is datetime, it should be in UTC time.

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--timeout

Request timeout in seconds. Applies to each call to the service.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file show

Edit

Show properties of file in ADLS Gen2 file system.

az storage fs file show --file-system
                        --path
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--sas-token]
                        [--timeout]

Examples

Show properties of file in ADLS Gen2 file system.

az storage fs file show -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Show properties of file in ADLS Gen2 file system. (autogenerated)

az storage fs file show --account-name myadlsaccount --auth-mode login --file-system fsname --path dir/a.txt

Required Parameters

--file-system -f

File system name (i.e. container name).

--path -p

The file path in a file system.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--timeout

Request timeout in seconds. Applies to each call to the service.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az storage fs file upload

Edit

Upload a file to a file path in ADLS Gen2 file system.

az storage fs file upload --file-system
                          --path
                          --source
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--content-cache --content-cache-control]
                          [--content-disposition]
                          [--content-encoding]
                          [--content-language]
                          [--content-md5]
                          [--content-type]
                          [--if-match]
                          [--if-modified-since]
                          [--if-none-match]
                          [--if-unmodified-since]
                          [--metadata]
                          [--overwrite {false, true}]
                          [--permissions]
                          [--sas-token]
                          [--timeout]
                          [--umask]

Examples

Upload a file from local path to a file path in ADLS Gen2 file system.

az storage fs file upload --source a.txt -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

Required Parameters

--file-system -f

File system name (i.e. container name).

--path -p

The file path in a file system.

--source -s

Path of the local file to upload as the file content.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Storage account key. Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_KEY.

Property	Value
Parameter group:	Storage Account Arguments

--account-name

Property	Value
Parameter group:	Storage Account Arguments

--auth-mode

Property	Value
Accepted values:	key, login

--blob-endpoint

Property	Value
Parameter group:	Storage Account Arguments

--connection-string

Storage account connection string. Environment variable: AZURE_STORAGE_CONNECTION_STRING.

Property	Value
Parameter group:	Storage Account Arguments

--content-cache --content-cache-control

The cache control string.

--content-disposition

Conveys additional information about how to process the response payload, and can also be used to attach additional metadata.

--content-encoding

The content encoding type.

--content-language

The content language.

--content-md5

The content's MD5 hash.

--content-type

The content MIME type.

--if-match

An ETag value, or the wildcard character (*). Specify this header to perform the operation only if the resource's ETag matches the value specified.

Property	Value
Parameter group:	Precondition Arguments

--if-modified-since

A Commence only if modified since supplied UTC datetime (Y-m-d'T'H:M'Z').

Property	Value
Parameter group:	Precondition Arguments

--if-none-match

An ETag value, or the wildcard character (*). Specify this header to perform the operation only if the resource's ETag does not match the value specified.

Property	Value
Parameter group:	Precondition Arguments

--if-unmodified-since

A Commence only if unmodified since supplied UTC datetime (Y-m-d'T'H:M'Z').

Property	Value
Parameter group:	Precondition Arguments

--metadata

Metadata in space-separated key=value pairs. This overwrites any existing metadata.

--overwrite

Overwrite an existing file when specified.

Property	Value
Accepted values:	false, true

--permissions

--sas-token

A Shared Access Signature (SAS). Must be used in conjunction with storage account name or service endpoint. Environment variable: AZURE_STORAGE_SAS_TOKEN.

Property	Value
Parameter group:	Storage Account Arguments

--timeout

Request timeout in seconds. Applies to each call to the service.

--umask

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

Share via

az storage fs file

Commands

az storage fs file append

Examples

Required Parameters

Optional Parameters

az storage fs file create

Examples

Required Parameters

Optional Parameters

az storage fs file delete

Examples

Required Parameters

Optional Parameters

az storage fs file download

Examples

Required Parameters

Optional Parameters

az storage fs file exists

Examples

Required Parameters

Optional Parameters

az storage fs file list

Examples

Required Parameters

Optional Parameters

az storage fs file move

Examples

Required Parameters

Optional Parameters

az storage fs file set-expiry

Required Parameters

Optional Parameters

az storage fs file show

Examples

Required Parameters

Optional Parameters

az storage fs file upload

Examples

Required Parameters

Optional Parameters

Feedback