https://github.com/faesel/az-lazy
Az Lazy CLI tool is designed for developers, it provides a command-line interface to quickly manage and make changes to azure storage queues, blobs and tables.
https://github.com/faesel/az-lazy
azure azure-storage azure-storage-queues blob blobs cli containers queues tablestorage
Last synced: 6 months ago
JSON representation
Az Lazy CLI tool is designed for developers, it provides a command-line interface to quickly manage and make changes to azure storage queues, blobs and tables.
- Host: GitHub
- URL: https://github.com/faesel/az-lazy
- Owner: faesel
- Created: 2020-10-12T08:03:58.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-02-24T16:40:55.000Z (over 3 years ago)
- Last Synced: 2025-11-27T13:35:12.618Z (7 months ago)
- Topics: azure, azure-storage, azure-storage-queues, blob, blobs, cli, containers, queues, tablestorage
- Language: C#
- Homepage:
- Size: 727 KB
- Stars: 8
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
AzLazy CLI tool is designed for developers, it provides a command line interface to quickly manage and make changes to azure storage queues, blobs and tables. The inspiration for this project was to move away from using Azure Storage Manager and provide a faster CLI experience for developers.
# Table of Contents
1. [Installation](#installation)
2. [Getting started](#gettingstarted)
3. [Command list](#commandlist)
1. [Connection Commands](#connectioncommand)
2. [Queue Commands](#queuecommand)
3. [Container Commands](#containercommand)
4. [Blob Commands](#blobcommand)
4. [Table Commands](#tablecommand)
4. [Contributing](#contributing)
5. [Change Log](#changelog)
You can download the tool from the [Nuget Gallery](https://www.nuget.org/packages/az-lazy/), run the following installation command,
`dotnet tool install --global az-lazy`
Use the following command to add a new connection
`azlazy addconnection --name "dinosaurStorage" --connectionString "<>"`
Select the connection you want to use
`azlazy connection --select "dinosaurStorage"`
You can check which connection is selected using the list command, by default you will always have **devStorage** which allows you to connect to a local Azure emulator
`azlazy connection --list`
Once a connection has been added you can begin using all the other commands, eg
`azlazy queue --list`
`azlazy queue --watch "process-carnivores"`
`azlazy queue --peek "process-carnivores" --peekCount 3`
`azlazy addcontainer --name "dinosaurpictures" --publicAccess "Blob"`
`azlazy container --tree "dinofiles" --detailed`
`azlazy blob --container "dinofiles" --uploadDirectory "C:\Users\faese\Desktop\dinofiles"`
To view a list of commands through the CLI you can use `azlazy --help`, each command has an alias beginning with the first letter of the command, eg `azlazy connection --list` can be aliased to `azlazy connection -l`.
| Command | Description |
|--------------|:-------------|
| `azlazy connection --help` | Display a list of commands you can use for connections |
| `azlazy addconnection --name "name of connection" --connectionstring "connection string"` | Adds a new connection to the connection list.
- `--select true` The select option allows you to select the connection when inserting
| `azlazy connection --list` | Show a list of connections available, the selected connection will be highlighted with a `[*]` symbol |
| `azlazy connection --remove "name of connection"` | Removes a connection from the connections list |
| `azlazy connection --select "name of connection"` | Selects a connection from the connections list |
| `azlazy connection --wipe` | Removes all connections from the list, aside from the development connection |
| Command | Description |
|--------------|:-------------|
| `azlazy queue --help` | Display a list of commands you can use for queues |
| `azlazy addqueue --name "queue to add"` | Creates a new queue with the given name |
| `azlazy queue --list` | View a list of queues in the storage account along with the number of messages they are holding, poison queues are highlighted in red.
- `--contains` can also be used to filter the list
| `azlazy queue --remove "queue to remove"` | Removes the queue with the given name |
| `azlazy queue --cure "queue to move poison messages to"` | Moves poison queue messages back into the processing queue |
| `azlazy queue --clear "queue to clear"` | Removes all messages in the queue |
| `azlazy queue --addQueue "queue to add a new message" --addMessage '{ \"test\": true }'` | Adds a new message to the queue |
| `azlazy queue --watch "queue to watch"` | Watches a queue for new messages |
| `azlazy queue --peek "queue to peek messages"` | Views a messages in the queue, note this function peeks messages so visibility is not changed for consuming applications.
- `--peekCount 10` can also be used to specify how many messages you want to view. The Maximum peek count available is 32.
| `azlazy queue --from "source queue name" --to "destination queue name"` | Moves queue messages from the source queue to a destination queue |
## iii. Container commands
| Command | Description |
|--------------|:-------------|
| `azlazy container --help` | Displays a list of commands you can use for containers |
| `azlazy container --list` | View a list of containers in the storage account, along with whether or not its public and when it was last modified.
- `--contains` can also be used to filter the list
| `azlazy addcontainer --name "container to add" --publicAccess "Blob"` | Creates a new container with the given name. By default any container created will not be publicly accessible and so will have its public access level set to `None`,
- `--publicAccess` the containers public access level can be set using this command. Possible options are `None`, `Blob`, `BlobContainer`
| `azlazy container --remove "container to remove"` | Removes a container with the given game |
| `azlazy container --tree "container to view"` | Returns a tree view of the container, other options with this command include,
- `--detailed` Command can also be used to view file sizes and last modified dates
- `--depth 2` For large containers this command can be used to limit how deep the folders are traversed
- `--prefix` Command can be used to limit the results returned by searching within a prefixed path
| Command | Description |
|--------------|:-------------|
| `azlazy blob --help` | Displays a list of commands you can use for blobs |
| `azlazy blob --container "container name" --remove "blob to remove"` | removes a blob from a given container, note the blob name needs to contain the full path |
| `azlazy blob --container "container name" --uploadFile "c:\dinofiles\safaripics\t-rex.png" --uploadPath "safaripics"` | Uploads a blob from a given path to the container. In the example given the file `t-rex.png` will be uploaded to `safaripics\t-rex.png` if no upload path is provided the file will be uploaded to the root of the container.
- `--uploadPath` can also be optionally specified to copy the files into a subdirectory.
| `azlazy blob --container "container name" --uploadDirectory "c:\dinofiles" --uploadPath "safaripics"` | Upload all the files in a given directory to a container. When uploading, the folder structure of of the directory is reflected into the container.
- `--uploadPath` can also be optionally specified to copy the files into a subdirectory.
| Command | Description |
|--------------|:-------------|
| `azlazy table --help` | Displays a list of commands you can use for tables |
| `azlazy table --list` | View a list of tables in the storage account.
- `--contains` can also be used to filter the list
| `azlazy table --sample "table name"` | Samples the data from a table, by default 10 rows will be selected.
- `--sampleCount 30` can also be used to set how many rows should be returned
| `azlazy table --query "table name"` | Query's rows in a table, the filters specified below can be used in combination with each other. If no filters are specified all rows in the table will be returned.
- `--partitionKey` used to query by the partition key
- `--rowKey` used to query by the row key
- `--take 10` allows you to limit how many rows are returned
| `azlazy table --delete "table name"` | Removes rows from a table, to use this command one of the filters mentioned below must be used.
- `--partitionKey` delete using the partition key
- `--rowKey` delete using the row key |
| `azlazy table --remove "table name"` | Removes the entire table from storage |
| `azlazy addtable --name "table name"` | Creates a new table with the given table name |
More coming soon !
I haven't written any contributing guidelines yet but you can reach me here on [Faesel.com contact page](https://www.faesel.com/contact). [Development Notes](documentation/contributing.md) are also available.
For older versions check the change log [here](documentation/legacyversionhistory.md), for newer versions check out the [releases page](https://github.com/faesel/az-lazy/releases).
# 6. Future changes
- Explore adding connections and commands for Azure Storage Bus