> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/guidance-for-enterprise/cloudeka-api-list/command-reference/cldkctl-get/role.md).

# role

The get role command retrieves a list of Roles in the Kubernetes cluster.

This command provides details such as role names, associated rules, and permissions granted to users or service accounts.

## Usage

```
cldkctl get role [flags]
```

## Steps

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

1. Open your terminal in the directory where the cldkctl binary is located.
2. Run the following command in your terminal:

```
cldkctl get role
```

3. The command will display a list of Roles within the current namespace, including their names and creation dates.

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

| Column     | Description                                         |
| ---------- | --------------------------------------------------- |
| Name       | Displays the name of each Role in the cluster.      |
| Namespace  | The Kubernetes namespace where the Role is defined. |
| Created At | Shows the date when the Role was created.           |

## Flags

{% hint style="info" %}
This command supports[ global flags. ](/guidance-for-enterprise/cloudeka-api-list/global-flags.md)Refer to the Global Flags section for details
{% endhint %}

| Flag       | Description                |
| ---------- | -------------------------- |
| -h, --help | Help for get role command. |

<br>