新建一個安全性群組。新建的安全性群組,預設只允許安全性群組內實例互相訪問,安全性群組外的一切通訊請求會被拒絕。若您想允許其他安全性群組實例的通訊請求,或者來自互連網的訪問請求,需要授權安全性群組許可權(AuthorizeSecurityGroup)。
描述
調用該介面時,您需要注意:
-
您最多可建立 100 個安全性群組。
-
建立專有網路 VPC 類型的安全性群組時,您必須指定參數
VpcId
。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:CreateSecurityGroup |
RegionId | String | 是 | 安全性群組所屬地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
SecurityGroupName | String | 否 | 安全性群組名稱。
|
Description | String | 否 | 安全性群組描述資訊。
|
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 不存在。 |