接口约束
4.6 负载均衡器
4.7.1 创建证书
响应示例
无
状态码
状态码 描述
200 OK
错误码
请参见错误码。
4.7 证书
4.7.1 创建证书
功能介绍
调试
您可以在API Explorer中调试该接口。
URI
POST /v3/{project_id}/elb/certificates
表4-107 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID。
请求参数
表4-108 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String IAM鉴权Token。
表4-109 请求 Body 参数
参数 是否必选 参数类型 描述
certificate 是 CreateCertifi cateOption object
证书对象。
表4-110 CreateCertificateOption
参数 是否必选 参数类型 描述
admin_state_
up 否 Boolean 证书的管理状态。
不支持该字段，请勿使用。
certificate 是 String HTTPS协议使用的证书内容。
如果type为server_sm时，该字 段填写SM签名证书内容。 取值 范围：PEM编码格式。
description 否 String 证书的描述。
最小长度：0 最大长度：255
参数 是否必选 参数类型 描述
domain 否 String 服务器证书所签域名。该字段仅
type为server或server_sm时有
private_key 否 String HTTPS协议使用的私钥。仅type 为server或server_sm时有效。
type为server或server_sm时必 选。 如果type为server_sm时，
该字段填写SM签名证书的私 钥。 取值范围：PEM编码格 式。
project_id 否 String 证书所在的项目ID。
最小长度：1 最大长度：32
type 否 String SSL证书的类型。分为服务器证
书(server)、CA证书(client)和 服务器SM双证书(server_sm)。
默认值：server enterprise_pro
ject_id 否 String 证书所属的企业项目ID。
enc_certificate 否 String HTTPS协议使用的SM加密证书 内容。
取值：PEM编码格式。
使用说明：
● 仅type为server_sm时有效且 必选。
参数 是否必选 参数类型 描述 enc_private_k
ey 否 String HTTPS协议使用的SM加密证书
私钥。
取值：PEM编码格式。
使用说明：
● 仅type为server_sm时有效且 必选。
响应参数
状态码： 201
表4-111 响应 Body 参数
参数 参数类型 描述
request_id String 请求ID。
注：自动生成 。 certificate CertificateInf
o object 证书对象。
表4-112 CertificateInfo
参数 参数类型 描述
admin_state_
up Boolean 证书的管理状态。
不支持该字段，请勿使用。
certificate String 证书的内容。PEM编码格式。
description String 证书的描述。
最小长度：1 最大长度：255
domain String 服务器证书所签域名。该字段仅type为server时 有效。 总长度为0-1024，由若干普通域名或泛域 名组成，域名之间以","分割，不超过30个域名。
普通域名：由若干字符串组成，字符串间以"."分 割，单个字符串长度不超过63个字符，只能包含 英文字母、数字或"-"，且必须以字母或数字开头 和结尾。例：www.test.com； 泛域名：在普通 域名的基础上仅允许首字母为""。例：.test.com 最小长度：1
最大长度：1024
id String 证书ID。
参数 参数类型 描述
name String 证书的名称。
最小长度：1 最大长度：255
private_key String 服务器证书的私钥。PEM编码格式。 当type为 client时，该参数被忽略，不影响证书的创建和使 用。且若不符合格式，不报错但会被设置为空。
当type为server时，该字段必须符合格式要求，
且私钥必须是有效的。
type String 证书的类型。分为服务器证书(server)和CA证书 (client)。默认值：server。
created_at String 证书创建时间。
updated_at String 证书更新时间。
expire_time String 证书使用截止时间。
project_id String 证书所在项目ID。
enc_certificate String HTTPS协议使用的SM加密证书内容。
取值：PEM编码格式。
注意：仅在当前局点的SM加密证书特性开启才会 返回该字段。
enc_private_k
ey String HTTPS协议使用的SM加密证书私钥。
取值：PEM编码格式。
注意：仅在当前局点的SM加密证书特性开启才会 返回该字段。
请求示例
创建服务端证书
POST https://{ELB_Endpoint}/v3/{project_id}/elb/certificates { "certificate" : {
"name" : "My Certificate", "type" : "server",
"private_key" : "---BEGIN PRIVATE
KEY---\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDQVAbOLe5xNf4M
\nGcCeZPcIeZYCQAM41pjtsaM8tVbLWVR8UtGBuQoPSph7JNF3Tm/JH/fbwjpjP7dt +1rCUwzOp9LSjtJYf4ege\n---END PRIVATE KEY---",
"certificate" : "---BEGIN
CERTIFICATE---\nMIIC4TCCAcmgAwIBAgICEREwDQYJKoZIhvcNAQELBQAwFzEVMBMGA1UEAxMMTXlD +77s96i3I\n---END CERTIFICATE---"
}}
响应示例
状态码： 201
POST操作正常返回。
{ "certificate" : {
"private_key" : "---BEGIN PRIVATE
KEY---\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDQVAbOLe5xNf4M +1rCUwzOp9LSjtJYf4ege\n---END PRIVATE KEY---",
"description" : "",
"domain" : null,
"created_at" : "2019-03-31T22:23:51Z", "expire_time" : "2045-11-17T13:25:47Z", "id" : "233a325e5e3e4ce8beeb320aa714cc12", "name" : "My Certificate",
"certificate" : "---BEGIN
CERTIFICATE---\nMIIC4TCCAcmgAwIBAgICEREwDQYJKoZIhvcNAQELBQAwFzEVMBMGA1UEAxMMTXlD +77s96i3I\n---END CERTIFICATE---",
"admin_state_up" : true,
"project_id" : "99a3fff0d03c428eac3678da6a7d0f24", "updated_at" : "2019-03-31T23:26:49Z",
"type" : "server"
}, "request_id" : "98414965-856c-4be3-8a33-3e08432a222e"
}
状态码
状态码 描述
201 POST操作正常返回。
错误码
● 分页查询使用的参数为marker、limit、page_reverse。
● marker和page_reverse只有和limit一起使用时才会生效，单独使用无效。
调试
您可以在API Explorer中调试该接口。