# Azion CLI list

With the `azion list [resource]` command you can list your:

- [Applications](#applications).
    - [Functions](#functions).
    - [Rules engine](#rules-engine).
    - [Cache settings](#cache-settings).
    - [Workloads](#workloads).
    - [Connectors](#origins).
    - [Variables](#variables).
    - [Personal tokens](#personal-tokens).
    - [Object Storage bucket](#object-storage-bucket).
    - [Object Storage object](#object-storage-object).
    - [WAF](#waf).
    - [WAF exceptions](#waf-exceptions).

:::note 
In case one or more required fields aren't informed through the specific flags, an interactive message prompts and asks for the missing information.
:::

---

## Applications

#### Usage

```bash
azion list edge-application [flags]
```

#### Optional flags

##### details

The `--details` flag displays all relevant fields when listing.

##### page

The `--page` option returns a page of the list according to its number. By default, it's `1`.

##### page_size

The `--page_size` option defines how many items should be returned per page. By default, it's `10`.

##### help

The `--help` option displays more information about the `azion list edge-application` action.

---

## Functions

#### Usage

```bash
azion list edge-function 
```

#### Optional flags

##### details

The `--details` flag displays all relevant fields when listing.

##### filter

The `--filter` flag filters items by their name.

##### order-by

The `--order-by` flag sorts the output based on the selected field.

##### page

The `--page` flag returns a page of the list according to its number. Default is `1`.

##### page-size

The `--page-size` flag defines how many items should be returned per page. Default is `10`.

##### sort

The `--sort` flag defines the order of the items on the list. The value should be either `asc` or `desc`.

##### help

The `--help` option displays more information about the `azion list edge-function` command.

---

## Rules engine

#### Usage

```bash
azion list rules-engine --application-id <application-id> --phase <phase>
```

#### Required flags

##### application-id

The `--application-id` flag specifies the unique identifier for the application that implements these rules.

##### phase

The `--phase` flag specifies the Rules Engine phase. It's either `request` or `response`.

#### Optional flags

##### details

The `--details` flag displays all relevant fields when listing.

##### filter

The `--filter` flag filters items by their name.

##### order-by

The `--order-by` flag sorts the output based on the selected field.

##### page

The `--page` flag returns a specific page of the list according to its number. By default, it's `1`.

##### page-size

The `--page-size` flag defines how many items should be returned per page. By default, it's `10`.

##### sort

The `--sort` flag defines the order of the items on the list and can be set to either `asc` or `desc`.

##### help

The `-h` or `--help` flag displays more information about the `azion list rules-engine` command.

---


## Cache settings

#### Usage

```bash
azion list cache-setting --application-id 16736354321
```

#### Optional flags

##### application-id

The `--application-id` flag sets the unique identifier for the application.

##### details

The `--details` flag displays all relevant fields when listing.

##### filter

The `--filter` option filters items by their name.

##### help

The `--help` option displays more information about the `azion list cache-setting` command.

##### order-by

The `--order-by` option sorts the output based on the selected field.

##### page

The `--page` option returns a page of the list according to its number. The default value is `1`.

##### page-size

The `--page-size` option defines how many items should be returned per page. The default value is `10`.

##### sort

The `--sort` option defines the order of the items on the list. The value should be either `asc` or `desc`.

---


## Workloads

#### Description

Displays all your domains.

#### Usage

```bash
azion list domain
```

#### Optional flags

##### details

The `--details` option displays all relevant fields when listing.

##### filter

The `--filter` option filters items by their name.

##### order-by

The `--order-by` option sorts the output based on the selected field.

##### page

The `--page` option returns a specific page of the list according to its number. The default is `1`.

##### page-size

The `--page-size` option defines how many items should be returned per page. The default is `10`.

##### sort

The `--sort` option defines the order of the items on the list. Options are `asc` or `desc`.

##### help

The `-h` or `--help` option displays more information about the `azion list domain` command.

---

## Connectors

#### Usage

```bash
azion list origin --application-id <application-id>
```

#### Required flags

##### application-id

The `--application-id` flag sets the unique identifier for the application. It's a required field.

#### Optional flags

##### details

The `--details` flag displays all relevant fields when listing origin.

##### filter

The `--filter` flag filters items by their name.

##### order-by

The `--order-by` flag sorts the output based on the selected field.

##### page

The `--page` flag returns a specific page of the list according to its number. The default is `1`.

##### page-size

The `--page-size` flag defines how many items should be returned per page. The default is `10`.

##### sort

The `--sort` flag defines the order of the items on the list. The value should be either `asc` or `desc`.

#### help

The `-h` or `--help` option displays more information about the `azion list origin` action.

---

## Variables

#### Usage

```bash
  azion list variables
```

#### Optional flags

##### details

The `--details` option displays all relevant fields when listing.

##### help

The `--help` option displays more information about the `list` subcommand.

---

## Personal tokens

#### Usage

```sh
azion list personal-token [flags]
```

#### Optional flags

##### details

The `--details` option displays all relevant fields when listing.

##### help

The `--help` option displays more information about the `list` subcommand.

--- 

## Object Storage bucket

#### Usage

```bash
azion list edge-storage bucket
```

#### Flags

#### Optional flags

##### page

The `--page` option returns a page from the list according to its number. The default is `1`.

##### page size

The `--page-size` option defines how many items should return per page. The default is `10`.

##### help

The `--help` option displays more information about the 'list edge-storage bucket' command.

---

## Object Storage object

#### Usage

```bash
azion list edge-storage object --bucket-name 'balde'
azion list edge-storage object --page 1 --page-size 3 --details
azion list edge-storage object --help
```

#### Required flags

##### bucket-name

The `--bucket-name` flag specifies the name of the Object Storage bucket whose objects you want to list.

#### Optional flags 

##### details

The `--details` option outputs all relevant fields when listing objects in Object Storage.

##### help

The `-h` or `--help` option displays more detailed information about the `azion list edge-storage object` command.

##### page-size

The `--page-size` option defines how many items should be returned per page. The default value is `50`.

---

## WAF

Lists all WAFs (Web Application Firewalls).

#### Usage

```bash
azion list waf [flags]
```

#### Optional flags

##### details

The `--details` flag displays all relevant fields when listing.

##### filter

The `--filter` flag filters items by their name.

##### order-by

The `--order-by` flag sorts the output based on the selected field.

##### page

The `--page` flag returns a specific page of the list according to its number. By default, it's `1`.

##### page-size

The `--page-size` flag defines how many items should be returned per page. By default, it's `10`.

##### sort

The `--sort` flag defines the order of the items on the list. The value should be either `asc` or `desc`.

##### help

The `--help` flag displays more information about the `azion list waf` command.

---

## WAF exceptions

Lists all WAF exceptions for a given WAF.

#### Usage

```bash
azion list waf-exceptions --waf-id <waf-id> [flags]
```

#### Required flags

##### waf-id

The `--waf-id` flag specifies the unique identifier of the WAF.

#### Optional flags

##### details

The `--details` flag displays all relevant fields when listing.

##### filter

The `--filter` flag filters items by their name.

##### order-by

The `--order-by` flag sorts the output based on the selected field.

##### page

The `--page` flag returns a specific page of the list according to its number. By default, it's `1`.

##### page-size

The `--page-size` flag defines how many items should be returned per page. By default, it's `10`.

##### sort

The `--sort` flag defines the order of the items on the list. The value should be either `asc` or `desc`.

##### help

The `--help` flag displays more information about the `azion list waf-exceptions` command.