QingCloud 文档 – API接口 - kaiyun官方网站下载手机网页

Security: AddSecurityGroupRules

Mon, 01 Jan 0001 00:00:00 +0000

给防火墙添加规则。每条规则包括的属性为：

protocol：协议
priority：优先级，由高到低为 0 - 100
security_group_rule_name：规则名称
action：操作，分为 accept 接受和 drop 拒绝
direction：方向，0 表示下行，1 表示上行。
val1：如果协议为 tcp 或 udp，此值表示起始端口。如果协议为 icmp，此值表示 ICMP 类型。具体类型可参见 ICMP 类型及代码
val2：如果协议为 tcp 或 udp，此值表示结束端口。如果协议为 icmp，此值表示 ICMP 代码。具体代码可参见 ICMP 类型及代码
val3：源IP

注解

添加规则后，记得调用 ApplySecurityGroup 使其生效。

Request Parameters

Parameter name	Type	Description	Required
security_group	String	防火墙ID	Yes
rules.n.protocol	String	协议，目前支持 tcp, udp, icmp, gre, esp, ah, ipip	Yes
rules.n.priority	Integer	优先级，由高到低为 0 - 100	Yes
rules.n.security_group_rule_name	String	规则名称	No
rules.n.action	String	操作，支持 accept (接受) 或 drop (拒绝)	No
rules.n.direction	Integer	方向，0 表示下行，1 表示上行。默认为 0。	No
rules.n.val1	String	如果协议为 tcp 或 udp，此值表示起始端口。如果协议为 icmp，此值表示 ICMP 类型。其他协议无需此值。	No
rules.n.val2	String	如果协议为 tcp 或 udp，此值表示结束端口。如果协议为 icmp，此值表示 ICMP 代码。其他协议无需此值。	No
rules.n.val3	String	目标 IP，如果填写，则这条防火墙规则只对此IP（或IP段）有效。	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_rules	Array	添加成功的防火墙规则ID列表
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=AddSecurityGroupRules
&rules.1.action=accept
&rules.1.direction=0
&rules.1.priority=7
&rules.1.protocol=tcp
&rules.1.val1=22
&rules.1.val2=
&rules.1.val3=
&security_group=sg-6ft05wt6
&COMMON_PARAMS

Example Response:

{
  "action":"AddSecurityGroupRulesResponse",
  "security_group_rules":[
    "sgr-vgiw8cv8"
  ],
  "ret_code":0
}

Security: ApplySecurityGroup

Mon, 01 Jan 0001 00:00:00 +0000

应用防火墙规则。当防火墙的规则发生改变后，新规则不会即刻生效（可通过 is_applied 属性分辨），需要调用 ApplySecurityGroup 之后才生效。

防火墙规则可通过 AddSecurityGroupRules, DeleteSecurityGroupRules, ModifySecurityGroupRuleAttributes 修改。

如果请求参数中传递了 instances.n ，则表示将此防火墙的规则应用到对应的云服务器。如果不传此参数，则会将最新规则更新到所有已应用此防火墙的云服务器。

Request Parameters

Parameter name	Type	Description	Required
security_group	String	防火墙 ID	Yes
instances.n	String	应用防火墙的云服务器ID。如果不传任何值，则会将最新规格更新到所有之前已应用此防火墙的云服务器。	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
job_id	String	执行任务的 Job ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=ApplySecurityGroup
&security_group=sg-12djpg8q
&instances.1=i-12345678,
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"ApplySecurityGroupResponse",
  "job_id":"j-bm6ym3r8",
  "ret_code":0
}

Security: CopySecurityGroupIPSets

Mon, 01 Jan 0001 00:00:00 +0000

复制 IP/端口集合到其他 zone（可以复制到当前zone）。

Request Parameters

Parameter name	Type	Description	Required
ipsets.n	String	一个或多个IP/端口集合ID	Yes
dest_zones.n	String	一个或多个区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=CopySecurityGroupIPSets
&ipsets.1=sgi-12345678
&dest_zones.1=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"CopySecurityGroupIPSetsResponse",
  "ret_code":0
}

Security: CreateSecurityGroup

Mon, 01 Jan 0001 00:00:00 +0000

创建防火墙。防火墙可用于保障云服务器和路由器的网络安全。

刚创建的防火墙不包含任何规则，即任何端口都是封闭的，需要建立规则以打开相应的端口。

开·云app官方版下载为每个用户提供了一个缺省防火墙，为了方便用户使用，缺省防火墙默认打开了下行 icmp 协议和 tcp 22 端口。

Request Parameters

