創建安全組

　　描述

　　新建一個安全組，通過安全組防火墻規則配置實現對一組實例的防火墻配置。一個安全組可包含多個實例。

　　新建的安全組，默認只打開組內實例之間的訪問權限，其他訪問權限全部關閉。若用戶允許其他組的實例或來自互聯網的訪問，則可通過授權安全組權限接口來對安全組防火墻策略進行修改。

　　防火墻規則區分內網和公網。

　　每個用戶最多可創建 100 個安全組。

　　創建專有網絡類型的安全組，需要指定 VpcId。

　　請求參數

名稱 類型 是否必須 描述
Action   String   是   系統規定參數，取值：CreateSecurityGroup  
RegionId   String   是   安全組所屬 Region ID  
SecurityGroupName   String   否   安全組名稱，不填則為空，默認值為空，[2, 128] 英文或中文字符，必須以大小字母或中文開頭，可包含數字，”.”，”_”或”-”，磁盤名稱會展示在控制臺。不能以 和 https:// 開頭。  
Description   String   否   安全組描述信息，[2, 256] 個字符。不能以 和 https:// 開頭。  
VpcId   String   否   安全組所在的專有網絡  
ClientToken   String   否   用于保證請求的冪等性。由客戶端生成該參數值，要保證在不同請求間唯一，最大不值過 64 個 ASCII 字符。
具體參見附錄：如何保證冪等性  

　　返回參數

名稱 類型 描述
SecurityGroupId   String   安全組 ID  

　　錯誤碼

錯誤代碼 描述 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 值（實際情況也可能是該用戶無權使用此 Region）  
InvalidSecurityGroupName.Malformed   Specified security group name is not valid.   400   指定的 SecurityGroupName 格式不合法  
InvalidDescription.Malformed   The specified parameter "Description" is not valid.   400   指定的 DescriptionName 格式不合法  
QuotaExceed.SecurityGroup   The security group quota exceeds.   403   安全組個數超過額度限制  
InvalidVpcId.NotFound   Specified VPC does not exist.   403   指定的 VPC 不存在  

　　示例

　　請求示例

　　https://ecs.aliyuncs.com/?Action=CreateSecurityGroup

　　&RegionId=cn-hangzhou

　　&Description=for_demo

　　&<公共請求參數>