金山云-文档中心-批量添加安全组规则

边缘节点计算

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

边缘节点计算

开发参考

边缘云主机OpenAPI

安全组相关接口

批量添加安全组规则

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



接口描述

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

您可以通过该接口向指定安全组批量添加安全组规则。

请求方式

POST

请求头

参数名称	类型	是否必须	描述
X-Version	String	是	版本号，取值：2020-08-01
X-Action	String	是	操作接口名，取值：CreateSecurityGroupPolicies

请求body

参数名称	类型	是否必须	示例值	描述
SecurityGroupId	String	是	sg-mm4wmmjzgntgcntg	安全组ID
Policies	[]SecurityGroupPolicy	是		安全组规则的数组

SecurityGroupPolicy

参数名称	类型	是否必须	示例值	描述
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四种状态
SecurityPolicyId	String	10000	创建的安全组策略ID
Message	String	2001:Invalid param NamespaceId	参看消息码列表，该参数在Code为非Success时出现，用于描述返回异常原因

请求示例

入参示例

curl --location --request POST 'kenc.api.ksyun.com?NamespaceId=demo' \
--header 'X-Action: CreateSecurityGroupPolicies' \
--header 'X-Version: 2020-08-01' \
--header 'X-Amz-Date: 20210226T033304Z' \
--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":[{"Description":"policy 001","Direction":"in","Protocol":"tcp","CidrBlock":"0.0.0.0/0","DestinationPortRangeFrom":1,"DestinationPortRangeTo":10},{"Description":"policy 002","Direction":"in","Protocol":"tcp","CidrBlock":"0.0.0.0/0","DestinationPortRangeFrom":80,"DestinationPortRangeTo":10080},{"SecurityGroupId":"sg-mm4wmmjzgntgcntg","Description":"policy 003","Direction":"in","Protocol":"tcp","CidrBlock":"0.0.0.0/0","DestinationPortRangeFrom":40,"DestinationPortRangeTo":10040}]}'

成功示例

{
    "Code": "Success",
    "RequestId": "942fa76d-f839-452e-add4-0c73cfbb47ba",
    "SecurityGroupPolicyIds":[10001,10002]
}

失败示例

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

文档导读

上一篇：查询安全组规则

下一篇：批量修改安全组规则

纯净模式常规模式

纯净模式

点击可全屏预览文档内容