文档中心 > CreateSecurityGroupRule
CreateSecurityGroupRule

最近更新时间:2021-12-24

请求方法:POST

接口描述:使用CreateSecurityGroupRule接口创建一条安全组规则。


请求参数

Param

名称

类型

是否必选

描述

Action

String

系统规定参数。取值:CreateSecurityGroupRule

RegionId

String

地域ID。
  HB1-BJMY (华北2-北京2) ;
  HD1-SHMY(华东1-上海)

SgId

String

安全组ID。

Body

名称

类型

是否必选

描述

Direction

String

规则方向,ingress或egress

EtherType

String

IPv4或IPv6。

IsDeny

Integer

授权策略,0或1,同等优先级下,遵循优先拒绝原则。

PortRangeMax

Integer

传输层协议相关的端口范围最大值,最大值为65535。

PortRangeMin

Integer

传输层协议相关的端口范围最小值,最小值为1。

Priority

Integer

安全组规则优先级,1-100,数值越小,优先级越高。

Protocol

String

传输层协议。取值大小写敏感。取值范围:tcp、udp、icmp

RemoteGroupId

String

授权对象,支持配置多个CIDR,不同的CIDR之间使用逗号分隔,最多支持10段。

RemoteIpPrefix

String


SecurityGroupId

String

安全组 ID。


返回参数

名称

类型

描述

Code

String

请求结果编码。

Msg

String

请求结果描述。

Res

Object


+Direction

String

规则方向,ingress或egress

+EtherType

String

IPv4。

+Id

String


+IsDeny

Integer

授权策略,0或1,同等优先级下,遵循优先拒绝原则。

+PortRangeMax

Integer

传输层协议相关的端口范围最大值,最大值为65535。

+PortRangeMin

Integer

传输层协议相关的端口范围最小值,最小值为1。

+Priority

Integer

安全组规则优先级,1-100,数值越小,优先级越高。

+Protocol

String

传输层协议。取值大小写敏感。取值范围:tcp、udp、icmp

+RemoteGroupId

String

授权对象,支持配置多个CIDR,不同的CIDR之间使用逗号分隔,最多支持10段。

+RemoteIpPrefix

String


+SecurityGroupId

String

安全组 ID。

 

示例

请求示例

POST https://api.unicloud.com/networks/securitygroup?Action=CreateSecurityGroupRule

&RegionId=HB1-BJMY

&SgId=sg-69dulv22372ob

&<公共请求参数>



body

[

  {

    "Direction": "ingress",

    "EtherType": "IPv4",

    "IsDeny": 0,

    "PortRangeMax": 20,

    "PortRangeMin": 15,

    "Priority": 11,

    "Protocol": "tcp",

    "RemoteGroupId": "10.1.0.0/16,10.2.0.0/16",

    "SecurityGroupId": "sg-69dulv22372ob"

  }

]

返回示例

JSON 格式

{

  "Res": {

    "IsDeny": 0,

    "RemoteGroupId": "",

    "PortRangeMin": 8898,

    "Priority": 1,

    "RemoteIpPrefix": "0.0.0.0",

    "SecurityGroupId": "sg-yhmkqzr1q5wob",

    "PortRangeMax": 8898,

    "EtherType": "IPv4",

    "ID": "c207f0be47444db9be6cf90a05a656fc",

    "Protocol": "tcp",

    "Direction": "egress"

  },

  "Msg": "创建安全组规则成功",

  "Code": "Network.Success"

}