> 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-dns/record-list.md).

# record-list

The dns record-list command manages DNS records within DNS zones. This command allows listing, adding, updating, and deleting DNS records.

## Usage

```
cldkctl dns record-list [id] [flags]
```

## Steps

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

1. Run the following command in your terminal:

```
cldkctl dns record-list [dns-zone-id]
```

2. To limit the number of displayed results, specify the limit flag:

```
cldkctl dns record-list [dns-zone-id] --limit [number]
```

3. To view additional results, use the page flag:

```
cldkctl dns record-list [dns-zone-id] --page [page-number]
```

4. Replace `[dns-zone-id]` with the ID of the DNS zone. Refer to dns list section to obtain the DNS zone ID.
5. The terminal displays a table containing the list of DNS records along with their details, including record type, name, content, and TTL values.

<figure><img src="/files/5HF6HVgKNQP3L6ZXWizt" alt=""><figcaption></figcaption></figure>

| Column  | Description                                   |
| ------- | --------------------------------------------- |
| ID      | Unique identifier of each DNS record.         |
| Type    | The DNS record type.                          |
| Name    | The record name associated with the DNS zone. |
| Content | The record value or target address.           |
| TTL     | Time-To-Live value of the DNS record.         |

## 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 dns record list command.                  |
| -l, --limit string | Specify number of results per page (default "10"). |
| -p, --page string  | Specify page number (default "1")                  |