更新时间：2026-04-15 GMT+08:00
更新网络ACL - UpdateFirewall
功能介绍
更新网络ACL。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
PUT /v1/firewalls/{firewall_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| firewall_id | 是 | String | 网络ACL ID |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| firewall | 是 | UpdateFirewallOption object | 更新网络ACL的参数。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 是 | String | 网络ACL名称。更新时name不能为空。 中文字符、字母、数字、中划线和下划线组成，长度为1~64个字符 |
| admin_state_up | 否 | Boolean | 网络ACL的使能开关。 取值范围：true（开启），false（关闭） |
| description | 否 | String | 网络ACL描述。 |
| subnets | 否 | Array of FirewallSubnetOption objects | 关联子网列表。 |
请求示例
网路ACL关联子网2747a93b-192f-4397-9fd5-eb1af315eb69
PUT https://{endpoint}/v1/firewalls/c2c5234b-67ff-11ea-a41a-00e04c9bd2a3
{
"firewall" : {
"admin_state_up" : true,
"description" : "test",
"name" : "test",
"subnets" : [ {
"id" : "2747a93b-192f-4397-9fd5-eb1af315eb69",
"vpc_id" : "872b0af3-6826-11ea-b42b-286ed488d287"
} ]
}
} 响应示例
状态码：200
OK
{
"firewall" : {
"id" : "ce1ce0c8-d714-11ea-a863-fa16408859a1",
"status" : "INACTIVE"
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
错误码
请参见错误码。
父主题： 网络ACL
