私有网络
私有网络
文档指南
请输入
- 文档首页
私有网络API参考安全组ModifySecurityGroupIngressBatch-修改多条入方向安全组规则
复制全文
下载 pdfModifySecurityGroupIngressBatch-修改多条入方向安全组规则
文档反馈
问问助手调用 ModifySecurityGroupIngressBatch 接口，修改多条入方向安全组规则。
使用说明
- Permissions.N.a 中的N：表示安全组规则的序号，单次调用数量上限为100个。
- 多条安全组规则之间用&分隔。
- 以下可选参数如不配置，则保持原有配置。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action String 必选 示例值：ModifySecurityGroupIngressBatch
接口名称。当前 API 的名称为ModifySecurityGroupIngressBatch。
Version String 必选 示例值：2020-04-01
接口版本。当前 API 的版本为 2020-04-01。
SecurityGroupId String 必选 示例值：sg-bp1fg655nh68xyz9****
安全组ID。
Permissions.N.SecurityGroupRuleId String 必选 示例值：sgr-bp12kc4rqohaf2js****
入方向安全组规则的 ID。
Permissions.N.Policy String 可选 示例值：accept
访问策略。取值如下：
- accept：允许。
- drop：拒绝。
Permissions.N.Priority Integer 可选 示例值：100
安全组规则优先级。
- 数字越小，代表优先级越高。
- 取值范围：1 ~ 100。
Permissions.N.Protocol String 可选 示例值：tcp
协议类型。取值如下：
- tcp：TCP协议。
- udp：UDP协议。
- icmp：ICMP协议。
- gre：GRE协议。
- all：支持以上所有协议。
Permissions.N.PortStart Integer 可选 示例值：22
目的端口范围开始值。
- 当Protocol 传入tcp或udp时，取值范围为1~65535。
- 当Protocol 传入icmp或all时，仅支持传入-1，表示不限制端口。
Permissions.N.PortEnd Integer 可选 示例值：22
目的端口范围结束值。
- 当Protocol 传入tcp或udp时，取值范围为1~65535。
- 当Protocol 传入icmp或all时，仅支持传入-1，表示不限制端口。
Permissions.N.CidrIp String 可选 示例值：10.XX.XX.0/8
源地址的IPv4 CIDR。
支持CIDR块和IPv4地址格式。
说明
参数Permissions.N.CidrIp、Permissions.N.SourceGroupId和 Permissions.N.PrefixListId，三者必须传入一个。若传入多个，仅生效一个，生效的优先级为CidrIp > SourceGroupId > PrefixListId。
Permissions.N.SourceGroupId String 可选 示例值：sg-bp67acfmxazb4p****
源地址安全组ID。即该安全组中的所有网卡的地址作为源地址。
说明
参数Permissions.N.CidrIp、Permissions.N.SourceGroupId和 Permissions.N.PrefixListId，三者必须传入一个。若传入多个，仅生效一个，生效的优先级为CidrIp > SourceGroupId > PrefixListId。
Permissions.N.PrefixListId String 可选 示例值：pl-bp1fg655nh68xyz9****
源地址前缀列表的ID。即前缀列表中的CIDR均为源地址。
说明
- 当前安全组还可添加出方向安全组规则的数量不小于前缀列表最大条目数。
- 参数Permissions.N.CidrIp、Permissions.N.SourceGroupId和 Permissions.N.PrefixListId，三者必须传入一个。若传入多个，仅生效一个，生效的优先级为CidrIp > SourceGroupId > PrefixListId。
Permissions.N.Description String 可选 示例值：SG-Engress-1
安全组规则的描述信息。
- 需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（ ）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。
- 长度限制为0～255个字符。
Permissions.N.SourcePortStart Integer 可选 示例值：80
源地址端口范围开始值。
- 当Protocol 传入tcp或udp时，取值范围为1~65535。
- 当Protocol 传入icmp或all时，仅支持传入-1，表示不限制端口。
说明
五元组安全组正在邀测中，如需试用，请联系客户经理。
Permissions.N.SourcePortEnd Integer 可选 示例值：80
源地址端口范围结束值。
- 当Protocol 传入tcp或udp时，取值范围为1~65535。
- 当Protocol 传入icmp、icmpv6或all时，仅支持传入-1，表示不限制端口。
说明
五元组安全组正在邀测中，如需试用，请联系客户经理。
Permissions.N.LocalCidrIp String 可选 示例值：192.168.1.0/24
目的IPv4地址范围。
支持CIDR块和IPv4地址格式。
返回参数
AsyncTaskId String 示例值：asynctask-13f0odozfrdvk3n6nu41l****
异步任务的 ID。
RequestId String 示例值：0ED8D006-F706-4D23-88ED-E11ED28D****
请求 ID。
请求示例
GET /?Action=ModifySecurityGroupIngressBatch&Version=2020-04-01&SecurityGroupId=sg-bp1fg655nh68xyz9****&Permissions.1.SecurityGroupRuleId=sgr-bp12kc4rqohaf2js****&Permissions.1.Policy=accept&Permissions.1.Priority=100&Permissions.1.Protocol=tcp&Permissions.1.PortStart=22&Permissions.1.PortEnd=22&Permissions.1.CidrIp=10.XX.XX.0/8&Permissions.1.SourceGroupId=sg-bp67acfmxazb4p****&Permissions.1.PrefixListId=pl-bp1fg655nh68xyz9****&Permissions.1.Description=SG-Engress-1&Permissions.1.SourcePortStart=80&Permissions.1.SourcePortEnd=80&Permissions.1.LocalCidrIp=192.168.1.0/24 HTTP/1.1
Host: vpc.cn-beijing.volcengineapi.com
X-Date: 20250804T033538Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250804/cn-beijing/vpc/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
返回示例
{
"ResponseMetadata": {
"RequestId": "20230604110420****100232280022D31",
"Action": "ModifySecurityGroupIngressBatch",
"Version": "2020-04-01",
"Service": "vpc",
"Region": "cn-beijing"
},
"Result": {
"AsyncTaskId": "asynctask-13f0odozfrdvk3n6nu41l****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****"
}
}
错误码
最近更新时间：2026.10.09 17:13:25
这个页面对您有帮助吗？
有用
有用
无用
无用