Parameter name	Type	Description	Required
security_group_name	String	防火墙名称	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_id	String	创建成功的防火墙 ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=CreateSecurityGroup
&security_group_name=specify
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"CreateSecurityGroupResponse",
  "security_group_id":"sg-j38f2h3h"
  "ret_code":0
}

Security: CreateSecurityGroupIPSet

Mon, 01 Jan 0001 00:00:00 +0000

创建防火墙IP/端口集合。

您可以借助 “IP/端口集合” 功能把具有相同特征的一组 IP 或者一组端口设置成为 “IP/端口集合”，并且在防火墙规则中进行添加，实现批量管理功能。

Request Parameters

Parameter name	Type	Description	Required
security_group_ipset_name	String	名称	No
ipset_type	Integer	类型 (0:IP, 1:端口)	Yes
val	String	值 (例如: 192.168.1.0/24 或 10000-15000）	Yes
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_id	String	创建成功的资源 ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=CreateSecurityGroupIPSet
&ipset_type=1
&val=10000-15000
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"CreateSecurityGroupIPSetResponse",
  "security_group_ipset_id":"sgi-sptxtjg9"
  "ret_code":0
}

Security: CreateSecurityGroupSnapshot

Mon, 01 Jan 0001 00:00:00 +0000

根据当前的防火墙规则创建一个备份, 用于随时回滚之前的防火墙规则。

Request Parameters

Parameter name	Type	Description	Required
security_group	String	防火墙ID	Yes
name	String	名称	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_snapshot_id	String	创建成功的防火墙备份的 ID
security_group_id	String	防火墙 ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=CreateSecurityGroupSnapshot
&security_group=sg-q36kwq5r
&name=sg_snapshot
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"CreateSecurityGroupSnapshotResponse",
  "security_group_id":"sg-j38f2h3h",
  "security_group_snapshot_id":"sgs-6la5ljm3",
  "ret_code":0
}

Security: DeleteSecurityGroupIPSets

Mon, 01 Jan 0001 00:00:00 +0000

删除一个或多个防火墙IP/端口集合。

IP/端口集合须在没有资源（防火墙）使用的情况下才能被删除。已加载到资源的IP/端口集合，需先将相关资源从防火墙移出后才能被删除。

Request Parameters

Parameter name	Type	Description	Required
security_group_ipsets.n	String	ID	Yes
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_ipsets	Array	成功删除的ID列表
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=DeleteSecurityGroupIPSets
&security_group_ipsets.1=sgi-inijevna
&security_group_ipsets.2=sgi-o3msxqpp
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"DeleteSecurityGroupIPSetsResponse",
  "security_group_ipsets":[
    "sgi-inijevna",
    "sgi-o3msxqpp"
  ],
  "ret_code":0
}

Security: DeleteSecurityGroupRules

Mon, 01 Jan 0001 00:00:00 +0000

删除防火墙规则。

注解

删除规则后，记得调用 ApplySecurityGroup 使其生效。

Request Parameters

Parameter name	Type	Description	Required
security_group_rules.n	String	防火墙规则ID	Yes
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_rules	Array	成功删除的防火墙规则ID列表
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=DeleteSecurityGroupRules
&security_group_rules.1=sgr-13cooxdd
&security_group_rules.2=sgr-c25rz9c1
&security_group_rules.3=sgr-191d8eb5
&COMMON_PARAMS

Example Response:

{
  "action":"DeleteSecurityGroupRulesResponse",
  "security_group_rules":[
    "sgr-13cooxdd",
    "sgr-c25rz9c1",
    "sgr-191d8eb5"
  ],
  "ret_code":0
}

Security: DeleteSecurityGroups

Mon, 01 Jan 0001 00:00:00 +0000

删除一个或多个防火墙。

防火墙须在没有资源（云服务器或路由器）使用的情况下才能被删除。已加载规则到资源的防火墙，需先将相关资源从防火墙移出后才能被删除。

要删除的防火墙已加载规则到云服务器，则需要先调用 ApplySecurityGroup 将其他防火墙的规则应用到对应云服务器，之后才能被删除。
要删除的防火墙已加载规则到路由器，则需要先调用 ModifyRouterAttributes 并 UpdateRouters 将其他防火墙的规则应用到对应路由器，之后才能被删除。

开·云app官方版下载系统提供的缺省防火墙不能被删除。

Request Parameters

Parameter name	Type	Description	Required
security_groups.n	String	防火墙 ID	Yes
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_groups	Array	成功删除的防火墙ID列表
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=DeleteSecurityGroups
&security_groups.1=sg-inijevna
&security_groups.2=sg-o3msxqpp
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"DeleteSecurityGroupsResponse",
  "security_groups":[
    "sg-inijevna",
    "sg-o3msxqpp"
  ],
  "ret_code":0
}

