全部产品
云服务器 ECS

CreateSecurityGroup

更新时间:2017-09-13 14:22:24   分享:   

描述

新建一个安全组,通过安全组防火墙规则配置实现对一组实例的防火墙配置。一个安全组可包含多个实例。

  • 新建的安全组,默认只打开组内实例之间的访问权限,其他访问权限全部关闭。若用户允许其他组的实例或来自互联网的访问,则可通过授权安全组权限接口来对安全组防火墙策略进行修改。
  • 防火墙规则区分内网和公网。
  • 每个用户最多可创建 100 个安全组。
  • 创建专有网络类型的安全组,需要指定 VpcId。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:CreateSecurityGroup
RegionId String 安全组所属 Region ID。RegionId 的列表详见 地域列表
SecurityGroupName String 安全组名称,不填则为空,默认值为空,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”.”,”_”或”-”,安全组名称会展示在控制台。不能以 http:// 和 https:// 开头。
Description String 安全组描述信息,[2, 256] 个字符。不能以 http:// 和 https:// 开头。
VpcId String 安全组所在的专有网络
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性

返回参数

名称 类型 描述
SecurityGroupId String 安全组 ID

错误码

错误代码 描述 Http状态码 语义
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。RegionId 的列表详见 地域列表
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 maximum number of security groups is reached. 403 安全组个数超过额度限制
InvalidVpcId.NotFound Specified VPC does not exist. 404 指定的 VPC 不存在
InvalidSecurityGroupDiscription.Malformed Specified security group description is not valid. 400 指定的Description不合法
InvalidVpcId.NotFound vpc id must not empty when only support vpc vm. 403 VpcId不能为空
IncorrectVpcStatus Current VPC status does not support this operation. 400 指定的VPC状态不正确

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=CreateSecurityGroup
  2. &RegionId=cn-hangzhou
  3. &Description=for_demo
  4. &<公共请求参数>

返回示例

XML格式

  1. <CreateSecurityGroupResponse>
  2. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
  3. <SecurityGroupId>sg-F876FF7BA</SecurityGroupId>
  4. </CreateSecurityGroupResponse>

JSON格式

  1. {
  2. "RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  3. "SecurityGroupId":"sg-F876FF7BA"
  4. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?