创建证书
功能介绍
创建用于弹性负载均衡器HTTPS/TLS/QUIC协议监听器的证书。支持关联云证书与管理服务(CCM)的证书，或者使用自有证书。
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/elb/certificates
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释：项目ID。获取方式请参见获取项目ID。 约束限制：不涉及 取值范围：长度为32个字符，由小写字母和数字组成。 默认取值：不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释：IAM鉴权Token。 约束限制：不涉及 取值范围：不涉及 默认取值：不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| certificate | 是 | CreateCertificateOption object | 参数解释：创建证书参数对象。 约束限制：不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| admin_state_up | 否 | Boolean | 参数解释：证书的管理状态。该字段当前无用，设置为true或者false都不影响证书使用。 约束限制：不涉及 取值范围：
默认取值：true |
| certificate | 否 | String | 参数解释：证书内容。支持最大11层证书链(含证书和证书链)。 约束限制：不涉及 取值范围：PEM编码格式，最大长度65536个字符。 默认取值：不涉及 |
| description | 否 | String | 参数解释：证书的描述。 约束限制：不涉及 取值范围：0-255个字符。 默认取值：不涉及 |
| domain | 否 | String | 参数解释：服务器证书所签域名。 约束限制：该字段仅type为server时有效（其他类型证书，字段可传入，但不会生效）。 取值范围：总长度为0-10000，由若干普通域名或泛域名组成，域名之间以","分隔，不超过100个域名。
默认取值：不涉及 |
| name | 否 | String | 参数解释：证书的名称。 约束限制：不涉及 取值范围：0-255个字符。 默认取值：不涉及 |
| private_key | 否 | String | 参数解释：服务器证书的私钥。 约束限制：
取值范围：PEM编码格式，最大长度8192个字符。 默认取值：不涉及 |
| project_id | 否 | String | 参数解释：项目ID。获取方式请参见获取项目ID。 约束限制：不涉及 取值范围：长度为32个字符，由小写字母和数字组成。 默认取值：不涉及 说明： 该字段实际无效，最终使用url中的project_id。 |
| type | 否 | String | 参数解释：证书的类型。 约束限制：不涉及 取值范围：
默认取值：server |
| enterprise_project_id | 否 | String | 参数解释：资源所属的企业项目ID。创建时不传则资源属于default企业项目，返回enterprise_project_id="0"。 约束限制：不能传入空字符串""、"0"或不存在的企业项目ID。 取值范围：不涉及 默认取值："0" |
| source | 否 | String | 参数解释：标记当前证书来源。 约束限制：无 取值范围：
默认取值：当scm_certificate_id不为空，默认取值为"scm"。否则默认为空值。 |
| protection_status | 否 | String | 参数解释：修改保护状态。 约束限制：不涉及 取值范围：
默认取值：nonProtection |
| protection_reason | 否 | String | 参数解释：修改保护的原因。 约束限制：仅当protection_status为consoleProtection时有效。 取值范围：不涉及 默认取值：空 |
响应参数
状态码：201
| 参数 | 参数类型 | 描述 |
|---|---|---|
| request_id | String | 参数解释：请求ID。 取值范围：由数字、小写字母和中划线（-）组成的字符串，自动生成。 |
| certificate | CertificateInfo object | 证书对象。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| admin_state_up | Boolean | 参数解释：证书的管理状态。该字段当前无用，设置为true或者false都不影响证书使用。 取值范围：
|
| certificate | String | 参数解释：证书内容。支持最大11层证书链(含证书和证书链)。 取值范围：PEM编码格式，最大长度65536个字符。 |
| description | String | 参数解释：证书的描述。 取值范围：0-255个字符。 |
| domain | String | 参数解释：服务器证书所签域名。 取值范围：总长度为0-10000，由若干普通域名或泛域名组成，域名之间以","分隔，不超过100个域名。
|
| id | String | 参数解释：ELB证书管理对象ID。 取值范围：由32位数字和小写字母组成。 |
| name | String | 参数解释：证书的名称。 取值范围：0-255个字符。 |
| private_key | String | 参数解释：服务器证书的私钥。 取值范围：PEM编码格式，最大长度8192个字符。 |
| type | String | 参数解释：证书的类型。 取值范围：
|
| created_at | String | 参数解释：创建时间。 取值范围：格式：yyyy-MM-dd'T'HH:mm:ss'Z'，UTC时区。 |
| updated_at | String | 参数解释：更新时间。 取值范围：格式：yyyy-MM-dd'T'HH:mm:ss'Z'，UTC时区。 |
| expire_time | String | 参数解释：证书有效期的截止时间。 取值范围：格式：yyyy-MM-dd'T'HH:mm:ss'Z'，UTC时区。 |
| project_id | String | 参数解释：项目ID。获取方式请参见获取项目ID。 取值范围：长度为32个字符，由小写字母和数字组成。 |
| scm_certificate_id | String | 参数解释：云证书与管理服务（CCM）中的证书ID。 取值范围：不涉及 |
| common_name | String | 参数解释：证书绑定的主域名。 取值范围：不涉及 |
| fingerprint | String | 参数解释：证书指纹。 取值范围：不涉及 |
| source | String | 参数解释：标记当前证书来源。 取值范围：
|
| protection_status | String | 参数解释：修改保护状态。 取值范围：
|
| protection_reason | String | 参数解释：修改保护的原因。 取值范围：不涉及 |
| enterprise_project_id | String | 参数解释：资源所属的企业项目ID。 取值范围：
|
请求示例
创建服务器证书，并指定HTTPS协议使用的私钥
POST https://{ELB_Endpoint}/v3/{project_id}/elb/certificates
{
"certificate" : {
"name" : "My Certificate",
"type" : "server",
"private_key" : "-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDQVAbOLe5xNf4M\n253Wn9vhdUzojetjv4J+B7kYwsMhRcgdcJ8KCnX1nfzTvI2ksXlTQ2o9BkpStnPe\ntB4s32ZiJRMlk+61iUUMNsHwK2WBX57JT3JgmyVbH8GbmRY0+H3sH1i72luna7rM\nMD30gLh6QoP3cq7PGWcuZKV7hjd1tjCTQukwMvqV8Icq39buNpIgDOWzEP5AzqXt\nCOFYn6RTH5SRug4hKNN7sT1eYMslHu7wtEBDKVgrLjOCe/W2f8rLT1zEsoAW2Chl\nZAPYUBkl/0XuTWRg3CohPPcI+UtlRSfvLDeeQ460swjbwgS/RbJh3sIwlCRLU08k\nEo04Z9H/AgMBAAECggEAEIeaQqHCWZk/HyYN0Am/GJSGFa2tD60SXY2fUieh8/Hl\nfvCArftGgMaYWPSNCJRMXB7tPwpQu19esjz4Z/cR2Je4fTLPrffGUsHFgZjv5OQB\nZVe4a5Hj1OcgJYhwCqPs2d9i2wToYNBbcfgh8lSETq8YaXngBO6vES9LMhHkNKKr\nciu9YkInNEHu6uRJ5g/eGGX3KQynTvVIhnOVGAJvjTXcoU6fm7gYdHAD6jk9lc9M\nEGpfYI6AdHIwFZcT/RNAxhP82lg2gUJSgAu66FfDjMwQXKbafKdP3zq4Up8a7Ale\nkrguPtfV1vWklg+bUFhgGaiAEYTpAUN9t2DVIiijgQKBgQDnYMMsaF0r557CM1CT\nXUqgCZo8MKeV2jf2drlxRRwRl33SksQbzAQ/qrLdT7GP3sCGqvkxWY2FPdFYf8kx\nGcCeZPcIeZYCQAM41pjtsaM8tVbLWVR8UtGBuQoPSph7JNF3Tm/JH/fbwjpjP7dt\nJ7n8EzkRUNE6aIMHOFEeych/PQKBgQDmf1bMogx63rTcwQ0PEZ9Vt7mTgKYK4aLr\niWgTWHXPZxUQaYhpjXo6+lMI6DpExiDgBAkMzJGIvS7yQiYWU+wthAr9urbWYdGZ\nlS6VjoTkF6r7VZoILXX0fbuXh6lm8K8IQRfBpJff56p9phMwaBpDNDrfpHB5utBU\nxs40yIdp6wKBgQC69Cp/xUwTX7GdxQzEJctYiKnBHKcspAg38zJf3bGSXU/jR4eB\n1lVQhELGI9CbKSdzKM71GyEImix/T7FnJSHIWlho1qVo6AQyduNWnAQD15pr8KAd\nXGXAZZ1FQcb3KYa+2fflERmazdOTwjYZ0tGqZnXkEeMdSLkmqlCRigWhGQKBgDak\n/735uP20KKqhNehZpC2dJei7OiIgRhCS/dKASUXHSW4fptBnUxACYocdDxtY4Vha\nfI7FPMdvGl8ioYbvlHFh+X0Xs9r1S8yeWnHoXMb6eXWmYKMJrAoveLa+2cFm1Agf\n7nLhA4R4lqm9IpV6SKegDUkR4fxp9pPyodZPqBLLAoGBAJkD4wHW54Pwd4Ctfk9o\njHjWB7pQlUYpTZO9dm+4fpCMn9Okf43AE2yAOaAP94GdzdDJkxfciXKcsYr9IIuk\nfaoXgjKR7p1zERiWZuFF63SB4aiyX1H7IX0MwHDZQO38a5gZaOm/BUlGKMWXzuEd\n3fy+1rCUwzOp9LSjtJYf4ege\n-----END PRIVATE KEY-----",
"certificate" : "-----BEGIN CERTIFICATE-----\nMIIC4TCCAcmgAwIBAgICEREwDQYJKoZIhvcNAQELBQAwFzEVMBMGA1UEAxMMTXlD\nb21wYW55IENBMB4XDTE4MDcwMjEzMjU0N1oXDTQ1MTExNzEzMjU0N1owFDESMBAG\nA1UEAwwJbG9jYWxob3N0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA\n0FQGzi3ucTX+DNud1p/b4XVM6I3rY7+Cfge5GMLDIUXIHXCfCgp19Z3807yNpLF5\nU0NqPQZKUrZz3rQeLN9mYiUTJZPutYlFDDbB8CtlgV+eyU9yYJslWx/Bm5kWNPh9\n7B9Yu9pbp2u6zDA99IC4ekKD93KuzxlnLmSle4Y3dbYwk0LpMDL6lfCHKt/W7jaS\nIAzlsxD+QM6l7QjhWJ+kUx+UkboOISjTe7E9XmDLJR7u8LRAQylYKy4zgnv1tn/K\ny09cxLKAFtgoZWQD2FAZJf9F7k1kYNwqITz3CPlLZUUn7yw3nkOOtLMI28IEv0Wy\nYd7CMJQkS1NPJBKNOGfR/wIDAQABozowODAhBgNVHREEGjAYggpkb21haW4uY29t\nhwQKuUvJhwR/AAABMBMGA1UdJQQMMAoGCCsGAQUFBwMBMA0GCSqGSIb3DQEBCwUA\nA4IBAQA8lMQJxaTey7EjXtRLSVlEAMftAQPG6jijNQuvIBQYUDauDT4W2XUZ5wAn\njiOyQ83va672K1G9s8n6xlH+xwwdSNnozaKzC87vwSeZKIOdl9I5I98TGKI6OoDa\nezmzCwQYtHBMVQ4c7Ml8554Ft1mWSt4dMAK2rzNYjvPRLYlzp1HMnI6hkjPk4PCZ\nwKnha0dlScati9CCt3UzXSNJOSLalKdHErH08Iqd+1BchScxCfk0xNITn1HZZGmI\n+vbmunok3A2lucI14rnsrcbkGYqxGikySN6B2cRLBDK4Y3wChiW6NVYtVqcx5/mZ\niYsGDVN+9QBd0eYUHce+77s96i3I\n-----END CERTIFICATE-----"
}
} 响应示例
状态码：201
POST操作正常返回。
{
"certificate" : {
"private_key" : "-----BEGIN PRIVATE KEY-----MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDQVAbOLe5xNf4M253Wn9vhdUzojetjv4J+B7kYwsMhRcgdcJ8KCnX1nfzTvI2ksXlTQ2o9BkpStnPetB4s32ZiJRMlk+61iUUMNsHwK2WBX57JT3JgmyVbH8GbmRY0+H3sH1i72luna7rMMD30gLh6QoP3cq7PGWcuZKV7hjd1tjCTQukwMvqV8Icq39buNpIgDOWzEP5AzqXtCOFYn6RTH5SRug4hKNN7sT1eYMslHu7wtEBDKVgrLjOCe/W2f8rLT1zEsoAW2ChlZAPYUBkl/0XuTWRg3CohPPcI+UtlRSfvLDeeQ460swjbwgS/RbJh3sIwlCRLU08kEo04Z9H/AgMBAAECggEAEIeaQqHCWZk/HyYN0Am/GJSGFa2tD60SXY2fUieh8/HlfvCArftGgMaYWPSNCJRMXB7tPwpQu19esjz4Z/cR2Je4fTLPrffGUsHFgZjv5OQBZVe4a5Hj1OcgJYhwCqPs2d9i2wToYNBbcfgh8lSETq8YaXngBO6vES9LMhHkNKKrciu9YkInNEHu6uRJ5g/eGGX3KQynTvVIhnOVGAJvjTXcoU6fm7gYdHAD6jk9lc9MEGpfYI6AdHIwFZcT/RNAxhP82lg2gUJSgAu66FfDjMwQXKbafKdP3zq4Up8a7AlekrguPtfV1vWklg+bUFhgGaiAEYTpAUN9t2DVIiijgQKBgQDnYMMsaF0r557CM1CTXUqgCZo8MKeV2jf2drlxRRwRl33SksQbzAQ/qrLdT7GP3sCGqvkxWY2FPdFYf8kxGcCeZPcIeZYCQAM41pjtsaM8tVbLWVR8UtGBuQoPSph7JNF3Tm/JH/fbwjpjP7dtJ7n8EzkRUNE6aIMHOFEeych/PQKBgQDmf1bMogx63rTcwQ0PEZ9Vt7mTgKYK4aLriWgTWHXPZxUQaYhpjXo6+lMI6DpExiDgBAkMzJGIvS7yQiYWU+wthAr9urbWYdGZlS6VjoTkF6r7VZoILXX0fbuXh6lm8K8IQRfBpJff56p9phMwaBpDNDrfpHB5utBUxs40yIdp6wKBgQC69Cp/xUwTX7GdxQzEJctYiKnBHKcspAg38zJf3bGSXU/jR4eB1lVQhELGI9CbKSdzKM71GyEImix/T7FnJSHIWlho1qVo6AQyduNWnAQD15pr8KAdXGXAZZ1FQcb3KYa+2fflERmazdOTwjYZ0tGqZnXkEeMdSLkmqlCRigWhGQKBgDak/735uP20KKqhNehZpC2dJei7OiIgRhCS/dKASUXHSW4fptBnUxACYocdDxtY4VhafI7FPMdvGl8ioYbvlHFh+X0Xs9r1S8yeWnHoXMb6eXWmYKMJrAoveLa+2cFm1Agf7nLhA4R4lqm9IpV6SKegDUkR4fxp9pPyodZPqBLLAoGBAJkD4wHW54Pwd4Ctfk9ojHjWB7pQlUYpTZO9dm+4fpCMn9Okf43AE2yAOaAP94GdzdDJkxfciXKcsYr9IIukfaoXgjKR7p1zERiWZuFF63SB4aiyX1H7IX0MwHDZQO38a5gZaOm/BUlGKMWXzuEd3fy+1rCUwzOp9LSjtJYf4ege-----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-----MIIC4TCCAcmgAwIBAgICEREwDQYJKoZIhvcNAQELBQAwFzEVMBMGA1UEAxMMTXlDb21wYW55IENBMB4XDTE4MDcwMjEzMjU0N1oXDTQ1MTExNzEzMjU0N1owFDESMBAGA1UEAwwJbG9jYWxob3N0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0FQGzi3ucTX+DNud1p/b4XVM6I3rY7+Cfge5GMLDIUXIHXCfCgp19Z3807yNpLF5U0NqPQZKUrZz3rQeLN9mYiUTJZPutYlFDDbB8CtlgV+eyU9yYJslWx/Bm5kWNPh97B9Yu9pbp2u6zDA99IC4ekKD93KuzxlnLmSle4Y3dbYwk0LpMDL6lfCHKt/W7jaSIAzlsxD+QM6l7QjhWJ+kUx+UkboOISjTe7E9XmDLJR7u8LRAQylYKy4zgnv1tn/Ky09cxLKAFtgoZWQD2FAZJf9F7k1kYNwqITz3CPlLZUUn7yw3nkOOtLMI28IEv0WyYd7CMJQkS1NPJBKNOGfR/wIDAQABozowODAhBgNVHREEGjAYggpkb21haW4uY29thwQKuUvJhwR/AAABMBMGA1UdJQQMMAoGCCsGAQUFBwMBMA0GCSqGSIb3DQEBCwUAA4IBAQA8lMQJxaTey7EjXtRLSVlEAMftAQPG6jijNQuvIBQYUDauDT4W2XUZ5wAnjiOyQ83va672K1G9s8n6xlH+xwwdSNnozaKzC87vwSeZKIOdl9I5I98TGKI6OoDaezmzCwQYtHBMVQ4c7Ml8554Ft1mWSt4dMAK2rzNYjvPRLYlzp1HMnI6hkjPk4PCZwKnha0dlScati9CCt3UzXSNJOSLalKdHErH08Iqd+1BchScxCfk0xNITn1HZZGmI+vbmunok3A2lucI14rnsrcbkGYqxGikySN6B2cRLBDK4Y3wChiW6NVYtVqcx5/mZiYsGDVN+9QBd0eYUHce+77s96i3I-----END CERTIFICATE-----",
"admin_state_up" : true,
"project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
"updated_at" : "2019-03-31T23:26:49Z",
"type" : "server",
"common_name" : "www.example.com",
"fingerprint" : "869df7fcb441c2ef3fb9329437815972eeb1ef0e",
"subject_alternative_names" : [ "www.example.com" ],
"scm_certificate_id" : "",
"source" : "",
"protection_status" : "nonProtection",
"protection_reason" : "",
"enc_certificate" : "",
"enc_private_key" : ""
},
"request_id" : "98414965-856c-4be3-8a33-3e08432a222e"
} 状态码
| 状态码 | 描述 |
|---|---|
| 201 | POST操作正常返回。 |
错误码
请参见错误码。