Security: DeleteSecurityGroupSnapshots

Mon, 01 Jan 0001 00:00:00 +0000

删除防火墙备份。

Request Parameters

Parameter name	Type	Description	Required
security_group_snapshots.n	String	防火墙规则ID	Yes
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_snapshots	Array	成功删除的防火墙备份ID列表
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=DeleteSecurityGroupSnapshots
&security_group_snapshots.1=sgs-wx55xhix
&COMMON_PARAMS

Example Response:

{
  "action":"DeleteSecurityGroupSnapshotsResponse",
  "security_group_snapshots":[
    "sgs-wx55xhix"
  ],
  "ret_code":0
}

Security: DescribeSecurityGroupIPSets

Mon, 01 Jan 0001 00:00:00 +0000

获取一个或多个IP/端口集合信息。

可根据ID，名称作过滤条件，来获取IP/端口集合列表。如果不指定任何过滤条件，默认返回你所拥有的所有IP/端口集合。如果指定不存在的ID，或非法状态值，则会返回错误信息。

Request Parameters

Parameter name	Type	Description	Required
security_group_ipsets.n	String	IP/端口集合ID	No
ipset_type	Integer	类型 (0:IP, 1:端口)	No
security_group_ipset_name	String	IP/端口集合名称, 可以部分匹配	No
tags.n	String	按照标签ID过滤, 只返回已绑定某标签的资源	No
verbose	Integer	是否返回冗长的信息，若为1，则返回应用了此IP/端口集合的其他资源的信息，默认为0.	No
offset	Integer	数据偏移量，默认为0	No
limit	Integer	返回数据长度，默认为20，最大100	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_ipset_set	Array	JSON 格式的IP/端口集合数据列表，每项数据可见下面 Response Item
total_count	Integer	根据过滤条件得到的总数
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Response Item

Name	Type	Description
security_group_ipset_id	String	ID
security_group_ipset_name	String	名称
description	String	描述
val	String	值，例如: 192.168.1.0/24
ipset_type	Integer	值，0 或者 1
create_time	TimeStamp	创建时间，为UTC时间，格式可参见 ISO8601.

Example

Example Request:

https://api.qingcloud.com/iaas/?action=DescribeSecurityGroupIPSets
&COMMON_PARAMS

Example Response:

{
  "action":"DescribeSecurityGroupIPSetsResponse",
  "total_count":1,
  "security_group_ipset_set":[
    {
      "val":"192.168.1.0/24",
      "ipset_type": "0",
      "description":null,
      "security_group_ipset_id":"sgi-9eicklme",
      "create_time":"2013-03-19T08:27:05Z",
      "security_group_ipset_name":"default security group_ipset"
    }
  ],
  "ret_code":0
}

Security: DescribeSecurityGroupRules

Mon, 01 Jan 0001 00:00:00 +0000

获取某个防火墙的规则信息。

可根据防火墙ID，上行/下行，防火墙规则ID 作过滤条件，获取防火墙规则列表。如果不指定任何过滤条件，默认返回你所拥有的所有防火墙的所有规则。

Request Parameters

Parameter name	Type	Description	Required
security_group	String	防火墙ID	No
security_group_rules.n	String	防火墙规则ID	No
direction	Integer	方向，0 表示下行，1 表示上行。默认为 0。	No
offset	Integer	数据偏移量，默认为0	No
limit	Integer	返回数据长度，默认为20，最大100	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_rule_set	Array	JSON 格式的防火墙规则数据列表，每项参数可见下面 ResponseItemType
total_count	Integer	根据过滤条件得到的防火墙总数
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

ResponseItemType

Name	Type	Description
security_group_id	String	防火墙ID
security_group_rule_id	String	防火墙规则ID
priority	Integer	防火墙规则优先级。优先级由高到低的范围是 0 到 100，值越大优先级越低。
protocol	String	协议
action	String	操作，accept 表示接受，drop 表示拒绝。
val1	String	如果协议为 tcp 或 udp，此值表示起始端口。如果协议为 icmp，此值表示 ICMP 类型。具体类型可参见 ICMP 类型及代码
val2	String	如果协议为 tcp 或 udp，此值表示结束端口。如果协议为 icmp，此值表示 ICMP 代码。具体代码可参见 ICMP 类型及代码
val3	String	源IP

Example

Example Request:

https://api.qingcloud.com/iaas/?action=DescribeSecurityGroupRules
&security_group=sg-n43jh2pq
&direction=0
&COMMON_PARAMS

