阿里云如何使用安全組相關(guān)接口

　　創(chuàng)建安全組

　　描述

　　新建一個(gè)安全組，通過安全組防火墻規(guī)則配置實(shí)現(xiàn)對(duì)一組實(shí)例的防火墻配置。一個(gè)安全組可包含多個(gè)實(shí)例。

　　新建的安全組，默認(rèn)只打開組內(nèi)實(shí)例之間的訪問權(quán)限，其他訪問權(quán)限全部關(guān)閉。若用戶允許其他組的實(shí)例或來自互聯(lián)網(wǎng)的訪問，則可通過授權(quán)安全組權(quán)限接口來對(duì)安全組防火墻策略進(jìn)行修改。

　　防火墻規(guī)則區(qū)分內(nèi)網(wǎng)和公網(wǎng)。

　　每個(gè)用戶最多可創(chuàng)建 100 個(gè)安全組。

　　創(chuàng)建專有網(wǎng)絡(luò)類型的安全組，需要指定 VpcId。

　　請(qǐng)求參數(shù)

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

　　返回參數(shù)

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

　　錯(cuò)誤碼

錯(cuò)誤代碼 描述 Http 狀態(tài)碼 語義
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 值（實(shí)際情況也可能是該用戶無權(quán)使用此 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   安全組個(gè)數(shù)超過額度限制  
InvalidVpcId.NotFound   Specified VPC does not exist.   403   指定的 VPC 不存在  

　　示例

　　請(qǐng)求示例

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

　　&RegionId=cn-hangzhou

　　&Description=for_demo

　　&<公共請(qǐng)求參數(shù)>