400
魔獸
授權安全組權限__安全組相關接口_API 參考_雲服務器 ECS-阿裏雲
描述
設定安全組In方向的訪問權限。
- 可支持的授權策略為:
accept
(接受訪問),drop
(拒絕訪問)。 - 可支持不同的網絡類型,如
NicType
可選擇internet
或intranet
,分別表示公網或內網。VPC類型的ECS實例,隻支持intranet類型。 - 單個安全組的授權規則最多為100條。
- 安全組的優先級根據創建的時間降序排序匹配。
- 規則優先級可選範圍為1-100,默認值為1,即最高優先級。數字越大,代表優先級越低。
- 相同優先級的授權規則,授權策略為drop的規則優先。
- 組和組之間的授權隻能在內網,即
NicType
隻能選擇intranet
。 - 安全組規則由兩組可選參數中的一組組成:
SourceGroupOwnerAccount
、SourceGroupId
、IpProtocol
、PortRange
、NicType
、Policy
或者SourceCidrIp
、IpProtocol
、PortRange
、NicType
、Policy
。如匹配的規則已存在將會報錯。
支持兩種授權方式: 1、授權同一region(經典網絡)/同一VPC(VPC)內其他安全組(允許跨用戶授權)對其的訪問權限;2、授權指定某IP地址範圍(CIDR格式)對其的訪問權限
請求參數
名稱 | 類型 | 是否必須 | 描述 |
---|---|---|---|
Action | String | 是 | 係統規定參數,取值:AuthorizeSecurityGroup |
SecurityGroupId | String | 是 | 目標安全組編碼 |
RegionId | String | 是 | 目標安全組所屬Region ID |
IpProtocol | String | 是 | IP協議,取值:tcp | udp | icmp | gre | all; all表示同時支持四種協議 |
PortRange | String | 是 | IP協議相關的端口號範圍
|
SourceGroupId | String | 否 | 源安全組ID,SourceGroupId或者SourceCidrIp參數必須設置一項,如果兩項都設置,則默認對SourceCidrIp授權。如果指定了該字段且沒有指定SourceCidrIp,則NicType隻能選擇intranet |
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 |
Priority | String | 否 | 授權策略優先級,參數值可為:1-100 默認值為:1 |
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參數未指定 |
OperationDenied | The specified IpProtocol does not exist or IpProtocol and PortRange do not match. | 400 | IP協議不存在或者IP協議和端口不匹配 |
MissingParameter | The input parameter “IpProtocol” that is mandatory for processing this request is not supplied. | 400 | IpProtocol參數未指定 |
InvalidIpProtocol.Malformed | The specified parameter “PortRange” is not valid. | 400 | IpProtocol參數格式不正確 |
InvalidPriority.Malformed | The specified parameter “Priority” is not valid. | 400 | Priority參數格式不正確 |
MissingParameter | The input parameter “PortRange” that is mandatory for processing this request is not supplied. | 400 | PortRange參數未指定 |
InvalidSourceGroupId.Mismatch | NicType is required or NicType expects intranet. | 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. | 403 | SourceGroupId或者SourceCidrIp參數未指定 |
InvalidPolicy.Malformed | The specified parameter “Policy” is not valid. | 400 | Policy參數格式不正確 |
InvalidNicType.ValueNotSupported | The specified NicType does not exist. | 400 | NicType指定的值不支持 |
AuthorizationLimitExceed | The limit of Authorization in one security group reachs. | 403 | 安全組授權規則數達到上限 |
InvalidParamter.Conflict | The specified SecurityGroupId should be different from the SourceGroupId. | 403 | SecurityGroupId和SourceGroupId為同一個安全組 |
InvalidSourceGroupId.Mismatch | SourceGroupOwnerUserAccount is required. | 403 | 指定的其他用戶的SourceGroup但是沒有指定SourceGroupOwnerUserAccount |
InvalidSourceGroupId.Mismatch | Specified security group and source group are not in the same VPC. | 403 | 指定的安全組和源安全組不屬於同一個vpc |
InvalidSourceGroupOwnerUserAccount.Mismatch | The specified SourceGroupId is not belong to the SourceGroupOwnerUserAccount | 403 | 指定的SourceGroup不屬於SourceGroupOwnerUserAccount指定的用戶 |
InvalidSourceGroupId.NotFound | The SourceGroupId provided does not exist in our records. | 404 | 指定的SourceGroup未找到 |
示例
請求示例
授權其他安全組的訪問權限
https://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
&SecurityGroupId=sg-F876FF7BA
&SourceGroupId=sg-1651FBB64
&SourceGroupOwnerAccount=test@aliyun.com
&IpProtocol=tcp
&PortRange=1/65535
&<公共請求參數>
授權指定網段/IP地址的訪問權限
https://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
&SecurityGroupId=sg-F876FF7BA
&SourceCidrIp=0.0.0.0/0
&IpProtocol=tcp
&PortRange=1/65535
&<公共請求參數>
返回示例
XML
格式
<AuthorizeSecurityGroupResponse>
<RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</AuthorizeSecurityGroupResponse>
JSON
格式
{
"RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}
最後更新:2016-11-23 17:16:02
上一篇:
釋放彈性公網 IP__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲
下一篇:
撤銷安全組規則__安全組相關接口_API 參考_雲服務器 ECS-阿裏雲
ActionTrail__操作事件(Event)樣例_用戶指南_操作審計-阿裏雲
監控__用戶指南_雲服務器 ECS-阿裏雲
表詳情頁介紹__數據管理手冊_用戶操作指南_大數據開發套件-阿裏雲
軟件配置__用戶指南_E-MapReduce-阿裏雲
授權服務角色讀日誌__常見問題_產品使用問題_日誌服務-阿裏雲
示例項目使用說明__開發準備_開發人員指南_E-MapReduce-阿裏雲
功能模塊__產品簡介_性能測試-阿裏雲
阿裏雲追雲數據庫風口,完成第三代架構產品布局
普通雲盤狀態表__附錄_API 參考_雲服務器 ECS-阿裏雲
VPC創建vswitch提示Specified CIDR block overlapped with other subnets__異常處理_用戶指南_專有網絡 VPC-阿裏雲
相關內容
常見錯誤說明__附錄_大數據計算服務-阿裏雲
發送短信接口__API使用手冊_短信服務-阿裏雲
接口文檔__Android_安全組件教程_移動安全-阿裏雲
運營商錯誤碼(聯通)__常見問題_短信服務-阿裏雲
設置短信模板__使用手冊_短信服務-阿裏雲
OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
消息通知__操作指南_批量計算-阿裏雲
設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