创建安全组

功能介绍

创建安全组。

调试

您可以在API Explorer中调试该接口。

URI

POST /v1/{project_id}/security-groups 参数说明请参见表4-61。

表4-61 参数说明

名称 是否必选 说明

project_id 是 项目ID，获取项目ID请参

见A.5 获取项目ID。

请求消息

● 请求参数

表4-62 请求参数

名称 是否必

选

参数类型 说明

security_grou

p 是 security_gro

up object 安全组对象，请参见表4-63。

表4-63 security_group 字段说明

名称 是否必选 参数类型 说明

name 是 String ● 功能说明：安全组名称

● 取值范围：1-64个字符，支持数字、

字母、中文、_(下划线)、-（中划 线）、.（点）

vpc_id 否 String 安全组所在的vpc的资源标识 说明

该参数已废弃，不建议继续使用。

enterpris e_project _id

否 String ● 功能说明：企业项目ID。创建安全组 时，给安全组绑定企业项目ID。

● 取值范围：最大长度36字节，带

“-”连字符的UUID格式，或者是字 符串“0”。“0”表示默认企业项 目。

说明关于企业项目ID的获取及企业项目特性的详 细信息，请参见《企业管理用户指南》。

● 请求样例

POST https://{Endpoint}/v1/{project_id}/security-groups

{ "security_group": { "name": "qq",

"vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85",

"enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2"

} }

响应消息

● 响应参数

表4-64 响应参数

名称 参数类型 说明

security_group security_grou

p object 安全组对象，请参见表4-65。

表4-65 security_group 字段说明

名称 参数类型 说明

name String 安全组名称

description String 安全组描述

id String 安全组唯一标识

vpc_id String 安全组所在的vpc的资源标识

说明

该参数已废弃，不建议继续使用。

security_group_rules Array of security_grou p_rule objects

默认安全组规则列表，保证安全 组内互通。

enterprise_project_id String ● 功能说明：企业项目ID。创建 安全组时，给安全组绑定企业 项目ID。

● 取值范围：最大长度36字节，

带“-”连字符的UUID格式，

或者是字符串“0”。“0”表 示默认企业项目。

说明关于企业项目ID的获取及企业项目特 性的详细信息，请参见《企业管理用 户指南》。

表4-66 security_group_rule 对象

名称 参数类型 说明

id String 安全组规则标识

description String ● 功能说明：安全组规则描述

● 取值范围：0-255个字符，支持 数字、字母、中文字符

security_group_id String 安全组标识

direction String ● 功能说明：出入控制方向

● 取值范围：

– egress：出方向 – ingress：入方向 ethertype String ● 功能说明：IP协议类型

● 取值范围：IPv4，IPv6 protocol String ● 功能说明：协议类型

● 取值范围：icmp、tcp、udp、

icmpv6等

● 约束：为空表示支持所有协议 port_range_min Integer ● 功能说明：起始端口值

● 取值范围：1~65535

port_range_max Integer ● 功能说明：结束端口值

● 取值范围：1~65535

remote_ip_prefix String ● 功能说明：远端IP地址，当 direction是egress时为虚拟机

名称 参数类型 说明

remote_group_id String ● 功能说明：对端安全组id

● 约束：和remote_ip_prefix互斥 tenant_id String ● 功能说明：安全组规则所属项

目ID

● 响应样例

{ "security_group": {

"id": "16b6e77a-08fa-42c7-aa8b-106c048884e6", "name": "qq",

"description": "",

"vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85",

"enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", "security_group_rules": [

"security_group_id": "16b6e77a-08fa-42c7-aa8b-106c048884e6"

}, "security_group_id": "16b6e77a-08fa-42c7-aa8b-106c048884e6"

}