UpdateAssets - 更新互联网边界资产防护开关--云防火墙-火山引擎

文档中心

立即注册

导航

UpdateAssets - 更新互联网边界资产防护开关

最近更新时间：2025.05.29 17:45:46首次发布时间：2024.03.28 17:09:34

更新互联网边界资产防护开关。

使用说明

此接口适用于更新单个资产防护开关，如需批量更新，可使用UpdateAssetSwitch - 批量更新资产防护开关。

请求说明

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

调试

API Explorer

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

去调试

请求参数

Query

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

Body

参数类型是否必选示例值描述

asset_ips Array of String 是 180.*.*.* 资产IP列表。该接口仅支持配置单个IP。如需批量更新，可参考UpdateAssetSwitch - 批量更新资产防护开关。

参数	类型	是否必选	示例值	描述
asset_ips	Array of String	是	`180...*`	资产IP列表。该接口仅支持配置单个IP。如需批量更新，可参考UpdateAssetSwitch - 批量更新资产防护开关。
enable	Boolean	否	`false`	防护开关的状态，用于控制互联网边界资产的防护功能。取值如下所示。 `false`：关闭防护； `true`：开启防护。
InternetFirewallId	String	否	`ifw-****`	互联网边界防火墙实例ID，获取方式可参考AssetList - 查询互联网边界资产列表。

enable

Boolean

否

false

防护开关的状态，用于控制互联网边界资产的防护功能。取值如下所示。

false：关闭防护；
true：开启防护。

InternetFirewallId String 否 ifw-**** 互联网边界防火墙实例ID，获取方式可参考AssetList - 查询互联网边界资产列表。

返回参数

参数	类型	示例值	描述
asset_ips	Array of String	`["180.1.1.1","180.2.2.2"]`	资产IP列表，包含需要更新防护开关的互联网边界资产IP地址。

请求示例

POST https://fw_center.volcengineapi.com/?Action=UpdateAssets&Version=2021-09-06
{
    "asset_ips": [
        "180.1.1.1",
        "180.2.2.2"
    ],
    "enable": true
}

返回示例

{
    "ResponseMetadata": {
        "Action": "UpdateAssets",
        "Region": "cn-beijing",
        "Service": "fw_center",
        "Version": "2021-09-06",
        "RequestId": "20230604110420****100232280022D31"
    },
    "Result": {
        "asset_ips": [
            "180.1.1.1",
            "180.2.2.2"
        ]
    }
}

错误码

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