# 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="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2Fm6psiSMRvEefmF29YBbo%2Funknown.png?alt=media&#x26;token=3e0603bd-d553-4aad-9d1c-486a7c45e2e0" 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](https://docs.cloudeka.ai/cloudeka-api-list/global-flags). 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")                  |