RestoreUserZoneBackup-回滚解析记录到指定备份--TrafficRoute DNS 套件-火山引擎

文档中心

立即注册

导航

TrafficRoute DNS 套件

RestoreUserZoneBackup-回滚解析记录到指定备份

最近更新时间：2024.07.01 20:49:07首次发布时间：2023.04.25 21:24:23

把一个域名中的解析记录回滚到指定的备份。

说明

如果备份使用的自定义线路或线路分组已经被删除，则回滚会失败。参见什么是自定义线路和什么是线路分组。
如果备份使用了超出您的域名当前的功能版本规格的功能，那么超出当前功能版本规格的解析记录不可变更。例如，您的域名的当前功能版本是旗舰版，备份中的解析记录使用了符合尊享版规格，但超出旗舰版规格的参数。在这种情况下，回滚会成功。但是，您无法变更超出当前功能版本规格的解析记录。关于不同功能版本的规格限制，参见功能版本规格。
如果备份的 DNSSEC 状态与当前的 DNSSEC 状态不同，回滚时会保留当前的 DNSSEC 状态不变。

使用说明

请求频率：每秒最多调用 1 次。
仅功能版本是旗舰版或尊享版的域名才支持解析记录备份功能。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=RestoreUserZoneBackup&Version=2018-08-01

请求参数

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

Query

名称	类型	是否必选	示例值	描述
Action	String	是	`RestoreUserZoneBackup`	API 的名称。该参数的取值是 `RestoreUserZoneBackup`。
Version	String	是	`2018-08-01`	API 的版本。该参数的取值是 `2018-08-01`。

Body

名称	类型	是否必选	示例值	描述
ZID	Integer	是	`33279`	需要回滚解析记录的域名的 ID。您可以调用 ListZones API 获取域名 ID。
BackupID	String	是	`MjAyMy0wNC0xMyAxMjowNDozNF8y`	需要回滚到的备份的 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
    }
}

错误码

您可访问公共错误码，获取详细信息。