535
魔獸
撤銷安全組規則__安全組相關接口_API 參考_雲服務器 ECS-阿裏雲
撤銷安全組授權規則
描述
撤銷安全組的訪問權限支持兩種方式：一是撤銷本Region內(經典網絡)/本VPC內(VPC)其他安全組采用指定協議通過指定端口對本安全組的授權規則；二是撤銷IP網段采用指定協議通過指定端口訪問本安全組，隻有調用授權接口授權的權限條目才可以刪除。
安全組規則由兩組可選參數中的一組組成：SourceGroupOwnerAccount、SourceGroupId、IpProtocol、PortRange、NicType、Policy或者SourceCidrIp、IpProtocol、PortRange、NicType、Policy。如匹配的規則找不到將會報錯。
RevokeSecurityGroup和RevokeSecurityGroupEgress的區別
這兩個方法都是用來操作安全組規則的，但是有區別：
- RevokeSecurityGroup 是用來撤銷“入方向”的安全組規則，也就是“In”方向上的規則;
- RevokeSecurityGroupEgress 是用來撤銷“出方向”的安全組規則。
一般來說，前者的使用更多，您根據實際情況來選擇一個方法即可。
類似的，AuthorizeSecurityGroup和AuthorizeSecurityGroupEgress也是這樣，前者授權入方向的規則，後者授權出方向的規則。
請求參數
| 名稱 | 類型 | 是否必須 | 描述 |
|---|---|---|---|
| Action | String | 是 | 係統規定參數，取值：RevokeSecurityGroup |
| SecurityGroupId | String | 是 | 目標安全組ID |
| RegionId | String | 是 | 目標安全組所屬Region ID |
| IpProtocol | String | 是 | IP協議，取值：tcp | udp | icmp | gre | all； all表示同時支持四種協議 |
| PortRange | String | 是 | IP協議相關的端口號範圍
|
| SourceGroupId | String | 否 | 源安全組ID，SourceGroupId或者SourceCidrIp參數必須設置一項，如果兩項都設置，則默認對SourceCidrIp授權。可以同時指定多個Group（最多10個），但必須采用逗號“,”分隔 |
| SourceGroupOwnerAccount | String | 否 | 跨用戶撤銷安全組規則時，源安全組所屬用戶阿裏雲賬號。該參數可選，如果該參數及SourceGroupOwnerID均未設置，則默認為同一賬戶安全組間撤銷。SourceCidrIp如果已經被設置，則該參數無效。 |
| SourceGroupOwnerID | String | 否 | 跨用戶撤銷安全組規則時，源安全組所屬用戶阿裏雲賬號ID。該參數可選，如果該參數及SourceGroupOwnerAccount均未設置，則默認為同一賬戶安全組間撤銷。SourceCidrIp如果已經被設置，則該參數無效。 |
| SourceCidrIp | String | 否 | 源IP地址範圍，必須采用CIDR格式來指定IP地址範圍，默認值為0.0.0.0/0（表示不受限製），其他支持的格式如10.159.6.18/12。僅支持IPV4。 |
| Policy | String | 否 | 授權策略，參數值可為：accept（接受訪問），drop (拒絕訪問) 默認值為：accept |
| NicType | String | 否 | 網絡類型，取值：
當對安全組進行相互授權時（即指定了SourceGroupId且沒有指定SourceCidrIp），必須指定NicType為intranet |
返回參數
全是公共返回參數，詳見公共返回參數
錯誤碼
| 錯誤代碼 | 描述 | Http 狀態碼 | 語義 |
|---|---|---|---|
| InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | 404 | 指定的RegionId不存在 |
| MissingParameter | The input parameter “RegionId” that is mandatory for processing this request is not supplied. | 400 | RegionId參數未指定 |
| InvalidSecurityGroupId.NotFound | The SecurityGroupId provided does not exist in our records. | 404 | 指定的SecurityGroupId不存在 |
| MissingParameter | The input parameter “SecurityGroupId” that is mandatory for processing this request is not supplied. | 400 | SecurityGroupId參數未指定 |
| InvalidIpProtocol.ValueNotSupported | The specified IpProtocol does not exist. | 400 | IpProtocol參數指定的值不支持 |
| MissingParameter | The input parameter “IpProtocol” that is mandatory for processing this request is not supplied. | 400 | IpProtocol參數未指定 |
| InvalidPriority.Malformed | The specified parameter “Priority” is not valid. | 400 | Priority參數格式不正確 |
| InvalidIpPortRange.Malformed | The specified parameter “PortRange” is not valid. | 400 | PortRange格式不正確 |
| MissingParameter | The input parameter “PortRange” that is mandatory for processing this request is not supplied. | 400 | PortRange參數未指定 |
| InvalidSourceGroupId.NotFound | The SourceGroupId provided does not exist in our records. | 404 | 指定的SourceGroupId不存在 |
| InvalidSourceGroupId.Mismatch | NicType is required or NicType expects intrnet. | 403 | 需要明確NicType參數或者NicType必須為intranet |
| InvalidSourceCidrIp.Malformed | The specified parameter “SourceCidrIp” is not valid. | 400 | SourceCidrIp參數格式不正確 |
| MissingParameter | The input parameter “SourceGroupId” or “SourceCidrIp” cannot be both blank. | 400 | SourceGroupId或者SourceCidrIp參數未指定 |
| InvalidPolicy.Malformed | The specified parameter “Policy” is not valid. | 400 | Policy參數格式不正確 |
| InvalidNicType.ValueNotSupported | The specified NicType does not exist. | 400 | NicType指定的值不支持 |
| InvalidSourceGroupId.Mismatch | SourceGroupOwnerAccount is required | 403 | 指定的其他用戶的SourceGroup但是沒有指定SourceGroupOwnerUserAccount |
| InvalidSourceGroupOwnerUserAccount.Mismatch | The specified SourceGroupId is not belong to the SourceGroupOwnerAccount | 403 | 指定的SourceGroup不屬於SourceGroupOwnerUserAccount指定的用戶 |
示例
請求示例
https://ecs.aliyuncs.com/?Action=RevokeSecurityGroup&SecurityGroupId=C0003E8B-B930-4F59-ADC0-0E209A9012B0&SourceGroupId=sg-F876FF7BA&SourceGroupOwnerAccount=test@aliyun.com&IpProtocol=tcp&PortRange=1/65535&<公共請求參數>
返回示例
XML格式
<RevokeSecurityGroupResponse><RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId></RevokeSecurityGroupResponse>
JSON格式
{"RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"}
最後更新：2016-12-12 16:37:09
上一篇： 授權安全組權限__安全組相關接口_API 參考_雲服務器 ECS-阿裏雲
下一篇： 授權出方向安全組權限__安全組相關接口_API 參考_雲服務器 ECS-阿裏雲
- 隊列模型名詞解釋__產品名詞解釋_產品簡介_消息服務-阿裏雲
- 網站存在病毒如何處理？___安全問題_技術分享_雲虛機主機-阿裏雲
- 創建數據訂閱通道__快速入門_數據傳輸-阿裏雲
- 數據準備__基礎示例—完整數據開發_場景教程_大數據開發套件-阿裏雲
- 添加刪除用戶__快速開始_大數據計算服務-阿裏雲
- 下載__Java SDK_SDK使用手冊_消息服務-阿裏雲
- ExecutionPlanInstance__數據類型_API參考_E-MapReduce-阿裏雲
- 子賬號授權準備__日誌管理使用幫助_控製台使用幫助_消息服務-阿裏雲
- 中文和時間__Python-SDK_SDK 參考_對象存儲 OSS-阿裏雲
- OSS API 文檔簡介__API 參考_對象存儲 OSS-阿裏雲
相關內容
- 常見錯誤說明__附錄_大數據計算服務-阿裏雲
- 發送短信接口__API使用手冊_短信服務-阿裏雲
- 接口文檔__Android_安全組件教程_移動安全-阿裏雲
- 運營商錯誤碼（聯通）__常見問題_短信服務-阿裏雲
- 設置短信模板__使用手冊_短信服務-阿裏雲
- OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
- 消息通知__操作指南_批量計算-阿裏雲
- 設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
- 查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
- 使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