1)接口功能介绍
入方向删除一条安全组规则。
2)接口约束
注意请求数据的格式。
当协议为ALL、ICMP时,address、protocolType、policyType相同时,则被认为是同一条规则。
当协议不为ALL、ICMP时,address、protocolType、policyType、ports相同时,则被认为是同一条规则。
3)URI
POST /v1/revokeSecurityGroup。
4)请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
securityGroupId | 是 | String | 安全组ID | 12 | |
ingresses | 是 | Object | 入方向规则列表 | * | Ingress |
表 Ingress
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
address | 是 | String | IP地址(段、组) | "0.0.0.0/0" | |
protocolType | 是 | String | 协议类型,目前支持ALL(全部)、ICMP、GRE、TCP、UDP 五类。 | ICMP | |
ports | 是 | String | 端口号,当协议类型为ALL、ICMP、GRE时,端口为全部端口,取默认值0,可不指定该参数;当协议类型为TCP、UDP时,必须指定1-65535范围内的端口号列表,逗号分隔 | 80 | |
policyType | 是 | String | 策略,可选类型为ACCEPT、DROP两种。 | ACCEPT |
5)响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
requestId | 是 | String | 请求id | b84233d3-0796-xxx | |
status | 是 | Object | 应答状态 | status |
表 status
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
message | 是 | String | 状态描述 | Success | |
code | 是 | String | 状态码 | Success |
6)请求示例
请求体body
{
"securityGroupId": "1953",
"ingresses": {
"address": "0.0.0.0/0",
"protocolType": "TCP",
"ports": "30000",
"policyType": "ACCEPT"
}
}
7)响应示例
{
"status": {
"message": "Success",
"code": "Success"
},
"requestId": "b61832eb-f322-4049-9e84-0a7c8134fa28"
}
8)状态码
状态码 | 描述 |
---|---|
Success | 表示请求成功。 |