本接口用于删除指定安全组内的一条或多条出方向安全组规则。
接口说明
注意 阿里云已于 2024 年 7 月 8 日对该接口进行了校验规则调整。当删除不存在的安全组规则时，从返回成功调整为返回错误码：“InvalidSecurityGroupRule.RuleNotExist“。请您及时做好错误码兼容，避免影响线上业务。
-
通过指定安全组规则 ID 参数删除规则（推荐）。
- 如果指定的安全组规则 ID 不存在，会报异常。
-
通过指定 Permissions 参数删除规则。
- 如果匹配的安全组规则不存在，此次调用成功，但不会删除规则。
- 删除一条安全组规则必要的相关参数：
- 目的端设置：选择 DestCidrIp（IPv4 地址）、Ipv6DestCidrIp（IPv6 地址）、DestPrefixListId（前缀列表 ID）、DestGroupId（目的端安全组）中的一项。
- 目的端口范围：PortRange。
- 协议类型：IpProtocol。
- 权限策略：Policy。
说明
不支持同时设置安全组规则 ID 和 Permissions 参数。
请求示例
- 根据安全组规则 ID 删除。
"SecurityGroupId":"sg-bp67acfmxazb4p****", //设置安全组 ID
"SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] //设置安全组规则 ID
- 根据 IP 地址段删除。
"SecurityGroupId":"sg-bp67acfmxazb4ph***",
"Permissions":[
{
"IpProtocol":"TCP", //设置协议类型
"DestCidrIp":"10.0.0.0/8", //设置目的端 IP 地址段
"PortRange":"22/22", //设置目的端口范围
"Policy":"accept" // 设置访问策略
}
]
- 根据目的端安全组删除。
"SecurityGroupId":"sg-bp67acfmxazb4ph***",
"Permissions":[
{
"DestGroupId":"sg-bp67acfmxa123b****", //设置目的端安全组 ID
"IpProtocol":"TCP",
"PortRange":"22/22",
"Policy":"accept"
}
]
- 根据指定前缀列表删除。
"SecurityGroupId":"sg-bp67acfmxazb4ph***",
"Permissions":[
{
"IpProtocol":"TCP",
"DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置目的端前缀列表 ID
"PortRange":"22/22",
"Policy":"accept",
}
]
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| ecs:RevokeSecurityGroupEgress | delete | *SecurityGroup acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 安全组所属地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| ClientToken | string | 否 | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多详情，请参见如何保证幂等性。 | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| SecurityGroupId | string | 是 | 安全组 ID。 | sg-bp67acfmxazb4p**** |
| SecurityGroupRuleId | array | 否 | 安全组规则 ID 数组。数组长度：0~100。 | |
| string | 否 | 安全组规则 ID。 说明
通过安全组规则 ID 删除时，该参数必填。
| sgr-bp67acfmxa123b*** | |
| Permissions | array<object> | 否 | 安全组规则数组。数组长度：0~100。 | |
| object | 否 | 安全组规则。 | ||
| Policy | string | 否 | 访问权限。取值范围：
默认值：accept。 | accept |
| Priority | string | 否 | 安全组规则优先级。数字越小，代表优先级越高。取值范围：1~100。 默认值：1。 | 1 |
| IpProtocol | string | 否 | 协议类型。取值不区分大小写。取值范围：
| TCP |
| DestCidrIp | string | 否 | 需要撤销访问权限的目的端 IPv4 CIDR 地址块。支持 CIDR 格式和 IPv4 格式的 IP 地址范围。 | 10.0.0.0/8 |
| Ipv6DestCidrIp | string | 否 | 需要撤销访问权限的目的端 IPv6 CIDR 地址块。支持 CIDR 格式和 IPv6 格式的 IP 地址范围。 说明
仅在支持 IPv6 的 VPC 类型 ECS 实例上有效，且该参数与 DestCidrIp参数不可同时设置。
| 2001:db8:1233:1a00::*** |
| DestGroupId | string | 否 | 需要撤销访问权限的目的端安全组 ID。
您需要注意：
| sg-bp67acfmxa123b**** |
| DestPrefixListId | string | 否 | 需要撤销访问权限的目的端前缀列表。您可以调用 DescribePrefixLists 查询可以使用的前缀列表 ID。 注意事项：
| pl-x1j1k5ykzqlixdcy**** |
| PortRange | string | 否 | 安全组开放的各协议相关的目的端口范围。取值范围：
| 22/22 |
| SourceCidrIp | string | 否 | 源端 IPv4 CIDR 地址段。支持 CIDR 格式和 IPv4 格式的 IP 地址范围。 用于支持五元组规则，请参见安全组五元组规则。 | 10.0.0.0/8 |
| Ipv6SourceCidrIp | string | 否 | 源端 IPv6 CIDR 地址段。支持 CIDR 格式和 IPv6 格式的 IP 地址范围。 用于支持五元组规则，请参见安全组五元组规则。 说明
仅在支持 IPv6 的 VPC 类型 ECS 实例上有效，且该参数与 DestCidrIp参数不可同时设置。
| 2001:db8:1234:1a00::*** |
| SourcePortRange | string | 否 | 安全组开放的各协议相关的源端端口范围。取值范围：
用于支持五元组规则，请参见安全组五元组规则。 | 22/22 |
| DestGroupOwnerAccount | string | 否 | 撤销跨账户授权的安全组规则时，目的端安全组所属的阿里云账户。
| Test@aliyun.com |
| DestGroupOwnerId | string | 否 | 撤销跨账户授权的安全组规则时，目的端安全组所属的阿里云账户。
| 12345678910 |
| NicType | string | 否 | 经典网络类型安全组规则的网卡类型。取值范围：
专有网络 VPC 类型安全组规则无需设置网卡类型，默认为 intranet，只能为 intranet。 撤销安全组之间授权规则，即指定了 默认值：internet。 | intranet |
| Description | string | 否 | 安全组规则的描述。长度为 1~512 个字符。 | This is description. |
Policydeprecated | string | 否 | 已废弃。请使用 | accept |
Prioritydeprecated | string | 否 | 已废弃。请使用 | 1 |
IpProtocoldeprecated | string | 否 | 已废弃。请使用 | TCP |
DestCidrIpdeprecated | string | 否 | 已废弃。请使用 | 10.0.0.0/8 |
Ipv6DestCidrIpdeprecated | string | 否 | 已废弃。请使用 | 2001:db8:1233:1a00::*** |
DestGroupIddeprecated | string | 否 | 已废弃。请使用 | sg-bp67acfmxa123b**** |
DestPrefixListIddeprecated | string | 否 | 已废弃。请使用 | pl-x1j1k5ykzqlixdcy**** |
PortRangedeprecated | string | 否 | 已废弃。请使用 | 22/22 |
SourceCidrIpdeprecated | string | 否 | 已废弃。请使用 | 10.0.0.0/8 |
Ipv6SourceCidrIpdeprecated | string | 否 | 已废弃。请使用 | 2001:db8:1234:1a00::*** |
SourcePortRangedeprecated | string | 否 | 已废弃。请使用 | 22/22 |
DestGroupOwnerAccountdeprecated | string | 否 | 已废弃。请使用 | Test@aliyun.com |
DestGroupOwnerIddeprecated | long | 否 | 已废弃。请使用 | 12345678910 |
NicTypedeprecated | string | 否 | 已废弃。请使用 | intranet |
Descriptiondeprecated | string | 否 | 已废弃。请使用 | This is description. |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidIpProtocol.ValueNotSupported | The parameter IpProtocol must be specified with case insensitive TCP, UDP, ICMP, GRE or All. | 协议类型只能是TCP、UDP、ICMP、GRE或者All。 |
| 400 | InvalidIpPortRange.Malformed | The specified parameter PortRange is not valid. | IP协议相关的端口号范围格式不正确。 |
| 400 | InvalidDestCidrIp.sMalformed | The specified parameter DestCidrIp is not valid. | 指定的参数 DestCidrIp 不合法。 |
| 400 | MissingParameter | The input parameter DestGroupId or DestCidrIp cannot be both blank. | 参数 DestGroupId 和 DestCidrIp 不得为空。 |
| 400 | InvalidPolicy.Malformed | The specified parameter %s is not valid. | 指定的授权策略参数Policy不合法。 |
| 400 | InvalidNicType.ValueNotSupported | The specified parameter %s is not valid. | 指定的网卡类型参数NicType不合法。 |
| 400 | InvalidDestGroupId.Mismatch | Specified security group and destination group are not in the same VPC. | 指定的安全组和目标组不在同一个 VPC 下。 |
| 400 | InvalidDestCidrIp.Malformed | The specified parameter DestCidrIp is not valid. | 指定的 DestCidrIp 无效，请您检查该参数是否正确。 |
| 400 | MissingParameter.Dest | One of the parameters DestCidrIp, Ipv6DestCidrIp, DestGroupId or DestPrefixListId in %s must be specified. | 请指定参数DestCidrIp，Ipv6DestCidrIp，DestGroupId或DestPrefixListId中的至少一个。 |
| 400 | InvalidParam.PortRange | The specified parameter %s is not valid. It should be two integers less than 65535 in ?/? format. | 端口范围不合法，应为斜线分隔两个整数的格式。 |
| 400 | InvalidIpProtocol.ValueNotSupported | The parameter %s must be specified with case insensitive TCP, UDP, ICMP, GRE or All. | 协议Protocol字段不合法，应指定大小写不敏感的TCP，UDP，ICMP，GRE或All。 |
| 400 | InvalidPriority.Malformed | The parameter Priority is invalid. | 指定的参数 Priority 无效。 |
| 400 | InvalidPriority.ValueNotSupported | The specified parameter %s is invalid. | 指定的优先级参数Priority不合法。 |
| 400 | InvalidParam.SourceIp | The Parameters SourceCidrIp and Ipv6SourceCidrIp in %s cannot be set at the same time. | 参数SourceCidrIp和Ipv6SourceCidrIp不能被同时设置。 |
| 400 | InvalidParam.DestIp | The Parameters DestCidrIp and Ipv6DestCidrIp in %s cannot be set at the same time. | 参数DestCidrIp和Ipv6DestCidrIp不能被同时设置。 |
| 400 | InvalidParam.Ipv6DestCidrIp | The specified parameter %s is not valid. | 指定的参数Ipv6DestCidrIp不合法。 |
| 400 | InvalidParam.Ipv6SourceCidrIp | The specified parameter %s is not valid. | 指定的参数Ipv6SourceCidrIp不合法。 |
| 400 | InvalidParam.Ipv4ProtocolConflictWithIpv6Address | IPv6 address cannot be specified for IPv4-specific protocol. | IPv4协议不能指定IPv6地址。 |
| 400 | InvalidParam.Ipv6ProtocolConflictWithIpv4Address | IPv4 address cannot be specified for IPv6-specific protocol. | IPv6协议不能指定IPv4地址。 |
| 400 | InvalidParameter.Ipv6CidrIp | The specified Ipv6CidrIp is not valid. | 指定的Ipv6CidrIp参数不合法。 |
| 400 | InvalidGroupAuthParameter.OperationDenied | The security group can not authorize to enterprise level security group. | 安全组不能授权给企业级安全组。 |
| 400 | InvalidSecurityGroupId.Malformed | The specified parameter SecurityGroupId is not valid. | 指定的参数 SecurityGroupId 无效。 |
| 400 | InvalidPortRange.Malformed | The specified parameter PortRange must set. | 参数PortRange必须被设置。 |
| 400 | InvalidSourcePortRange.Malformed | The specified parameter SourcePortRange is not valid. | 指定的参数 SourcePortRange 无效。 |
| 400 | InvalidSecurityGroupDiscription.Malformed | The specified security group rule description is not valid. | 指定的安全组规则描述不合法。 |
| 400 | NotSupported.ClassicNetworkPrefixList | The prefix list is not supported when the network type of security group is classic. | 安全组的网络类型为经典网络，不支持前缀列表。 |
| 400 | InvalidParam.SourceCidrIp | The specified parameter %s is not valid. | 指定的参数SourceCidrIp不合法。 |
| 400 | InvalidParam.SourceCidrIp | The specified param SourceCidrIp is not valid. | 参数SourceCidrIp不合法。 |
| 400 | InvalidParam.DestCidrIp | The specified parameter %s is not valid. | 指定的参数DestCidrIp不合法。 |
| 400 | InvalidParam.DestCidrIp | The specified parameter DestCidrIp is invalid. | 指定的参数“DestCidrIp”无效。 |
| 400 | InvalidParam.Permissions | The specified parameter Permissions cannot coexist with other parameters. | 指定的参数Permissions不能与其他参数同时存在。 |
| 400 | InvalidParam.DuplicatePermissions | There are duplicate permissions in the specified parameter Permissions. | 指定的参数Permissions中存在重复的规则。 |
| 400 | InvalidParam.SecurityGroupRuleId | The specified parameter SecurityGroupRuleId is not valid. | 指定的参数SecurityGroupRuleId不合法。 |
| 400 | InvalidParam.SecurityGroupRuleIdRepeated | The specified parameter SecurityGroupRuleId is repeated. | 指定的参数SecurityGroupRuleId存在重复。 |
| 400 | InvalidGroupParameter.OperationDenied | The attributes Policy, SourceGroupId, DestGroupId of enterprise level security groups are not allowed to be set or modified. | 企业级安全组不能指定Policy，SourceGroupId，DestGroupId等参数。 |
| 400 | InvalidSecurityGroupRule.RuleNotExist | The specified rule does not exist. | 指定的安全组规则不存在。 |
| 401 | InvalidOperation.SecurityGroupNotAuthorized | The specified security group is not authorized to operate. | 没有权限操作当前安全组 |
| 403 | InvalidNicType.Mismatch | Specified nic type conflicts with the authorization record. | 指定的 NIC 类型与规则信息冲突。 |
| 403 | InvalidGroupAuthItem.NotFound | Specified group authorized item does not exist in our records. | 指定的组授权条目不存在。 |
| 403 | InvalidSecurityGroup.IsSame | The authorized SecurityGroupId should be different from the DestGroupId. | 已授权的 SecurityGroupId 不能与 DestGroupId 相同。 |
| 403 | InvalidParamter.Conflict | The specified SecurityGroupId should be different from the SourceGroupId. | 授权与被授权安全组必须不同。 |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | %s | 云产品托管的安全组不支持修改操作。 |
| 404 | InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | 指定的安全组在该用户账号下不存在，请您检查安全组 ID 是否正确。 |
| 404 | InvalidDestGroupId.NotFound | The DestGroupId provided does not exist in our records. | 指定的出方向安全组不存在。 |
| 404 | InvalidSecurityGroupRuleId.NotFound | The specified SecurityGroupRuleId is not exists. | 指定的SecurityGroupRuleId不存在。 |
| 404 | InvalidPrefixListId.NotFound | The specified prefix list was not found. | 前缀列表不存在。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-12-04 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-06-20 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-11-21 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-04-07 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2022-09-05 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2022-07-13 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2022-05-07 | OpenAPI 错误码发生变更 | 查看变更详情 |