文档首页/弹性负载均衡 ELB/API参考（安卡拉区域）/API（V3）/安全策略/创建自定义安全策略
更新时间：2025-02-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建自定义安全策略

功能介绍

创建自定义安全策略。用于在创建HTTPS监听器时，请求参数中指定security_policy_id来设置监听器的自定义安全策略。

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/elb/security-policies

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：IAM鉴权Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

security_policy

是

CreateSecurityPolicyOption object

创建自定义安全策略的请求体。

表4 CreateSecurityPolicyOption

参数

是否必选

参数类型

描述

name

否

String

自定义安全策略的名称。默认空字符串""。

description

否

String

自定义安全策略的描述信息。默认空字符串""。

enterprise_project_id

否

String

所属企业项目ID。

protocols

是

Array of strings

自定义安全策略选择的TLS协议列表。取值：TLSv1, TLSv1.1, TLSv1.2, TLSv1.3

ciphers

是

Array of strings

自定义安全策略的加密套件列表。支持以下加密套件：

ECDHE-RSA-AES256-GCM-SHA384,ECDHE-RSA-AES128-GCM-SHA256,

ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES128-GCM-SHA256,

AES128-GCM-SHA256,AES256-GCM-SHA384,ECDHE-ECDSA-AES128-SHA256,

ECDHE-RSA-AES128-SHA256,AES128-SHA256,AES256-SHA256,

ECDHE-ECDSA-AES256-SHA384,ECDHE-RSA-AES256-SHA384,

ECDHE-ECDSA-AES128-SHA,ECDHE-RSA-AES128-SHA,ECDHE-RSA-AES256-SHA,

ECDHE-ECDSA-AES256-SHA,AES128-SHA,AES256-SHA,CAMELLIA128-SHA,

DES-CBC3-SHA,CAMELLIA256-SHA,ECDHE-RSA-CHACHA20-POLY1305,

ECDHE-ECDSA-CHACHA20-POLY1305,TLS_AES_128_GCM_SHA256,

TLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256,

TLS_AES_128_CCM_SHA256,TLS_AES_128_CCM_8_SHA256

使用说明：

  • 协议和加密套件必须匹配，即ciphers中必须至少有一种有与协议匹配的加密套件。

说明：

协议与加密套件的匹配关系可参考系统安全策略

响应参数

状态码：201

表5 响应Body参数

参数

参数类型

描述

security_policy

SecurityPolicy object

安全策略列表返回对象。

request_id

String

请求ID。

注：自动生成 。

表6 SecurityPolicy

参数

参数类型

描述

id

String

自定义安全安全策略的id。

project_id

String

自定义安全策略的项目id。

name

String

自定义安全策略的名称

description

String

自定义安全策略的描述。

listeners

Array of ListenerRef objects

自定义安全策略关联的监听器。

protocols

Array of strings

自定义安全策略的TLS协议列表。

ciphers

Array of strings

自定义安全策略的加密套件列表。

created_at

String

自定义安全策略的创建时间。

updated_at

String

自定义安全策略的更新时间。

表7 ListenerRef

参数

参数类型

描述

id

String

参数解释：监听器ID。

请求示例

创建自定义安全策略，并指定策略使用的TLS协议和加密套件

POST https://{ELB_Endpoint}/v3/7a9941d34fc1497d8d0797429ecfd354/elb/security-policies

{
  "security_policy" : {
    "name" : "test_1",
    "description" : "test1",
    "protocols" : [ "TLSv1.2", "TLSv1", "TLSv1.3" ],
    "ciphers" : [ "ECDHE-ECDSA-AES128-SHA", "TLS_AES_128_GCM_SHA256", "TLS_AES_128_CCM_8_SHA256" ]
  }
}

响应示例

状态码：201

POST操作正常返回。

{
  "request_id" : "6b50d914-41f2-4e50-8929-e8a9837dbe75",
  "security_policy" : {
    "id" : "d74e27c9-4d60-427c-a11f-21142117c433",
    "name" : "test_1",
    "project_id" : "7a9941d34fc1497d8d0797429ecfd354",
    "description" : "test1",
    "protocols" : [ "TLSv1.2", "TLSv1", "TLSv1.3" ],
    "ciphers" : [ "ECDHE-ECDSA-AES128-SHA", "TLS_AES_128_GCM_SHA256", "TLS_AES_128_CCM_8_SHA256" ],
    "listeners" : [ ],
    "created_at" : "2021-03-26T01:33:12Z",
    "updated_at" : "2021-03-26T01:33:12Z"
  }
}

状态码

状态码

描述

201

POST操作正常返回。

错误码

请参见错误码。

父主题：安全策略