You need to enable JavaScript to run this app.
导航
TrafficRoute DNS 套件
  • 文档首页
    • /
  • TrafficRoute DNS 套件

回滚解析记录到指定备份

最近更新时间：2023.12.06 10:39:31

首次发布时间：2023.04.25 21:24:23

我的收藏

API 说明

API 名称：RestoreUserZoneBackup。
API 域名：open.volcengineapi.com。
API 描述：把指定域名中的解析记录回滚到指定的备份。

警告

由于备份中的解析记录和回滚前的解析记录存在差异，回滚之后，解析记录所在的域名访问可能会受到影响。该操作无法撤销。您需要谨慎操作。

说明

  • 如果备份使用的自定义线路已经被删除，则回滚会失败。
  • 假设您的域名的功能版本从尊享版降级到旗舰版，您需要回滚到的备份所使用的功能版本是尊享版。备份中的解析记录使用了符合尊享版规格，但超出旗舰版规格的参数。在这种情况下，回滚会成功。但是，您无法对再次编辑超出规格的解析记录。关于不同功能版本的规格限制，参见 功能版本规格。

请求方法

POST

调用限制

  • 每秒最多调用 1 次。
  • 只有当您的域名的 版本规格 是旗舰版或尊享版时，您才能调用该 API。

请求参数

除了以下参数，您还需要 对请求进行鉴权。

参数名称
数据类型参数类型是否必选参数说明
ActionString查询参数是API 的名称。该参数的取值是 RestoreUserZoneBackup。
VersionString查询参数是API 的版本。该参数的取值是 2018-08-01。
ZIDInteger请求正文参数是需要回滚解析记录的域名的 ID。您可以调用 ListZones API 获取域名 ID。
BackupIDString请求正文参数是需要回滚到的备份的 ID。您可以调用 ListUserZoneBackups API 获取备份 ID。

响应正文

ResponseMetadata 对象

参数名称
数据类型
参数说明
RequestId
String
标识本次请求的 ID。
Action
String
Action 查询参数的值。
Version
String
API 版本。
Service
String
服务类型。
Region
String
服务所在区域。

Result 对象

参数名称
数据类型
参数说明
TotalRecord
Integer
备份中解析记录的总数。

示例

请求示例

POST https://open.volcengineapi.com?Version=2018-08-01&Action=RestoreUserZoneBackup&Version=2018-08-01

{
  "ZID": 33279,
  "BackupID": "MjAyMy0wNC0xMyAxMjowNDozNF8y"
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "202304131450057EC1C26718C36F4985EC",
        "Action": "RestoreUserZoneBackup",
        "Version": "2018-08-01",
        "Service": "dns",
        "Region": "cn-north-1"
    },
    "Result": {
        "TotalRecord": 2
    }
}