You need to enable JavaScript to run this app.
导航
RevokeSecurityGroupEgress
最近更新时间:2024.11.15 09:39:38首次发布时间:2021.07.29 14:11:53

调用 RevokeSecurityGroupEgress 接口,删除一条安全组出方向规则。

调试

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringRevokeSecurityGroupEgress系统规定参数。取值:RevokeSecurityGroupEgress。
VersionString2020-04-01API版本信息,取值为:2020-04-01。

SecurityGroupId

String

sg-bp67acfmxazb4p****

安全组ID。
您可以调用 DescribeSecurityGroups 接口,查询安全组的ID。

Protocol

String

all

协议类型。取值如下:

  • tcp:TCP协议。
  • udp:UDP协议。
  • icmp:ICMP协议。
  • icmpv6:ICMPV6协议。

    说明

    IPv6功能正在邀测中,暂仅支持完成 企业认证 的账号申请试用,如需试用,请联系客户经理。

  • all:支持所有协议。

PortStart

Integer

22

端口范围开始值。

  • Protocol 传入tcp或udp时,取值范围为1~65535。
  • Protocol 传入icmp、icmpv6或all时,仅支持传入-1,表示不限制端口。

PortEnd

Integer

22

端口范围结束值。

  • Protocol 传入tcp或udp时,取值范围为1~65535。
  • Protocol 传入icmp、icmpv6或all时,仅支持传入-1,表示不限制端口。

CidrIp

String

10.XX.XX.0/8

目的地址的IPv4 CIDR或IPv6 CIDR。

说明

参数CidrIpSourceGroupIdPrefixListId,三者必须传入一个。若传入多个,仅生效一个,生效的优先级为CidrIp > SourceGroupId > PrefixListId

SourceGroupId

String

sg-bp67acfmxazb4p****

目的地址安全组ID。即该安全组中的所有网卡的地址作为目的地址。

说明

参数CidrIpSourceGroupIdPrefixListId,三者必须传入一个。若传入多个,仅生效一个,生效的优先级为CidrIp > SourceGroupId > PrefixListId

PrefixListId

String

pl-bp1fg655nh68xyz9****

目的地址前缀列表的ID。即前缀列表中的CIDR均为目的地址。
您可以调用 DescribePrefixLists 接口,查询前缀列表的ID。

说明

  • 当前安全组还可添加出方向安全组规则的数量不小于前缀列表最大条目数。
  • 参数CidrIpSourceGroupIdPrefixListId,三者必须传入一个。若传入多个,仅生效一个,生效的优先级为CidrIp > SourceGroupId > PrefixListId

Policy

String

accept

访问策略。即安全组内的网卡访问CidrIpSourceGroupIdPrefixListId 对应的资源。

  • accept: 允许。
  • drop:拒绝。

Priority

Integer

1

安全组规则优先级,数字越小,优先级越高。

  • 取值范围:1 ~ 100
  • 不填默认值为1。

    说明

    若待删除安全组规则的优先级不为1,则必须传入本参数。

DescriptionStrings_g_egress_1安全组规则的描述信息。

返回数据

参数名称
类型
示例值
描述
RequestIdString2021062415303301022514515207C4****请求ID。

请求示例

GET /?Action=RevokeSecurityGroupEgress&Version=2020-04-01&SecurityGroupId=sg-bp67acfmxazb4p****&Protocol=tcp&PortStart=22&PortEnd=22&CidrIp=10.XX.XX.0/8&Policy=accept&Priority=1 HTTP/1.1
Host: open.volcengineapi.com
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "RevokeSecurityGroupEgress",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },
   "Result": {
        "RequestId": "2021062415303301022514515207C4****"
    }
}

错误码

此处仅展示当前API的错误码,更多错误码请参见公共错误码

HttpCode
错误码
错误信息
描述
400InvalidCidr.MalformedThe specified cidr block is malformed.指定的网段格式不合法。
400InvalidCidr.ProtocolMismatchThe specified cidr block mismatch the protocol type.指定的网段格式和协议类型不匹配。
400InvalidDescription.MalformedThe specified description is malformed. Ensure the maximum length of description is 255.指定的描述格式不合法。描述长度不能超过255个字符。
400InvalidDescription.MalformedThe specified description is malformed.指定的描述格式不合法。请修复描述格式后重试。
400InvalidRouteCidr.MalformedThe specified CIDR is malformed.指定的网段不合法。
400InvalidSecurityGroup.InvalidStatusThe specified security group is not in the correct status for the request.指定的安全组所处的状态无法响应该请求。
400InvalidSecurityGroup.VpcMismatchThe specified source security group is not in the specified VPC.指定的引用安全组不在指定的VPC中。
400InvalidSecurityRule.InvalidSourceStatusThe specified source security group is not in the correct status for the request.指定安全组规则对应的源安全组所处的状态无法响应该请求。
400InvalidSecurityRule.InvalidStatusThe specified security rule is not in the correct status for the request.指定的安全组规则所处状态无法响应该请求。
400InvalidSecurityRulePolicy.MalformedThe specified security rule policy is malformed.指定的安全组规则的行为不合法。
400InvalidSecurityRulePort.MalformedThe specified security rule port is malformed.指定的安全组规则的端口不合法。
400InvalidSecurityRulePriority.MalformedThe specified security rule priority is malformed.指定的安全组规则的优先级不合法。
400InvalidSecurityRuleProtocol.MalformedThe specified security rule protocol is malformed.指定的安全组规则的协议不合法。
403ForbiddenYou are not authorized to perform operations on the specified security group. The specified security group is a service-managed security group.无权限对指定安全组进行操作。指定的安全组为云产品托管的安全组。
404InvalidPrefixList.NotFoundThe specified prefix list does not exist.指定的前缀列表不存在。
404InvalidPrefixListAssociation.NotFoundThe specified prefix list is not associated with the specified resource.指定的前缀列表未被该资源引用。
404InvalidSecurityGroupId.NotFoundThe specified security group does not exist.指定的安全组不存在。
404InvalidSecurityRule.NotFoundThe specified security rule does not exist.指定的安全组规则不存在。