{"id":111495,"date":"2024-08-20T09:00:00","date_gmt":"2024-08-20T16:00:00","guid":{"rendered":"https:\/\/www.backblaze.com\/blog\/?p=111495"},"modified":"2024-08-20T03:03:58","modified_gmt":"2024-08-20T10:03:58","slug":"command-like-a-pro-with-new-backblaze-b2-cli-enhancements","status":"publish","type":"post","link":"https:\/\/www.backblaze.com\/blog\/command-like-a-pro-with-new-backblaze-b2-cli-enhancements\/","title":{"rendered":"Command Like a Pro with New Backblaze B2 CLI Enhancements"},"content":{"rendered":"\n
\"An<\/figure>\n\n\n\n
<\/div>\n\n\n\n

The tools you use impact your efficiency, productivity, and the quality of your work. That\u2019s true whether you\u2019re a carpenter looking for the best saw blades, a chef choosing high-quality knives, or a developer or programmer investing in top-notch software. The B2 Command Line Interface (CLI) is one tool that you can use to interact with B2 Cloud Storage, and some recent improvements make it a more powerful, intuitive part of your arsenal. <\/p>\n\n\n\n

It’s been a while since our last blog<\/a> about the Backblaze B2 Command Line Tool<\/a> (B2 CLI for short). Today, we\u2019re sharing more details on the key enhancements and new features as part of the B2 CLI version 4.1.0.<\/p>\n\n\n\n

Let’s dive into the highlights of these changes and explore how they can elevate your B2 CLI experience.<\/p>\n\n\n\n

User experience enhancements<\/h2>\n\n\n\n

1. A new nested command structure<\/h3>\n\n\n\n

Gone are the days of sifting through a long list of commands to find what you need. The B2 command structure has been revamped to be more intuitive and organized. With the new nested command structure, related commands are logically grouped together. The new structure looks like b2 <resource><\/code>. It makes it easier for you to locate and utilize the functionality you require. Whether you\u2019re managing files, buckets, keys, or accounts, commands are now categorized in a way that aligns with their functions. This gives you a clearer and more concise enhanced user experience.<\/p>\n\n\n

\n
\"An
New command structure.<\/figcaption><\/figure>\n<\/div>\n\n\n

2. Streamlined ls<\/code> and rm<\/code> commands<\/h3>\n\n\n\n

Why use two when one will do? The b2 ls <\/code>and b2 rm<\/code> commands can now accept a single cohesive string, B2 URI (e.g., b2:\/\/bucketName\/path<\/code>), instead of two separate positional arguments, giving you enhanced consistency and usability. It simplifies the command syntax and reduces potential for errors by eliminating the chance of misplacing or mistyping one of the separate arguments. And it ensures that the bucket and file path are always correctly associated with each other. This change minimizes confusion and helps to avoid common mistakes that can occur with multiple arguments.<\/p>\n\n\n\n

In addition, some commands, such as b2 file large parts<\/code>, accept a B2 ID URI (e.g. b2id:\/\/4_zf1f51fb<\/code>\u2026), which specifies a file by its unique identifier (a.k.a. Fguid<\/a>).<\/p>\n\n\n\n

Some redundant commands have also been deprecated with the introduction of the B2 and B2 URIs. For example: download-file-by-id<\/code> and download-file-by-name<\/code> functionality is available through b2 file download b2:\/\/bucketname\/path and b2 file download b2id:\/\/fileid<\/code> command.<\/p>\n\n\n\n

3. Enhanced credential management<\/h3>\n\n\n\n

To enhance security and performance, the CLI will no longer persist credentials on disk if they are passed through B2_*<\/code> environment variables (that is, B2_application_key_id<\/code> and B2_application_key<\/code>). This reduces the risk of unauthorized access to your credentials and improves the overall security of your environment.<\/p>\n\n\n\n

At the same time, it\u2019s important that security is balanced with performance. To address this, you can persist your credentials to local cache and can continue using local cache for better performance. You can explicitly choose to persist your credentials by using the b2 account authorize<\/code> command. <\/p>\n\n\n\n

By eliminating the automatic persistence of credentials from environment variables and providing a clear method to manage local caching, you now have a balanced approach that keeps your data secure while ensuring efficient CLI operations.<\/p>\n\n\n\n

4. Transition to kebab-case flags<\/h3>\n\n\n\n

Previously CLI flags had mixed camelCase and kebab-case styles. Users needed to remember the style to use it along with the name for the option. But kebab-case, where words are separated by hyphens (e.g., --my-flag<\/code>), offers a clearer and more straightforward way to read and interpret flags. We\u2019ve transitioned all CLI flags to --kebab-case<\/code>. This style not only enhances readability, making it easier to understand complex commands at a glance, but also makes it easy to remember. It\u2019s particularly beneficial when flags are composed of multiple words, as it reduces visual clutter and makes the flag names more accessible.<\/p>\n\n\n\n

5. Simplified listing with ls<\/code><\/h3>\n\n\n\n

Ever wondered how to list all your buckets in one go? Now, you can call b2 ls<\/code> without any arguments to do this. Whether you\u2019re managing multiple buckets or just need a quick overview of your entire bucket inventory, the ability to list all buckets with a single command saves you time and effort. The enhancement to the b2 ls<\/code> command is all about making your life easier. (As an aside, it\u2019s also the quickest way to check that Backblaze B2 is correctly configured and you\u2019re using the right set of credentials.)<\/p>\n\n\n\n

6. Handy aliases for common flags<\/h3>\n\n\n\n

Why go the long way when you can take shortcuts? You can now use -r<\/code> as an alias for the --recursive<\/code> argument and -q<\/code> for the --quiet<\/code> argument. These shortcuts make your command-line interactions quicker and more efficient. You can get things done with fewer presses.<\/p>\n\n\n\n

7. Global quiet mode<\/h3>\n\n\n\n

The --quiet<\/code> option is now available for all commands, allowing you to suppress all messages printed to stdout and stderr. This is particularly useful for scripting and automation, where you want to minimize output.<\/p>\n\n\n\n

8. Autocomplete<\/h3>\n\n\n\n

This enhancement for the B2 CLI means that you no longer have to remember and type out lengthy command arguments or options manually. As you start typing a command, the CLI will provide you with suggestions for completing the command, options, and arguments based on the context of your input. This can significantly save up your time and help you avoid typos or incorrect entries.<\/p>\n\n\n\n

New features to boost your productivity<\/h2>\n\n\n\n

In addition to the CLI enhancements, we\u2019ve also recently announced a few new features and capabilities for Backblaze B2, including:<\/p>\n\n\n\n