新建一个安全组。新建的安全组,默认只允许安全组内实例互相访问,安全组外的一切通信请求会被拒绝。若您想允许其他安全组实例的通信请求,或者来自互联网的访问请求,需要授权安全组权限(AuthorizeSecurityGroup)。

接口说明

调用该接口时,您需要注意:

  • 在一个阿里云地域下,您最多可创建100个安全组。
  • 创建专有网络VPC类型的安全组时,您必须指定参数VpcId。

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

安全组所属地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

Action String CreateSecurityGroup

系统规定参数。取值:CreateSecurityGroup

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多详情,请参阅 如何保证幂等性

Description String FinanceDept

安全组描述信息。长度为2~256个英文或中文字符,不能以 http:// 和 https:// 开头。默认值:空。

OwnerAccount String ECSforCloud@Alibaba.com

RAM用户的账号登录名称。

ResourceGroupId String rg-resourcegrouid

安全组所在的企业资源组ID。

SecurityGroupName String FinanceJoshua

安全组名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。默认值:空。

Tag.N.Key String FinanceDept

安全组的标签键。n的取值范围为 1~20。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以aliyun、acs:、http:// 或者 https:// 开头。

Tag.N.Value String FinanceDeptJoshua

安全组的标签值。n的取值范围为 1~20。一旦传入该值,可以为空字符串。最多支持128个字符,不能以aliyun、acs:、http:// 或者 https:// 开头。

Tag.N.key String FinanceDept

安全组的标签键。

说明 该参数即将被弃用,为提高兼容性,建议您尽量使用Tag.N.Key参数。
Tag.N.value String FinanceDeptJoshua

安全组的标签值。

说明 该参数即将被弃用,为提高兼容性,建议您尽量使用Tag.N.Value参数。
VpcId String v-vpcid1

安全组所属VPC ID。

返回参数

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。

SecurityGroupId String sg-F876FF7BA

安全组 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 格式

{
	"SecurityGroupId":"sg-F876FF7BA",
	"RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidVpcId.NotFound Specified VPC does not exist. 指定的专有网络 VPC ID 不存在,请您检查 regionId 是否存在。
403 InvalidVpcId.NotFound vpc id must not empty when only support vpc vm. 指定的 VPC ID 不能为空。
400 InvalidTagKey.Malformed Specified tag key is not valid. 指定的标签键无效。
400 InvalidTagValue.Malformed Specified tag value is not valid. 指定的标签值无效。

查看本产品错误码