{"base_path":"/","components":null,"consumes":"[\"application/json\"]","definitions":{"CreateSecurityGroupOption":{"description":"","properties":{"description":{"description":"功能说明:安全组的描述信息\n取值范围:0-255个字符,不能包含“<”和“>”","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"enterprise_project_id":{"description":"功能说明:企业项目ID。创建安全组时,给安全组绑定企业项目ID。\n取值范围:最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。“0”表示默认企业项目。","maxLength":36,"minLength":0,"type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"name":{"description":"功能描述:安全组名称\n取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"tags":{"description":"功能描述:安全组的标签信息","items":{"$ref":"#/definitions/ResourceTag","description":""},"type":"array"}},"required":["name"]},"CreateSecurityGroupRequestBody":{"description":"This is a auto create Body Object","properties":{"dry_run":{"description":"功能说明:是否只预检此次请求\n取值范围:\n-true:发送检查请求,不会创建安全组。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过,则返回对应错误。如果检查通过,则返回响应码202。\n-false(默认值):发送正常请求,并直接创建安全组。","type":"boolean","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"security_group":{"$ref":"#/definitions/CreateSecurityGroupOption","description":"功能说明:创建安全组的请求体","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"}},"required":["security_group"]},"CreateSecurityGroupResponseBody":{"description":"This is a auto create Response Object","properties":{"request_id":{"description":"请求Id","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"security_group":{"$ref":"#/definitions/SecurityGroupInfo","description":"创建安全组响应体","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"}},"required":["request_id","security_group"]},"ErrorResp":{"description":"","properties":{"error_code":{"description":"错误码","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"error_msg":{"description":"错误消息","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"request_id":{"description":"请求ID","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"}},"required":["error_code","error_msg","request_id"]},"ResourceTag":{"description":"","properties":{"key":{"description":"功能说明:标签键\n约束:同一资源的key值不能重复。","maxLength":128,"minLength":1,"type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso"},"value":{"description":"功能说明:标签值","maxLength":255,"type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso"}},"required":["key","value"]},"SecurityGroup":{"description":"","properties":{"created_at":{"description":"功能说明:安全组创建时间\n取值范围:UTC时间格式:yyyy-MM-ddTHH:mm:ss","format":"date-time","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc"},"description":{"description":"功能说明:安全组的描述信息\n取值范围:0-255个字符,不能包含“<”和“>”","maxLength":255,"minLength":0,"type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"enterprise_project_id":{"description":"功能说明:安全组所属的企业项目ID。\n取值范围:最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。“0”表示默认企业项目。","maxLength":36,"minLength":1,"type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"id":{"description":"功能描述:安全组对应的唯一标识\n取值范围:带“-”的标准UUID格式","maxLength":36,"minLength":36,"type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"name":{"description":"功能说明:安全组名称\n取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)","maxLength":64,"minLength":1,"type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"project_id":{"description":"功能说明:安全组所属的项目ID","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"tags":{"description":"功能描述:安全组的标签信息","items":{"$ref":"#/definitions/ResourceTag","description":""},"type":"array"},"updated_at":{"description":"功能说明:安全组更新时间\n取值范围:UTC时间格式:yyyy-MM-ddTHH:mm:ss","format":"date-time","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc"}},"required":["created_at","description","enterprise_project_id","id","name","project_id","updated_at","tags"]},"SecurityGroupInfo":{"allOf":[{"$ref":"#/definitions/SecurityGroup"},{"properties":{"security_group_rules":{"description":"安全组规则","items":{"$ref":"#/definitions/SecurityGroupRule","description":""},"type":"array","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"}},"required":["security_group_rules"]}],"description":""},"SecurityGroupRule":{"description":"","properties":{"action":{"description":"功能说明:安全组规则生效策略\n取值范围:allow 允许,deny 拒绝\n约束:默认值为deny","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"created_at":{"description":"功能说明:安全组规则创建时间\n取值范围:UTC时间格式:yyyy-MM-ddTHH:mm:ss","format":"date-time","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc"},"description":{"description":"功能说明:安全组的描述信息\n取值范围:0-255个字符,不能包含“<”和“>”","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"direction":{"description":"功能说明:安全组规则的出入控制方向\n取值范围:ingress 表示入方向;egress 表示出方向","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"enabled":{"description":"功能说明:是否启用安全组规则。\n取值范围:true, false。\n约束:默认值为true。","type":"boolean","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk"},"ethertype":{"default":"IPv4","description":"功能说明:IP地址协议类型\n取值范围:IPv4,IPv6\n约束:不填默认值为IPv4","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"id":{"description":"功能描述:安全组规则对应的唯一标识\n取值范围:带“-”的标准UUID格式","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"multiport":{"description":"功能说明:端口取值范围\n取值范围:支持单端口(80),连续端口(1-30)以及不连续端口(22,3389,80)","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"priority":{"description":"功能说明:优先级\n取值范围:1~100,1代表最高优先级","format":"int32","type":"integer","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"project_id":{"description":"功能说明:安全组规则所属项目ID","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"protocol":{"description":"功能说明:协议类型\n取值范围:icmp、tcp、udp、icmpv6或IP协议号\n约束:为空表示支持所有协议。协议为icmpv6时,网络类型应该为IPv6;协议为icmp时,网络类型应该为IPv4","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"remote_address_group_id":{"description":"功能说明:远端地址组ID\n取值范围:租户下存在的地址组ID\n约束:与remote_ip_prefix,remote_group_id功能互斥","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"remote_group_id":{"description":"功能说明:远端安全组ID,表示该安全组内的流量允许或拒绝\n取值范围:租户下存在的安全组ID\n约束:与remote_ip_prefix,remote_address_group_id功能互斥","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"remote_ip_prefix":{"description":"功能说明:远端IP地址,当direction是egress时为虚拟机访问端的地址,当direction是ingress时为访问虚拟机的地址\n取值范围:IP地址,或者cidr格式\n约束:与remote_group_id、remote_address_group_id互斥","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"security_group_id":{"description":"功能说明:安全组规则所属的安全组ID","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc,obc"},"updated_at":{"description":"功能说明:安全组规则更新时间\n取值范围:UTC时间格式:yyyy-MM-ddTHH:mm:ss","format":"date-time","type":"string","x-admin":"False","x-internal":"False","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso,sbc"}},"required":["action","created_at","description","direction","enabled","ethertype","id","multiport","priority","project_id","protocol","remote_address_group_id","remote_group_id","remote_ip_prefix","security_group_id","updated_at"]}},"description":null,"group_id":"4784d190da9948c381c1603ddda2f4ff","host":"vpc.cn-north-4.myhuaweicloud.com","id":"09d7b89f38c5475fa9c982d8d3121d17","info_version":"v3","method":"post","name":"CreateSecurityGroup","parameters":{},"paths":{"/v3/{project_id}/vpc/security-groups":{"post":{"consumes":[],"deprecated":false,"description":"创建安全组","operationId":"CreateSecurityGroup","parameters":[{"description":"This is a auto create Body Object","in":"body","name":"CreateSecurityGroupRequestBody","required":true,"schema":{"$ref":"#/definitions/CreateSecurityGroupRequestBody"}},{"description":"用户Token。\n获取Token,请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。","in":"header","name":"X-Auth-Token","required":true,"type":"string","x-order":1},{"description":"项目ID\n获取项目ID,请参见获取项目ID","in":"path","name":"project_id","pattern":"[0-9a-fA-F]{32}","required":true,"type":"string","x-order":2}],"produces":[],"responses":{"201":{"description":"Created","examples":{"application/json":{"request_id":"a8cf4f79ca3c22ca685e7e8872e8c20b","security_group":{"created_at":"2020-07-09T05:56:27Z","description":"security group description","enterprise_project_id":"0","id":"69c999ad-d9ef-4d79-94fd-35e6ceb75325","name":"security_group_1","project_id":"060576782980d5762f9ec014dd2f1148","security_group_rules":[{"action":"allow","created_at":"2020-07-09T05:56:27Z","description":"","direction":"ingress","enabled":true,"ethertype":"IPv6","id":"f11a3824-ac19-4fad-b4f1-c5f4a6dd0a80","multiport":null,"priority":100,"project_id":"060576782980d5762f9ec014dd2f1148","protocol":null,"remote_address_group_id":null,"remote_group_id":"69c999ad-d9ef-4d79-94fd-35e6ceb75325","remote_ip_prefix":null,"security_group_id":"69c999ad-d9ef-4d79-94fd-35e6ceb75325","updated_at":"2020-07-09T05:56:27Z"},{"action":"allow","created_at":"2020-07-09T05:56:27Z","description":"","direction":"egress","enabled":true,"ethertype":"IPv6","id":"3d6480e8-9ea4-46dc-bb1b-8db190cd5677","multiport":null,"priority":100,"project_id":"060576782980d5762f9ec014dd2f1148","protocol":null,"remote_address_group_id":null,"remote_group_id":null,"remote_ip_prefix":null,"security_group_id":"69c999ad-d9ef-4d79-94fd-35e6ceb75325","updated_at":"2020-07-09T05:56:27Z"},{"action":"allow","created_at":"2020-07-09T05:56:27Z","description":"","direction":"egress","enabled":true,"ethertype":"IPv4","id":"9581f18c-1fdd-43da-ace9-7758a56ef28a","multiport":null,"priority":100,"project_id":"060576782980d5762f9ec014dd2f1148","protocol":null,"remote_address_group_id":null,"remote_group_id":null,"remote_ip_prefix":null,"security_group_id":"69c999ad-d9ef-4d79-94fd-35e6ceb75325","updated_at":"2020-07-09T05:56:27Z"},{"action":"allow","created_at":"2020-07-09T05:56:27Z","description":"","direction":"ingress","enabled":true,"ethertype":"IPv4","id":"a3ba270e-e58b-432d-a912-aeb7eace9fb8","multiport":null,"priority":100,"project_id":"060576782980d5762f9ec014dd2f1148","protocol":null,"remote_address_group_id":null,"remote_group_id":"69c999ad-d9ef-4d79-94fd-35e6ceb75325","remote_ip_prefix":null,"security_group_id":"69c999ad-d9ef-4d79-94fd-35e6ceb75325","updated_at":"2020-07-09T05:56:27Z"}],"updated_at":"2020-07-09T05:56:27Z"}}},"schema":{"$ref":"#/definitions/CreateSecurityGroupResponseBody"}},"400":{"description":"Bad Request","schema":{"$ref":"#/definitions/ErrorResp"}},"401":{"description":"Unauthorized","schema":{"$ref":"#/definitions/ErrorResp"}},"403":{"description":"Forbidden","schema":{"$ref":"#/definitions/ErrorResp"}},"409":{"description":"Conflict","schema":{"$ref":"#/definitions/ErrorResp"}},"500":{"description":"Internal Server Error","schema":{"$ref":"#/definitions/ErrorResp"}}},"summary":"创建安全组","tags":["安全组"],"x-apiexplorer-hide":"false","x-constraint":"新建的安全组,默认只允许安全组内的实例互相访问","x-first-open-time":"","x-hybridcloud":"false","x-is-registered":"Y","x-name":"创建安全组","x-open-region-cloud":"hc,hk,otc,tlf,ctc,hcso","x-order":14,"x-publishpath":"","x-request-examples-1":{"security_group":{"description":"security group description","name":"security_group_1"}},"x-request-examples-2":{"dry_run":true,"security_group":{"description":"security group description","name":"security_group_1"}},"x-request-examples-description-1":"指定名称和描述创建安全组","x-request-examples-description-2":"指定dry_run预检创建安全组","x-request-examples-text-1":"{\n\t\"security_group\": {\n\t\t\"name\": \"security_group_1\",\n\t\t\"description\": \"security group description\"\n\t}\n}","x-request-examples-text-2":"{\n\t\"security_group\": {\n\t\t\"name\": \"security_group_1\",\n\t\t\"description\": \"security group description\"\n\t},\n\t\"dry_run\": true\n}","x-request-examples-url-1":"POST https://{Endpoint}/v3/{project_id}/vpc/security-groups","x-request-examples-url-2":"POST https://{Endpoint}/v3/{project_id}/vpc/security-groups","x-scope":"Commercial","x-source":"SelfDeveloped","x-support-sdk":"Y","x-version":"v3"}}},"product_short":"VPC","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"创建安全组","tags":"安全组","uri":null,"version":"2.0"}