刪除一條安全性群組出方向規則，撤銷安全性群組出方向的存取權限。

描述

我們定義出方向流量的發起端為源端（Source），資料轉送的接收端為目的端（Destination）。更多詳情，請參閱 AuthorizeSecurityGroupEgress。

以下任意一組參數可以確定一條安全性群組出方向規則，只指定一個參數無法確定一條安全性群組規則。

  • 撤銷對指定 IP 位址段的存取權限，如 請求樣本一 ：IpProtocol、PortRange、（可選）SourcePortRange、NicType、Policy、DestCiderIp 和 （可選）SourceCidrIp

  • 撤銷對其他安全性群組的存取權限，如 請求樣本二：IpProtocol、PortRange、（可選）SourcePortRange、NicType、Policy、（可選）DestCiderIp、DestGroupOwnerAccount 和 DestGroupId

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：RevokeSecurityGroupEgress
RegionId String 是 源端安全性群組所屬地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
SecurityGroupId String 是 源端安全性群組 ID。
IpProtocol String 是 傳輸層協議。不區分大小寫。取值範圍：
  • icmp
  • gre
  • tcp
  • udp
  • all：支援所有協議
PortRange String 是 目的端安全性群組開放的傳輸層協議相關的通信埠範圍。取值範圍：
  • TCP/UDP 協議：取值範圍為 [1, 65535] 。使用斜線（/）隔開開始端點口和終止通信埠。正確示範：1/200；錯誤示範：200/1。
  • ICMP 協議：-1/-1。
  • GRE 協議：-1/-1。
  • all：-1/-1。
SourcePortRange String 否 源端安全性群組開放的傳輸層協議相關的通信埠範圍。取值範圍：
  • TCP/UDP 協議：取值範圍為 [1, 65535] 。使用斜線（/）隔開開始端點口和終止通信埠。正確示範：1/200；錯誤示範：200/1。
  • ICMP 協議：-1/-1。
  • GRE 協議：-1/-1。
  • all：-1/-1。
NicType String 否 網卡類型。取值範圍：
  • internet：公網網卡。
  • intranet：內網網卡。
當撤銷安全性群組之間互相訪問時，即指定了 DestGroupId 且沒有指定 DestCidrIp 時，參數 NicType 取值只能為 intranet。 預設值：internet
Policy String 否 存取權限。取值範圍：
  • accept：接受訪問。
  • drop：拒絕訪問，不發回拒絕資訊。
預設值：accept
DestCidrIp String 否 目的端 IP 位址範圍。支援 CIDR 格式和 IPv4 格式的 IP 位址範圍。預設值：0.0.0.0/0
SourceCidrIp String 否 源端 IP 位址範圍。支援 CIDR 格式和 IPv4 格式的 IP 位址範圍。預設值：0.0.0.0/0
DestGroupId String 否 需要撤銷存取權限的目的端安全性群組 ID。必須設定 DestGroupId 或者 DestCidrIp 參數。如果指定了 DestGroupId 沒有指定參數 DestCidrIp，則參數 NicType 取值只能為 intranet。如果同時指定了 DestGroupId 和 DestCidrIp，則預設以 DestCidrIp 為準。
DestGroupOwnerAccount String 否 跨賬戶刪除安全性群組規則時，目的端安全性群組所屬的阿里雲賬戶。
  • 如果 DestGroupOwnerAccount 及 DestGroupOwnerId 均未設定，則認為是撤銷您其他安全性群組的存取權限。
  • 如果已經設定參數 DestCidrIp，則參數 DestGroupOwnerAccount 無效。
DestGroupOwnerId String 否 跨賬戶刪除安全性群組規則時，目的端安全性群組所屬的阿里雲賬戶 ID。
  • 如果 DestGroupOwnerId 及 DestGroupOwnerAccount 均未設定，則認為是撤銷您其他安全性群組的存取權限。
  • 如果您已經設定參數 DestCidrIp，則參數 DestGroupOwnerId 無效。
Priority String 否 安全性群組規則優先順序。取值範圍：[1, 100]

預設值：1

返回參數

全是公共返回參數。參閱 公共參數。

樣本

請求樣本一

撤銷對指定 IP 位址段的存取權限。

https://ecs.aliyuncs.com/?Action=RevokeSecurityGroupEgress
&SecurityGroupId=sg-94n63e80l
&IpProtocol=all
&DestCidrIp=10.0.0.0/8
&PortRange=-1/-1
&NicType=intranet
&Policy=Allow
&<公共請求參數>

請求樣本二

撤銷對其他安全性群組的存取權限。

https://ecs.aliyuncs.com/?Action=RevokeSecurityGroupEgress
&SecurityGroupId=sg-F876FF7BA
&DestGroupId=sg-1651FBB64
&DestGroupOwnerAccount=test@aliyun.com
&IpProtocol=tcp
&PortRange=22/22
&NicType=intranet
&Policy=Drop
&<公共請求參數>
返回樣本

XML 格式

<RevokeSecurityGroupEgressResponse>
     <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</RevokeSecurityGroupEgressResponse>
JSON 格式 
{
    "RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidDestCidrIp.Malformed The specified parameter “DestCidrIp” is not valid. 400 指定的 DestCidrIp不合法。
InvalidDestCidrIp.sMalformed The specified parameter “DestCidrIp” is not valid. 400 指定的 DestCidrIp不合法。
InvalidDestGroupId.Mismatch Specified security group and destination group are not in the same VPC. 400 指定安全性群組的網路類型是 VPC，目的端安全性群組必須在同一個 VPC 裡。
InvalidIpPortRange.Malformed The specified parameter “PortRange” is not valid. 400 指定的 PortRange 不合法。
InvalidIpProtocol.ValueNotSupported The specified IpProtocol does not exist. 400 指定的 IpProtocol不存在。
InvalidNicType.ValueNotSupported The specified NicType does not exist. 400 指定的 NicType 不存在。
InvalidPolicy.Malformed The specified parameter “Policy” is not valid. 400 指定的 Policy 不合法。
MissingParameter The input parameter “DestGroupId” or “DestCidrIp” cannot be both blank. 400 必須指定參數 DestGroupId 或者 DestCidrIp。
InvalidGroupAuthItem.NotFound Specified group authorized item does not exist in our records. 403 指定的安全性群組規則不存在。
InvalidNicType.Mismatch Specified nic type conflicts with the authorization record. 403 兩方安全性群組的網路類型必須相同，即必須同時為經典網路或者 VPC。
InvalidSecurityGroup.IsSame The authorized SecurityGroupId should be different from the DestGroupId. 403 參數 SecurityGroupId 和 DestGroupId 不能相同。
InvalidDestGroupId.NotFound The DestGroupId provided does not exist in our records. 404 指定的 DestGroupId不存在。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。
InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 404 指定的 SecurityGroupId 不存在。