Update security group rules
Updated at：2025-10-20
This API allows you to modify security group rule details.
Request structure
Plain Text
1PUT /v{version}/securityGroup/rule/update?sgVersion={sgVersion}
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "securityGroupRuleId":"r-q1ek3jvwuede",
7 "sourceIp":"3.3.3.9",
8 "remark":"test"
9}Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| sgVersion | long | No | Query | Security group version number |
| securityGroupRuleId | String | Yes | RequestBody | ID of security group rules |
| remark | String | No | RequestBody | Description |
| portRange | String | No | RequestBody | Port range |
| sourceIp | String | No | RequestBody | Ingress rule IP, which cannot exist simultaneously with sourceGroupId |
| sourceGroupId | String | No | RequestBody | Ingress rule security group ID, which cannot exist simultaneously with sourceIp |
| destIp | String | No | RequestBody | Egress rule IP, which cannot exist simultaneously with destGroupId |
| destGroupId | String | No | RequestBody | Egress rule security group ID, which cannot exist simultaneously with destIp |
| protocol | String | No | RequestBody | Protocol, temporarily does not support conversion from tcp/udp to icmp |
Response headers
No special headers are required beyond the standard ones.
Response parameters
No response parameters
Error code
| Error code | Error description | HTTP status code | Chinese explanation |
|---|---|---|---|
| VersionMismatch | The sgVersion is mismatch. | 400 | The specified version number of the security group rule does not match the latest version. If the sgVersion parameter is not included in the request, this error code will not be returned. |
| NoSuchObject | Resource not exist. | 404 | Security group rule does not exist |
| InvalidProtocolException | Invalid protocol | 400 | Protocol error, conversion to icmp is not supported |
| SecurityGroup.RuleCIDRAddressError | Security group rule ip(cidr) address is incorrect. | 400 | Security group rule source (destination) address error |
| SecurityGroup.RuleRemarkTooLong | Security group description is too long | 400 | Description exceeds length limit |
| SecurityGroup.RulePortInvalid | The value of security group rule port must be number | 400 | The port number of the security group rule is out of the allowed range |
| BadRequest | protocol is invalid. | 400 | Protocol type error |
Request example
Plain Text
1PUT /v2/securityGroup/rule/update
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{"remark":"test"}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Thu, 16 Mar 2017 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS