全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

批量修改安全组规则

最近更新时间:2025-09-02 19:16:25

接口描述

通过批量接口操作安全组规则时,要么全部操作成功,要么全部操作失败。

您可以通过该接口批量修改指定安全组的安全组规则。

请求方式

POST

请求头

参数名称

类型

是否必须

描述

X-Version

String

版本号,取值:2020-08-01

X-Action

String

操作接口名,取值:ModifySecurityGroupPolicies

请求body

参数名称

类型

是否必须

示例值

描述

SecurityGroupId

String

sg-mm4wmmjzgntgcntg

安全组ID

Policies

[]SecurityGroupPolicy

安全组规则的数组

SecurityGroupPolicy

参数名称

类型

是否必须

示例值

描述

Id

String

10001

安全组规则ID

Direction

String

in

入向

CidrBlock

String

10.0.0.0/8

安全组规则网段

Protocol

String

ip,tcp,udp,icmp

协议,IP代表所有协议

PortRangeFrom

Integer

1-65535

TCP或者UDP协议的端口规则的起始端口,范围为1-65535,只有协议为TCP/UDP类型时,才必填

PortRangeTo

Integer

1-65535

TCP或者UDP协议的端口规则结束端口,范围为1-65535,只有协议为TCP/UDP类型时,才必填

Description

String

-

安全组规则描述,命名规则为:长度不大于128个英文或中文字符;如果没有指定该参数,默认值为空

返回参数

参数名称

类型

示例值

描述

RequestID

String

3a87cc31-efe6-487c-b28b-11bec3571e7d

请求ID

Code

String

Success

状态码,有InvalidParameter,Forbidden InternalError,Success四种状态

请求示例

入参示例

curl --location --request POST 'kenc.api.ksyun.com?NamespaceId=demo' \
--header 'X-Action: ModifySecurityGroupPolicies' \
--header 'X-Version: 2020-08-01' \
--header 'X-Amz-Date: 20210226T034130Z' \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=xxx/20210226/beijing-6/kenc/aws4_request, SignedHeaders=host;x-action;x-amz-date;x-version, Signature=xxx'
--data '{"SecurityGroupId":"sg-mm4wmmjzgntgcntg","Policies":[{"Id":"10008","Description":"policy 001 -- modify","Direction":"in","Protocol":"tcp","CidrBlock":"0.0.0.0/0","DestinationPortRangeFrom":100,"DestinationPortRangeTo":1000},{"Id":"10009","Description":"policy 002 -- modify","Direction":"in","Protocol":"tcp","CidrBlock":"0.0.0.0/0","DestinationPortRangeFrom":800,"DestinationPortRangeTo":8000},{"Id":"10010","Description":"policy 003 -- modify","Direction":"in","Protocol":"tcp","CidrBlock":"0.0.0.0/0","DestinationPortRangeFrom":400,"DestinationPortRangeTo":4000}]}'

成功示例

{
    "Code": "Success",
    "RequestId": "942fa76d-f839-452e-add4-0c73cfbb47ba"
}

失败示例

{
    "RequestId": "b2c0798c-30ab-4059-a723-13082775fa7d",
    "Code": "InvalidParameter",
    "Message": "Invalid param SecurityGroupPolicyId."
}

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