新建一個安全性群組。新建的安全性群組,預設只允許安全性群組內實例互相訪問,安全性群組外的一切通訊請求會被拒絕。若您想允許其他安全性群組實例的通訊請求,或者來自互連網的訪問請求,需要授權安全性群組許可權(AuthorizeSecurityGroup)。

描述

調用該介面時,您需要注意:

  • 您最多可建立 100 個安全性群組。

  • 建立專有網路 VPC 類型的安全性群組時,您必須指定參數 VpcId

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:CreateSecurityGroup
RegionId String 安全性群組所屬地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
SecurityGroupName String 安全性群組名稱。
  • 長度為 [2, 128] 個字元,必須以大小字母或中文開頭,可以包含數字、點號(.)、底線(_)或者連字號(-)。
  • 不能以 http:// 和 https:// 開頭。
預設值:空。
Description String 安全性群組描述資訊。
  • 長度為 [2, 256] 個英文或中文字元。
  • 不能以 http:// 和 https:// 開頭。
預設值:空。
VpcId String 安全性群組所屬 VPC ID。
ClientToken String 用於保證請求的等冪性。由客戶端生成該參數值,要保證在不同請求間唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多詳情,請參閱 如何保證等冪性

返回參數

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

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=CreateSecurityGroup
&RegionId=cn-hangzhou
&Description=for_demo
&<公共請求參數>
返回樣本

XML 格式

<CreateSecurityGroupResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <SecurityGroupId>sg-F876FF7BA</SecurityGroupId>
</CreateSecurityGroupResponse>
JSON 格式
{
    "RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
    "SecurityGroupId":"sg-F876FF7BA"
}

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
IncorrectVpcStatus Current VPC status does not support this operation. 400 指定的 VPC 正在被建立、編輯或者刪除,請稍後再試。
InvalidDescription.Malformed The specified parameter “Description” is not valid. 400 指定的 Description不合法。
InvalidSecurityGroupDiscription.Malformed Specified security group description is not valid. 400 指定的 Description不合法。
InvalidSecurityGroupName.Malformed Specified security group name is not valid. 400 指定的 SecurityGroupName不合法。
InvalidVpcId.NotFound vpc id must not empty when only support vpc vm. 403 參數 VpcId 不能為空。
QuotaExceed.SecurityGroup The maximum number of security groups is reached. 403 您最多可以建立 100 個安全性群組。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。
InvalidVpcId.NotFound Specified VPC does not exist. 404 指定的 VPC 不存在。