# list

The cldkctl guard list command retrieves a list of all Guards in your project. This command displays essential details such as the guard name, namespace, and timestamps of creation and last update.

## Usage

```
cldkctl guard list [flags]
```

## Aliases

```
list, ls
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal:

```
cldkctl guard list
```

2. Wait a few seconds while the system retrieves the list of Guards.
3. Review the output displayed in the terminal, which includes columns such as Namespace, Name, Created At, and Updated At.

<figure><img src="/files/xzUYIuU8BKqqXT8WYBuo" alt=""><figcaption></figcaption></figure>

| Column     | Description                                                                   |
| ---------- | ----------------------------------------------------------------------------- |
| Namespace  | Displays the Kubernetes namespace where the Guard is deployed.                |
| Name       | The unique name of the Guard resource within the namespace.                   |
| Created At | The timestamp showing when the Guard was initially created.                   |
| Updated At | The timestamp showing the last modification time for the Guard configuration. |

## Flags

{% hint style="info" %}
This command supports global flags. Refer to the Global Flags section for details
{% endhint %}

| Flag               | Description                                         |
| ------------------ | --------------------------------------------------- |
| -h, --help         | Help for the guard list command.                    |
| -l, --limit string | Specify the number of results per page (default 10) |
| -h, --page string  | Specify the page number (default 1)                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-guard/list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
