内网DNS

更新时间：2025-08-21

获取Endpoint

在确认您使用SDK时配置的Endpoint时，可先阅读开发人员指南中关于DNS服务域名的部分，理解Endpoint相关的概念。

注意： DNS API支持HTTP和HTTPS两种调用方式。为了提升数据的安全性，建议通过HTTPS调用

获取AK/SK

要使用百度智能云DNS，您需要拥有一个有效的 AK（Access Key ID）和SK(Secret Access Key)用来进行签名认证。AK/SK是由系统分配给用户的，均为字符串，用于标识用户，为访问服务做签名验证。可以通过如下步骤获得并了解您的AK/SK信息：

新建LdClient

LdClient是内网DNS服务的客户端，为开发者与DNS服务进行交互提供了一系列的方法。新建LdClient时，需要先使用Endpoint、AK、SK对BceClientConfigurationl类型的config实例进行配置，再使用config实例对DnsClient进行配置，具体配置方法如下：

Plain Text

1static final String ENDPOINT = "";
2static final String AK = "";
3static final String SK = "";
4BceClientConfiguration config = new BceClientConfiguration();
5config.setCredentials(new DefaultBceCredentials(AK, SK));
6config.setEndpoint(ENDPOINT);
7LdClient ldClient = new LdClient(config);

创建PrivateZone

函数声明

                Java
                
                public CreatePrivateZoneResponse createPrivateZone(CreatePrivateZoneRequest body, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档创建PrivateZone请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "zoneId":"zone-jkgdns3h"
4}

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleCreatePrivateZone.java

删除PrivateZone

函数声明

                Java
                
                public void deletePrivateZone(String zoneId, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档删除PrivateZone请求参数

返回值

操作成功

无

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleDeletePrivateZone.java

查询PrivateZone列表

函数声明

                Java
                
                public ListPrivateZoneResponse listPrivateZone(String marker, Integer maxKeys) {
    ......
}

参数含义

请参考OpenAPI文档查询PrivateZone列表请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "nextMarker": "zone-xktdeMSf",
4    "marker": "zone-IyWRnII7",
5    "maxKeys": 1,
6    "isTruncated": true,
7    "zones": [
8        {
9            "zoneId": "zone-IyWRnII7",
10            "zoneName": "baidu.com",
11            "recordCount": 2,
12            "createTime": "2018-12-26 20:30:45",
13            "updateTime": "2018-12-28 21:35:40"
14        }
15    ]
16}

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleListPrivateZone.java

查询PrivateZone详情

函数声明

                Java
                
                public GetPrivateZoneResponse getPrivateZone(String zoneId) {
    ......
}

参数含义

请参考OpenAPI文档查询PrivateZone详情请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "zoneId": "zone-xktdeMSf",
4    "zoneName": "baidu1.com",
5    "recordCount": 2,
6    "createTime": "2018-12-26 20:30:45",
7    "updateTime": "2018-12-28 21:35:40"
8    "bindVpcs": [
9        {
10            "vpcId": "vpc-jikh8hds",
11            "vpcName": "vpcTest",
12            "vpcRegion": "bj"
13        }
14    ]
15}

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleDetailPrivateZone.java

关联VPC

函数声明

                Java
                
                public void bindVpc(String zoneId, BindVpcRequest body, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档关联VPC请求参数

返回值

操作成功

无

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleBindVpcOnPrivateZone.java

解关联VPC

函数声明

                Java
                
                public void unbindVpc(String zoneId, UnbindVpcRequest body, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档解关联VPC请求参数

返回值

操作成功

无

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleUnBindVpcFromPrivateZone.java

添加解析记录

函数声明

                Java
                
                public AddRecordResponse addRecord(String zoneId, AddRecordRequest body, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档添加解析记录请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "recordId":"rc-jih8hd5s"
4}

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleAddRecordOnPrivateZone.java

修改解析记录

函数声明

                Java
                
                public void updateRecord(String recordId, UpdateRecordRequest body, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档修改解析记录请求参数

返回值

操作成功

无

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleUpdateRecordOnPrivateZone.java

删除解析记录

函数声明

                Java
                
                public void deleteRecord(String recordId, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档删除解析记录请求参数

返回值

操作成功

无

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleDeleteRecordOnPrivateZone.java

查询解析记录列表

函数声明

                Java
                
                public ListRecordResponse listRecord(String zoneId) {
    ......
}

参数含义

请参考OpenAPI文档查询解析记录列表请求参数

返回值

操作成功

Plain Text

1{
2    "metadata":具体信息参考附录metadata部分,
3    "nextMarker": "rc-Iy8p6arqenI7",
4    "marker": "rc-ik9p9zq6u5ry",
5    "maxKeys": 1,
6    "isTruncated": true,
7    "records": [
8        {
9            "recordId": "rc-djkf8hf9",
10            "rr": "ip",
11            "value": "192.184.18.233",
12            "status": "enable",
13            "type": "A",
14            "ttl": 60,
15            "description": "desc"
16        }
17    ]
18}

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleListRecordsOfPrivateZone.java

开启解析记录

函数声明

                Java
                
                public void enableRecord(String recordId, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档开启解析记录请求参数

返回值

操作成功

无

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleEnableRecordOnPrivateZone.java

关闭解析记录

函数声明

                Java
                
                public void disableRecord(String recordId, String clientToken) {
    ......
}

参数含义

请参考OpenAPI文档关闭解析记录请求参数

返回值

操作成功

无

操作失败

操作失败返回异常列表参考异常列表

代码示例

具体代码示例参考：ExampleDisableRecordOnPrivateZone.java

附录

公共返回信息metadata格式

Plain Text

1 {
2      "bceRequestId":"f5f0821d-45fe-439b-bbf4-fc48b639f84a",
3      "contentLength":28,
4      "contentType":"application/json;charset=UTF-8",
5      "date":1701917695000,
6      "server":"openresty/1.15.8.1"
7 }

Python-SDK

公网DNS

智能云解析 DNS

智能云解析 DNS

内网DNS

获取Endpoint

获取AK/SK

新建LdClient

创建PrivateZone

删除PrivateZone

查询PrivateZone列表

查询PrivateZone详情

关联VPC

解关联VPC

添加解析记录

修改解析记录

删除解析记录

查询解析记录列表

开启解析记录

关闭解析记录

附录