修改安全组信息
更新时间:2024-11-19
接口描述
该接口用于更新安全组信息。
请求结构
PUT /v1/securityGroup/{securityGroupId}
Host: bec.baidubce.com
Authorization: authorization string
{"name":"test","desc":"desc"}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
securityGroupId | String | 是 | URL参数 | 安全组ID |
name | String | 是 | RequestBody参数 | 创建的安全组的名字,支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。 |
desc | String | 否 | RequestBody参数 | 对所创建的安全组的描述信息 |
返回头域
除公共头域,无其它特殊头域。
返回参数
参数名称 | 类型 | 描述 |
---|---|---|
result | Boolean | 返回结果,true:表示成功;false:表示失败。 |
action | String | 操作描述 |
details | Details | 返回结果 |
请求示例
PUT /v1/securityGroup/sg-xkakopyr
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2021-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{"name": "test", "desc": ""}
返回示例
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2021 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"result": true,
"action": "update",
"details": {
"id": "sg-xkakopyr",
"name": "test",
"desc": "",
"rules": [
{
"securityGroupRuleId": "sgr-xkakopyr-a8tlrhdi",
"direction": "ingress",
"protocol": "tcp",
"portRange": "8000",
"remark": "test",
"etherType": "IPv4"
},
{
"securityGroupRuleId": "sgr-xkakopyr-khhewyl6",
"direction": "egress",
"protocol": "1-65535",
"remark": "test all",
"etherType": "IPv4"
}
]
}
}
Modal对象定义
Details
参数名称 | 类型 | 描述 |
---|---|---|
id | String | 安全组ID |
name | String | 名称 |
desc | String | 描述 |
sgVersion | long | 安全组版本号 |
rules | List<SecurityGroupRule> | 安全组规则 |
SecurityGroupRule
参数名称 | 类型 | 描述 |
---|---|---|
direction | String | 入站/出站,取值ingress或egress |
etherType | String | 网络类型,取值IPv4。暂不支持IPv6 |
portRange | String | 端口范围,单个端口,或者为1-65535格式的端口范围 |
protocol | String | 协议类型,tcp、udp或icmp,值为空时默认为所有协议 |
sourceIp | String | 源IP地址 |
destIp | String | 目的IP地址 |
remark | String | 备注 |