更改域名的 DNS 服务器--域名服务-火山引擎

文档中心

立即注册

导航

更改域名的 DNS 服务器

最近更新时间：2024.09.24 16:39:10首次发布时间：2023.07.12 10:31:46

API 说明

API 名称：ModifyDomainNS
API 域名：open.volcengineapi.com
API 描述：更改一个域名的 DNS 服务器。

请求方法

POST

使用限制

节流限制：您每秒最多可以发送 20 个请求。

请求鉴权

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见请求鉴权。

公共参数

在调用该 API 时，您在请求中必须包含公共参数。在这些公共参数中，以下两个查询参数的取值说明如下：

参数名称	数据类型	必选	参数说明
Action	string	是	表示 API 的名称。该参数的取值是 `ModifyDomainNS`。
Version	string	是	表示 API 的版本。该参数的取值是 `2022-12-12`。

请求参数

该 API 的请求参数的类型是请求正文参数。

参数名称	数据类型	必选	参数说明	示例
domain	string	是	表示需要更改名称服务器的一个域名。	`example.com`
ns_list	[]string	是	表示 DNS 服务器的列表。该列表需要包含 2－6 个服务器。	`["ns1.volcengine-dns.com","ns2.volcengine-dns.com"]`

响应正文

无

示例

请求示例

POST https://open.volcengineapi.com?Version=2022-12-12&Action=ModifyDomainNS
{
    "domain":"example.com",
    "ns_list":["ns1.volcengine-dns.com","ns2.volcengine-dns.com"]
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "20230522152902BF8AE46450333517309F",
        "Action": "ModifyDomainNS",
        "Version": "2022-12-12",
        "Service": "domain_openapi",
        "Region": "cn-north-1"
    }
}

错误码

如果响应正文包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见错误码。