ModifyDnsControlPolicy-修改域名黑名单访问控制策略--云防火墙-火山引擎

文档中心

立即注册

导航

ModifyDnsControlPolicy-修改域名黑名单访问控制策略

最近更新时间：2025.05.29 17:32:43首次发布时间：2024.12.25 10:23:32

修改域名黑名单访问控制策略配置详情。

请求说明

请求方式：POST
请求地址：https://fw_center.volcengineapi.com/?Action=ModifyDnsControlPolicy&Version=2021-09-06

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`ModifyDnsControlPolicy`	接口名称。当前 API 的名称为 `ModifyDnsControlPolicy`。
Version	String	是	`2021-09-06`	接口版本。当前 API 的版本为 `2021-09-06`。

Body

参数	类型	是否必选	示例值	描述
Description	String	否	`Description`	描述信息
Destination	String	是	`*****.com`	访问目的：域名或域名地址簿唯一标识ID, 当前只支持一个地址簿
DestinationType	String	是	`domain`	目的类型： domain：域名 group：地址簿
InternetFirewallId	String	否	`ifw-****`	互联网边界防火墙实例ID，获取方式可参考AssetList - 查询互联网边界资产列表。
RuleId	String	是	`f04ac7ce-**---**********`	访问控制策略唯一标识ID，获取方式可参考DescribeDnsControlPolicy-查询域名黑名单访问控制策略列表。
Source	Array of SourceStructure	是	`--`	访问源：VPC列表，获取方式可参考DescribeVpcs-查询VPC列表。
Status	Boolean	否	`true`	开关状态： false：关闭 true：开启

SourceStructure

参数	类型	是否必选	示例值	描述
VpcId	String	是	`vpc-xxxx`	VPC ID，获取方式可参考DescribeVpcs-查询VPC列表。
Region	String	是	`cn-beijing`	VPC 地域信息，获取方式可参考DescribeVpcs-查询VPC列表。

返回参数

参数	类型	示例值	描述
RuleId	String	`f04ac7ce-**---**********`	成功后返回访问控制策略唯一标识ID

请求示例

POST https://fw_center.volcengineapi.com/?Action=ModifyDnsControlPolicy&Version=2021-09-06
{
    "Description": "Description",
    "Destination": "*****.com",
    "DestinationType": "domain",
    "InternetFirewallId": "ifw-****",
    "RuleId": "f04ac7ce-****-****-****-************",
    "Source": [
        {
            "VpcId": "vpc-xxxx",
            "Region": "cn-beijing"
        }
    ],
    "Status": true
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20241218162918E7FCEA65B9233FBE****",
        "Action": "ModifyDnsControlPolicy",
        "Version": "2021-09-06"
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。