Ls Command

V4.0.2

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --with-wildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matters. The last matching filter decides whether a file is included or excluded. If the given list of filters contains only --include filters, then it is assumed that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--with-wildcard] [--include FILTERS] [--exclude FILTERS]
      [B2_URI]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --with-wildcard "b2://bucketName/*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --with-wildcard "b2://bucketName/b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --with-wildcard "b2://bucketName/b[0-9]/*.pdf"

List all buckets:

b2 ls

Required Capabilities

• listFiles
• listBuckets
  Required only if you do not provide the bucket name.

Positional Arguments

• B2_URI
  Points to a bucket, directory, file, or all buckets, for example, b2://yourBucket, b2://yourBucket/file.txt, b2://yourBucket/folderName/, b2id://fileId, or b2://.

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --with-wildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V4.0.1

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --with-wildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matte+med that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--with-wildcard] [--include FILTERS] [--exclude FILTERS]
      [B2_URI]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --with-wildcard "b2://bucketName/*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --with-wildcard "b2://bucketName/b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --with-wildcard "b2://bucketName/b[0-9]/*.pdf"

List all buckets:

b2 ls

Required Capabilities

• listFiles
• listBuckets
  Required only if you do not provide the bucket name.

Positional Arguments

• B2_URI
  Points to a bucket, directory, file, or all buckets, for example, b2://yourBucket, b2://yourBucket/file.txt, b2://yourBucket/folderName/, b2id://fileId, or b2://.

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --with-wildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V4.0.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --with-wildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matte+med that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--with-wildcard] [--include FILTERS] [--exclude FILTERS]
      [B2_URI]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --with-wildcard "b2://bucketName/*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --with-wildcard "b2://bucketName/b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --with-wildcard "b2://bucketName/b[0-9]/*.pdf"

List all buckets:

b2 ls

Required Capabilities

• listFiles
• listBuckets
  Required only if you do not provide the bucket name.

Positional Arguments

• B2_URI
  Points to a bucket, directory, file, or all buckets, for example, b2://yourBucket, b2://yourBucket/file.txt, b2://yourBucket/folderName/, b2id://fileId, or b2://.

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --with-wildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V3.19.1

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --with-wildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matte+med that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--with-wildcard] [--include FILTERS] [--exclude FILTERS]
      [bucketName] [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --with-wildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --with-wildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --with-wildcard bucketName "b[0-9]/*.pdf"

List all buckets:

b2 ls

Required Capabilities

• listFiles
• listBuckets
  Required only if you do not provide the bucket name.

Positional Arguments

• bucketName
  The target bucket's name.
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --with-wildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V3.19.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --with-wildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matte+med that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--with-wildcard] [--include FILTERS] [--exclude FILTERS]
      [bucketName] [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --with-wildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --with-wildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --with-wildcard bucketName "b[0-9]/*.pdf"

List all buckets:

b2 ls

Required Capabilities

• listFiles
• listBuckets
  Required only if you do not provide the bucket name.

Positional Arguments

• bucketName
  The target bucket's name.
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --with-wildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V3.18.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --with-wildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matte+med that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--with-wildcard] [--include FILTERS] [--exclude FILTERS]
      [bucketName] [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --with-wildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --with-wildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --with-wildcard bucketName "b[0-9]/*.pdf"

List all buckets:

b2 ls

Required Capabilities

• listFiles
• listBuckets
  Required only if you do not provide the bucket name.

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --with-wildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V3.17.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matte+med that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--withWildcard] [--include FILTERS] [--exclude FILTERS]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --withWildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V3.16.1

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matte+med that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--withWildcard] [--include FILTERS] [--exclude FILTERS]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --withWildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V3.16.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

You can use the --include and --exclude parameters to filter the files that are returned from the server using wildcards. You can specify multiple --include and --exclude filters. The order of filters matte+med that all of the files are excluded by default.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--withWildcard] [--include FILTERS] [--exclude FILTERS]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --withWildcard
  Default: False
