# 创建安全保护组 - CreateSecurityProtectionGroup #### 功能介绍 创建单个安全保护组。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-evs/evs_04_0009.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-evs/evs_04_0023.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /v5/{project_id}/security-protection-groups 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-evs/evs_04_0046.html)。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释** 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | security_protection_group | 是 | [SecurityProtectionGroupRequestDetail] object | **参数解释** 安全保护组信息。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 | 表4SecurityProtectionGroupRequestDetail | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释** 安全保护组名称。 **约束限制** 不能为空，最大支持64个字符。 **取值范围** 不涉及。 **默认取值** 不涉及。 | | availability_zone | 是 | String | **参数解释** 安全保护组可用区。 可通过接口[查询所有的可用分区信息](https://support.huaweicloud.com/api-evs/evs_04_2081.html)获取，也可参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint)获取。 **约束限制** 不能为空，最大支持128个字符，只能包含英文字母、数字、中划线、下划线和点号。 **取值范围** 不涉及。 **默认取值** 不涉及。 | #### 响应参数 **状态码：200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | security_protection_group | [SecurityProtectionGroupDetail] object | **参数解释** 安全保护组信息。 **取值范围** 不涉及。 | 表6SecurityProtectionGroupDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释** 安全保护组标识id。 **取值范围** 不涉及。 | | name | String | **参数解释** 安全保护组名称。 **取值范围** 不涉及。 | | availability_zone | String | **参数解释** 安全保护组可用区。 可通过接口[查询所有的可用分区信息](https://support.huaweicloud.com/api-evs/evs_04_2081.html)获取，也可参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint)获取。 **取值范围** 不涉及。 | | protection_domains | Array of [ProtectionDomainDetail] objects | **参数解释** 安全保护组内的所有保护域信息。 **取值范围** 不涉及。 | | created_at | String | **参数解释** 安全保护组的创建时间。 **取值范围** 不涉及。 | | updated_at | String | **参数解释** 安全保护组的更新时间。 **取值范围** 不涉及。 | 表7ProtectionDomainDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释** 保护域标识id。 **取值范围** 不涉及。 | | name | String | **参数解释** 保护域名称。 **取值范围** 固定值为:"PD1","PD2","PD3"。 | | volume_count | Integer | **参数解释** 保护域内包含的云硬盘个数。 **取值范围** 不涉及。 | **状态码：400** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [Error] object | **参数解释** 出现错误时，返回的错误信息。 **取值范围** 不涉及。 | 表9Error | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释** 出现错误时，返回的错误码。 **取值范围** 错误码和其对应的含义请[参考错误码说明](https://support.huaweicloud.com/api-evs/evs_04_0038.html)。 | | message | String | **参数解释** 出现错误时，返回的错误消息。 **取值范围** 不涉及。 | #### 请求示例 ``` POST https://{endpoint}/v5/{project_id}/security-protection-groups { "security_protection_group" : { "name" : "security-protection-group-001", "availability_zone" : "az1" } } ``` #### 响应示例 **状态码：200** OK ``` { "security_protection_group" : { "id" : "9ca00844-f8de-4184-9771-de792b728c28", "name" : "test_name", "availability_zone" : "az1.dc1", "protection_domains" : [ { "id" : "f96af29c-0212-4f94-a951-3b278ec6c776", "name" : "PD1", "volume_count" : 0 }, { "id" : "cdb6c00a-b822-4733-bcb6-4b8b3479e8af", "name" : "PD2", "volume_count" : 0 }, { "id" : "3a214fe1-6b5d-4b51-8376-2f1d4586741e", "name" : "PD3", "volume_count" : 0 } ], "created_at" : "2025-06-30T09:34:44.483388", "updated_at" : "2025-06-30T09:34:44.488778" } } ``` **状态码：400** Bad Request ``` { "error" : { "message" : "XXXX", "code" : "EVS.XXX" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-evs/evs_04_0038.html)。