Example Response:

{
  "action":"DescribeSecurityGroupRulesResponse",
  "security_group_rule_set":[
    {
      "protocol":"tcp",
      "security_group_id":"sg-nlqi5sa1",
      "priority":1,
      "action":"accept",
      "security_group_rule_id":"sgr-0jzv8t0q",
      "val2":"8088",
      "val1":"8080",
      "direction":0
    },
    {
      "protocol":"icmp",
      "security_group_id":"sg-nlqi5sa1",
      "priority":2,
      "action":"accept",
      "security_group_rule_id":"sgr-vqxvzjg3",
      "val2":"0",
      "val1":"11",
      "direction":1
    }
  ],
  "ret_code":0,
  "total_count":2
}

Security: DescribeSecurityGroups

Mon, 01 Jan 0001 00:00:00 +0000

获取一个或多个防火墙信息。

可根据防火墙ID，名称作过滤条件，来获取防火墙列表。如果不指定任何过滤条件，默认返回你所拥有的所有防火墙。如果指定不存在的防火墙ID，或非法状态值，则会返回错误信息。

Request Parameters

Parameter name	Type	Description	Required
security_groups.n	String	防火墙ID	No
search_word	String	搜索关键词，支持防火墙ID，防火墙名称	No
tags.n	String	按照标签ID过滤, 只返回已绑定某标签的资源	No
verbose	Integer	是否返回冗长的信息，若为1，则返回应用了此防火墙的其他资源的信息，默认为0.	No
offset	Integer	数据偏移量，默认为0	No
limit	Integer	返回数据长度，默认为20，最大100	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_set	Array	JSON 格式的防火墙数据列表，每项数据可见下面 Response Item
total_count	Integer	根据过滤条件得到的防火墙总数
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Response Item

Name	Type	Description
security_group_id	String	防火墙ID
security_group_name	String	防火墙名称
description	String	防火墙描述
is_applied	Integer	是否已更新规则，1为已更新，0为还未更新。当你修改防火墙的规则后，要“更新规则”才会生效。更新规则 API 参见 ApplySecurityGroup
is_default	Integer	是否是系统默认防火墙，1为是，0为不是
resources	Array	应用了此防火墙的资源列表，每项资源数据格式为: { “resource_id”: “i-nz7v9hgq”, “resource_name”: “api test” “resource_type”: “instance” } 只有在请求参数 verbose=1 时才会返回此信息。
create_time	TimeStamp	防火墙创建时间，为UTC时间，格式可参见 ISO8601.

Example

Example Request:

https://api.qingcloud.com/iaas/?action=DescribeSecurityGroups
&verbose=1
&COMMON_PARAMS

Example Response:

{
  "action":"DescribeSecurityGroupsResponse",
  "total_count":1,
  "security_group_set":[
    {
      "is_applied":1,
      "description":null,
      "security_group_id":"sg-z13kokni",
      "is_default":1,
      "create_time":"2013-03-19T08:27:05Z",
      "security_group_name":"default security group",
      "resources":[
        {
          "resource_name":"",
          "resource_type":"instance",
          "resource_id":"i-ogbndull"
        }
      ]
    }
  ],
  "ret_code":0
}

Security: DescribeSecurityGroupSnapshots

Mon, 01 Jan 0001 00:00:00 +0000

获取某个防火墙的备份信息。

Request Parameters

Parameter name	Type	Description	Required
security_group	String	防火墙ID	Yes
security_group_snapshots.n	String	防火墙备份ID	No
offset	Integer	数据偏移量，默认为0	No
limit	Integer	返回数据长度，默认为20，最大100	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_snapshot_set	Array	JSON 格式的防火墙备份数据列表，每项参数可见下面 ResponseItemType
total_count	Integer	根据过滤条件得到的防火墙备份总数
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

ResponseItemType

Name	Type	Description
group_id	String	防火墙ID
security_group_snapshot_id	String	防火墙备份ID
rules	Array	规则列表

Example

Example Request:

https://api.qingcloud.com/iaas/?action=DescribeSecurityGroupSnapshots
&security_group=sg-n43jh2pq
&direction=0
&COMMON_PARAMS

Example Response:

