---
title: "API·暂停 DNS 解析记录"
description: "POST /api/v1/dns/record/pause 接口，暂停指定 DNS 解析记录使其停止解析但保留记录信息，与删除不同可随时通过启动接口恢复。"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.bt.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# API·暂停 DNS 解析记录

## 暂停解析记录

## 接口描述

暂停指定的 DNS 解析记录，暂停后该记录将停止解析，但记录信息会保留，可以随时恢复。

**接口地址：** `POST /api/v1/dns/record/pause`

:::info 说明
暂停记录与删除记录的区别：
- **暂停**：记录停止解析但信息保留，可恢复
- **删除**：记录完全移除，无法恢复
:::

## 输入参数

### 请求示例

```json
{
  "record_id": 9,
  "domain_type": 2,
  "domain_id": 1
}
```

### 请求参数

| 参数名称 | 必选 | 类型 | 描述 |
|---------|------|------|------|
| record_id | 是 | Integer | 记录 ID |
| domain_type | 是 | Integer | 域名类型：1（宝塔内部域名）、2（外部域名） |
| domain_id | 是 | Integer | 域名 ID |

## 输出参数

### 响应示例

**成功响应：**

```json
{
  "code": 0,
  "data": {},
  "msg": "暂停解析记录成功",
  "status": true
}
```

**错误响应：**

```json
{
  "code": 409,
  "msg": "记录已经是暂停状态",
  "status": false
}
```

### 响应参数

| 参数名称 | 类型 | 描述 |
|---------|------|------|
| code | Integer | 状态码，0 表示成功 |
| status | Boolean | 请求是否成功 |
| msg | String | 返回消息 |
| data | Object | 返回数据（空对象） |

Source: https://docs.bt.cn/domain/api/dns-records/pause-record/index.mdx