• --include
  Default: []
• --exclude
  Default: []

V3.15.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --withWildcard
  Default: False

V3.14.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --withWildcard
  Default: False

V3.13.1

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --withWildcard
  Default: False

V3.13.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [-r]
      [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• -r, --recursive
  Default: False
• --withWildcard
  Default: False

V3.12.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--long] [--json] [--replication] [--versions] [--recursive]
      [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• --recursive
  Default: False
• --withWildcard
  Default: False

V3.9.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--profile PROFILE] [--long] [--json] [--replication] [--versions]
      [--recursive] [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --profile
• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• --recursive
  Default: False
• --withWildcard
  Default: False

V3.8.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--profile PROFILE] [--long] [--json] [--replication] [--versions]
      [--recursive] [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --profile
• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• --recursive
  Default: False
• --withWildcard
  Default: False

V3.7.1

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--profile PROFILE] [--long] [--json] [--replication] [--versions]
      [--recursive] [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --profile
• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• --recursive
  Default: False
• --withWildcard
  Default: False

V3.7.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --replication parameter adds a replication status.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --withWildcard parameter allows using *, ?, and `[]` characters in folderName as a greedy wildcard, single-character wildcard, and range of characters. It requires the --recursive parameter. You should quote folderName to avoid shell expansion.

b2 ls [-h] [--profile PROFILE] [--long] [--json] [--replication] [--versions]
      [--recursive] [--withWildcard]
      bucketName [folderName]

Examples

List csv and tsv files (in any directory, in the whole bucket):

b2 ls --recursive --withWildcard bucketName "*.[ct]sv"

List all info.txt files from directories named b?, where ? is any character:

b2 ls --recursive --withWildcard bucketName "b?/info.txt"

List all pdf files from directories b0 to b9 (including sub-directories):

b2 ls --recursive --withWildcard bucketName "b[0-9]/*.pdf"

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --profile
• --long
  Default: False
• --json
  Default: False
• --replication
  Default: False
• --versions
  Default: False
• --recursive
  Default: False
• --withWildcard
  Default: False

V3.6.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --replication parameter adds a replication status.

b2 ls [-h] [--profile PROFILE] [--long] [--json] [--versions] [--recursive]
      [--replication]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --profile
• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False
• --replication
  Default: False

V3.5.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --replication parameter adds a replication status.

b2 ls [-h] [--profile PROFILE] [--long] [--json] [--versions] [--recursive]
      [--replication]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --profile
• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False
• --replication
  Default: False

V3.4.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

The --replication parameter adds a replication status.

b2 ls [-h] [--profile PROFILE] [--long] [--json] [--versions] [--recursive]
      [--replication]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --profile
• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False
• --replication
  Default: False

V3.3.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--profile PROFILE] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --profile
• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V3.2.1

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V3.2.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V3.1.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V3.0.3

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V3.0.2

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V3.0.1

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V3.0.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V2.5.1

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V2.5.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V2.4.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V2.3.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V2.2.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False

V2.1.0

Using the file naming convention that / separates folder names from their contents, this command returns a list of the files and folders in a given folder. If no folder name is provided, it lists all of the files at the top level.

The --long parameter produces a wide, multi-column output that shows the upload date/time, file name, file size, file ID, and whether it is an uploaded file or a hidden file. Folders do not really exist in Backblaze B2 Cloud Storage, so folders are shown with - in each of the fields other than the name.

The --json parameter produces a machine-readable output that is similar to the server API response format.

The --versions parameter selects all of the versions of each file, and not just the most recent version.

The --recursive parameter descends into folders, and selects only files (not folders).

b2 ls [-h] [--long] [--json] [--versions] [--recursive]
      bucketName [folderName]

Required Capabilities

• listFiles

Positional Arguments

• bucketName
• folderName

Named Arguments

• --long
  Default: False
• --json
  Default: False
• --versions
  Default: False
• --recursive
  Default: False