{
  "action":"DescribeSecurityGroupSnapshotsResponse",
  "total_count":4,
  "security_group_snapshot_set":[
    {
      "description":"",
      "rules":[
        {
          "disabled":0,
          "direction":0,
          "protocol":"tcp",
          "priority":2,
          "val3":"",
          "action":"accept",
          "val2":"22",
          "val1":"22",
          "security_group_rule_name":""
        },
        {
          "disabled":0,
          "direction":0,
          "protocol":"icmp",
          "priority":1,
          "val3":"",
          "action":"accept",
          "val2":"0",
          "val1":"8",
          "security_group_rule_name":""
        }
      ],
      "root_user_id":"usr-T5OfrfRb",
      "create_time":"2015-12-14T06:34:21Z",
      "security_group_snapshot_id":"sgs-hycrez7a",
      "owner":"usr-T5OfrfRb",
      "group_id":"sg-q36kwq5r",
      "name":"sg_snapshot"
    }
  ],
  "ret_code":0
}

Security: ModifySecurityGroupAttributes

Mon, 01 Jan 0001 00:00:00 +0000

修改防火墙的名称和描述。

一次只能修改一个防火墙。

Request Parameters

Parameter name	Type	Description	Required
security_group	String	防火墙 ID	Yes
security_group_name	String	防火墙名称	No
description	String	防火墙描述	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_id	String	防火墙 ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=ModifySecurityGroupAttributes
&security_group=sg-rtyv0968
&security_group_name=sample
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"ModifySecurityGroupAttributesResponse",
  "security_group_id":"sg-rtyv0968",
  "ret_code":0
}

Security: ModifySecurityGroupIPSetAttributes

Mon, 01 Jan 0001 00:00:00 +0000

修改防火墙IP/端口集合的名称和描述。

一次只能修改一个。

Request Parameters

Parameter name	Type	Description	Required
security_group_ipset	String	ID	Yes
security_group_ipset_name	String	名称	No
description	String	描述	No
val	String	值	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_ipset_id	String	ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=ModifySecurityGroupIPSetAttributes
&security_group_ipset=sgi-rtyv0968
&security_group_ipset_name=sample
&zone=pek3a
&COMMON_PARAMS

Example Response:

{
  "action":"ModifySecurityGroupIPSetAttributesResponse",
  "security_group_ipset_id":"sgi-rtyv0968",
  "ret_code":0
}

Security: ModifySecurityGroupRuleAttributes

Mon, 01 Jan 0001 00:00:00 +0000

修改防火墙规则的优先级。

注解

修改规则后，记得调用 ApplySecurityGroup 使其生效。

Request Parameters

Parameter name	Type	Description	Required
security_group_rule	String	防火墙规则ID	Yes
security_group_rule_name	String	防火墙规则名称	No
priority	Integer	优先级，由高到低为 0 - 100	No
rule_action	String	行为：accept 表示接受，drop 为拒绝	No
direction	Integer	方向，0 表示下行，1 表示上行。	No
protocol	String	协议，目前支持 tcp, udp, icmp, gre, esp, ah, ipip	No
val1	String	如果协议为 tcp 或 udp，此值表示起始端口。如果协议为 icmp，此值表示 ICMP 类型，具体类型可参见 ICMP 类型及代码。其他协议无需此值。	No
val2	String	如果协议为 tcp 或 udp，此值表示结束端口。如果协议为 icmp，此值表示 ICMP 代码，具体代码可参见 ICMP 类型及代码。其他协议无需此值。	No
val3	String	目标 IP，如果填写，则这条防火墙规则只对此IP（或IP段）有效。	No
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_rule_id	String	成功修改的防火墙规则ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=ModifySecurityGroupRuleAttributes
&security_group_rule=sgr-13cooxdd
&security_group_rule_name=demo_rule
&priority=13
&COMMON_PARAMS

Example Response:

{
  "action":"ModifySecurityGroupRuleAttributesResponse",
  "security_group_rule_id":"sgr-13cooxdd",
  "ret_code":0
}

Security: RollbackSecurityGroup

Mon, 01 Jan 0001 00:00:00 +0000

使用防火墙备份回滚。

注解

回滚规则后，记得调用 ApplySecurityGroup 使其生效。

Request Parameters

Parameter name	Type	Description	Required
security_group	String	防火墙ID	Yes
security_group_snapshot	String	防火墙备份ID	Yes
zone	String	区域 ID，注意要小写	Yes

公共参数

Response Elements

Name	Type	Description
action	String	响应动作
security_group_id	String	防火墙ID
security_group_snapshot_id	String	防火墙备份ID
ret_code	Integer	执行成功与否，0 表示成功，其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=RollbackSecurityGroup
&security_group_snapshot=sgs-wx55xhix
&security_group=sg-q36kwq5r
&COMMON_PARAMS

Example Response:

{
  "action":"RollbackSecurityGroupResponse",
  security_group_id: "sg-q36kwq5r",
  security_group_snapshot_id: "sgs-hycrez7a",
  "ret_code":0
}