1)接口功能介绍
入方向增加一条安全组规则。
2)接口约束
注意请求数据的格式。
3)URI
POST /v1/authorizeSecurityGroup。
4)请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
securityGroupId | 是 | String | 安全组ID | 12 | |
ingresses | 是 | List | 入方向规则列表 | * | Ingress |
表 Ingress
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
sourceType | 是 | String | 来源类型,目前只支持IP | ||
address | 是 | String | IP地址(段、组),支持IPv4、IPv6的单个地址、地址段和任意地址。单个IP地址:192.168.10.10/32(IPv4地址) ; 2002:50::44/127(IPv6地址)IP地址段:192.168.1.0/24(IPv4地址段) ; 2407:c080:802:469::/64(IPv6地址段)所有IP地址:0.0.0.0/0(IPv4任意地址) ; ::/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 | |
securityGroupId | 否 | String | 安全组ID | 12 | |
description | 否 | String | 描述 | test | |
priority | 否 | Integer | 优先级 | 90 |
5)响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
requestId | 是 | String | 请求id | b84233d3-0796-xxx | |
status | 是 | Object | 应答状态 |
表 status
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
message | 是 | string | 状态描述 | Success | |
code | 是 | string | 状态码 | Success |
6)请求示例
请求体body
{
"securityGroupId": "1953",
"ingresses": [
{
"sourceType": "IP",
"protocolType": "ICMP",
"securityGroupId": "1953",
"policyType": "ACCEPT",
"address": "0.0.0.0/0",
"ports": "0",
"description": "sdddd"
}
]
}
7)响应示例
{
"status": {
"message": "Success",
"code": "Success"
},
"requestId": "c6be2776-37e5-4cb7-ae02-abc780769164"
}
8)状态码
状态码 | 描述 |
---|---|
Success | 表示请求成功。 |