Upload-file command¶
Uploads one file to the given bucket. Uploads the contents of the local file, and assigns the given name to the B2 file.
By default, upload_file will compute the sha1 checksum of the file to be uploaded. But, if you already have it, you can provide it on the command line to save a little time.
Content type is optional. If not set, it will be set based on the file extension.
By default, the file is broken into as many parts as possible to
maximize upload parallelism and increase speed. The minimum that
B2 allows is 100MB. Setting --minPartSize
to a larger value will
reduce the number of parts uploaded when uploading a large file.
The maximum number of upload threads to use to upload parts of a large file
is specified by --threads
. It has no effect on small files (under 200MB).
Default is 10.
If the tqdm
library is installed, progress bar is displayed
on stderr. Without it, simple text progress is printed.
Use --noProgress
to disable progress reporting.
Each fileInfo is of the form a=b
.
To request SSE-B2 encryption for destination files,
please set --destinationServerSideEncryption=SSE-B2
.
The default algorithm is set to AES256 which can by changed
with --destinationServerSideEncryptionAlgorithm
parameter.
Requires capability:
writeFiles
b2 upload-file [-h] [--noProgress] [--quiet] [--contentType CONTENTTYPE]
[--minPartSize MINPARTSIZE] [--sha1 SHA1] [--threads THREADS]
[--info INFO] [--destinationServerSideEncryption {SSE-B2}]
[--destinationServerSideEncryptionAlgorithm {AES256}]
bucketName localFilePath b2FileName
Positional Arguments¶
- bucketName
- localFilePath
- b2FileName
Named Arguments¶
- --noProgress
Default: False
- --quiet
Default: False
- --contentType
- --minPartSize
- --sha1
- --threads
Default: 10
- --info
Default: []
- --destinationServerSideEncryption
Possible choices: SSE-B2
- --destinationServerSideEncryptionAlgorithm
Possible choices: AES256
Default: “AES256”