更新时间：2025-11-27 GMT+08:00
添加服务器证书
功能介绍
应用服务器可调用此接口在物联网平台上添加服务器证书，服务器证书配额限制为：2个。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v5/iot/{project_id}/server-certificates
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数说明：项目ID。获取方法请参见 获取项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Instance-Id |
否 |
String |
参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考 查看实例详情。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
certificate_pem |
是 |
String |
参数说明：证书内容，PEM格式。 取值范围：合法PEM格式证书内容，长度不超过65535。 |
|
private_key |
是 |
String |
参数说明：证书私钥。 取值范围：合法私钥内容，长度不超过10240。 |
|
private_key_password |
否 |
String |
参数说明：私钥密码。 取值范围：只支持英文字符，长度不超过64。 |
响应参数
状态码：201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
server_certificate_id |
String |
唯一标识ID |
|
common_name |
String |
参数说明：证书通用名 |
|
effective_date |
String |
证书生效日期。格式：yyyyMMdd'T'HHmmss'Z'，如20151212T121212Z。 |
|
expiry_date |
String |
证书失效日期。格式：yyyyMMdd'T'HHmmss'Z'，如20151212T121212Z。 |
|
certificate_owner |
String |
证书所有者。 |
|
certificate_issuer |
String |
证书颁发者。 |
请求示例
添加服务器证书。
POST https://{endpoint}/v5/iot/{project_id}/server-certificates
{
"certificate_pem" : "-----BEGINCERTIFICATE-----\nMIID2TCCAsGgAwIBAgIJAOEDEgVdVMn9MA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD\nVQQGEwJDTjERMA8GA1UECAwIR3VhbmRvbmcxETAPBgNVBAcMCFNoZW56aGVuMQ8w\nDQYDVQQKDAZIdWF3ZWkxDDAKBgNVBAsMA2lvdDESMBAGA1UEAwwJMTIzNDU2Nzg5\nMRowGAYJKoZIhvcNAQkBFgtkamthQHFxLmNvbTAeFw0xOTEyMTkxMzE1MjZaFw0y\nMjEwMDgxMzE1MjZaMIGCMQswCQYDVQQGEwJDTjERMA8GA1UECAwIR3VhbmRvbmcx\nETAPBgNVBAcMCFNoZW56aGVuMQ8wDQYDVQQKDAZIdWF3ZWkxDDAKBgNVBAsMA2lv\ndDESMBAGA1UEAwwJMTIzNDU2Nzg5MRowGAYJKoZIhvcNAQkBFgtkamthQHFxLmNv\nbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAM72QUzoadvLfxGjt3UF\noZ4MJbblqnRbouO4KpOVHBXyS2yQVl4CWWMhLh4pp2efNUSqKuXHjY3r68PquyNn\nYk8zO59zVc7JHvjGkBvo7DgPRAhEKPLJIpRzkmlCBbxwTNCjc3FovGb/sHHNlpGn\ncCKUzMfPGNZuBiuemskuEXL/eMHxDPbXYWn4Wq0wt+28PKUL5jybY7nsXSNnmAPF\nTO0CAmq0meUukubT/jHDCQ78ihQ/iqw1RNq88aCqRleoHiGg5nWkjL+05GXqUrqV\nVnZNL+YqcXzuVMs5XgyhNM2AsuH2g3D8ZuF6Dj9qY1n/v/Cp/DGpxP3A74SlplnF\nD/0CAwEAAaNQME4wHQYDVR0OBBYEFAVPWVtpTdO6KQnmVrrNlMguWNR7MB8GA1Ud\nIwQYMBaAFAVPWVtpTdO6KQnmVrrNlMguWNR7MAwGA1UdEwQFMAMBAf8wDQYJKoZI\nhvcNAQELBQADggEBAE40ViqK+UaEn++Xq6f4Cmeg3JqYHu47v9RIAASNihYRBQ/r\n3RE7Af3GqjIO5nMJJuCMzdcoAU8N9KwkgXD+GLR9fYLEoEmq5CrhgaGDsCi85vCs\nmWhj5z8r5TG207xpmvH2KT447dnG+chMBE594ma85dCv+0mCDrqNToElipgT8+rY\nAYVClnIt3kbsTg1vSRNHadd+TpgRVxJZBF0fHcCAyc/2f3UJgPYNWShIetHM6BdI\n3fZ4H+eeHPjagm5kzmffli1cUv2/N+1hKUvcI4uFCqEwZRFtp90RyIbxUfQwi+Cs\nXVnwV+BZS5qD9bTcfxZMXhuVRwO/5xWYMYPN1uY=\n-----END CERTIFICATE-----",
"private_key" : "-----BEGIN RSA PRIVATE KEY-----\nMIIEpAIBAAKCAQEAxSzvkmyd7QBjQhLTod9HK+fGVgoJWKAiecwYFqiitFEXR1v8\n6cwqi4WGNsrn/HAaeD/dezw98BBGUzfHL6tl7J5tr/CoC88P34ZeDwoDJb184kl5\nKOJMXOB5126g3i58w6AYi3MNNuswBTbt3JP+x3TmbCyzYJ6cN1ASGPJNHhWFLu4B\nOqrkKL0umzWzzj8CYDoMd4JaChYjdyhuyLaHvcWV1VHlOsdUeE+L4kIDilxqubnd\ncLtcn/kQDf/DMUOchFaZB4c096ksAoZEZxeoCQI2DzT2lQImgVo+XtseTNJ5BC2b\npp457J1X7pJq5QOt1bJ0Dxu9ENvNCy9qCMIm4wIDAQABAoIBAG4OGtp7zdpPcRec\nMowTeEJFaCr2Byl0mEmrZXagQdCrwnaOHajR0J13teY3cy0v1VZxL0pt4ZRxQQ+J\n/p/Y51cfRtIBXYrZ1F5LPYzfZcpW7bHQmNP9G+prURayJRBemj0Gyyxq12Fj/LWs\nZy/LW1YxJbwTZzvyy/cDtlY+SFUVaSQ2Nu+C450jmBnwLN5YqM2m77X1yvIdD5Y/\n3KjCmhHdrY2ulO3dptmI3Ju3e7GACy0VJstcKlaOcpFFpVh9lC1DMvGE3dtLzXln\nBQVMwTZl9RKikLAsyIcNaTVnhb61QmLT/4S6Tdafxr11JWPEw6ilVozeZOnnuPGO\no02FpyECgYEA/vcg8iUGx7ftV/c3ePnCLiXH8HGZzC5OUjSuu6n15iF0f6WP56rQ\nirX1mkYwXg7MbmSTikqwcbjBuoPBwYZnXTPpH3K2VTG44B+AC/VnHdTqWYPhq8ug\naeUuVkZYiopCKMaOpFCgiSo3YbLi22t8oXXWeGWNOys6vIfBZv9UT70CgYEAxfnF\npYmFaI38kDLJInVFb5qMjcEP4OpryoSgs8J2mMoWePOu0x8FOkxqwLqjGr2ETsPy\nCK62webYw7I3ITqkZU8zRm6phQuaS5IJK7ubnHYNMx+xcFWsssHrzMEjLnbSCM0D\nwQ0x/gPHl+okRe33FQO51jEQ+OxJglNlWxpi6x8CgYEAzAVArcMHK+V33L4L+5gP\n1BGTbknZAdPEBG/3ql+UTzRSHpqDDqRW/8ge4fZsWbeJyoRcs3qUuktXakJoVs2Q\nBLq3PtzyHjYNc/qA4hDbFLn9VOf9OxVUJaiobY0Y6LM9wZcxKTcDXv8TFfCpK19V\neXXryqeoXcJ328jd7+c8thkCgYEAvRByU0tI73eheig180VhQVqr3fhA7L+Snz4X\npnQRBIsB+RJmo9JdELbHwDS87R2ODBaOvwHzIKwP2JwKkB5Lv0BqrFmkZJ2XBZJ6\nVZx92GbY5jjfIHOBUNlnEgxkR8xLewInEqdCVd5QL2D4sRu3ugbr44TKO56T+PUh\nt2Y0j2sCgYBpMV9Z1WWdqm7sR/Mh41kLmEdbANgElIyMellEqvCUE7Dh5b44VVkj\nDJkKWwfJtjUaJSd6SHzNTtvF3RAjTcp4kxaVqkMuK11w+bQNpJKk3lGvyCC5eH2U\nVwS2lC+WRlApFQBxdNu5Hf7gvlSW6E2yplBdHj9TED/WUpFNFazG0w==\n-----END RSA PRIVATE KEY-----"
}
响应示例
状态码：201
Created
{
"server_certificate_id" : "60f8c49169d4840337930a4b",
"common_name" : "iotda",
"certificate_pem" : "-----BEGINCERTIFICATE-----\nMIID2TCCAsGgAwIBAgIJAOEDEgVdVMn9MA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD\nVQQGEwJDTjERMA8GA1UECAwIR3VhbmRvbmcxETAPBgNVBAcMCFNoZW56aGVuMQ8w\nDQYDVQQKDAZIdWF3ZWkxDDAKBgNVBAsMA2lvdDESMBAGA1UEAwwJMTIzNDU2Nzg5\nMRowGAYJKoZIhvcNAQkBFgtkamthQHFxLmNvbTAeFw0xOTEyMTkxMzE1MjZaFw0y\nMjEwMDgxMzE1MjZaMIGCMQswCQYDVQQGEwJDTjERMA8GA1UECAwIR3VhbmRvbmcx\nETAPBgNVBAcMCFNoZW56aGVuMQ8wDQYDVQQKDAZIdWF3ZWkxDDAKBgNVBAsMA2lv\ndDESMBAGA1UEAwwJMTIzNDU2Nzg5MRowGAYJKoZIhvcNAQkBFgtkamthQHFxLmNv\nbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAM72QUzoadvLfxGjt3UF\noZ4MJbblqnRbouO4KpOVHBXyS2yQVl4CWWMhLh4pp2efNUSqKuXHjY3r68PquyNn\nYk8zO59zVc7JHvjGkBvo7DgPRAhEKPLJIpRzkmlCBbxwTNCjc3FovGb/sHHNlpGn\ncCKUzMfPGNZuBiuemskuEXL/eMHxDPbXYWn4Wq0wt+28PKUL5jybY7nsXSNnmAPF\nTO0CAmq0meUukubT/jHDCQ78ihQ/iqw1RNq88aCqRleoHiGg5nWkjL+05GXqUrqV\nVnZNL+YqcXzuVMs5XgyhNM2AsuH2g3D8ZuF6Dj9qY1n/v/Cp/DGpxP3A74SlplnF\nD/0CAwEAAaNQME4wHQYDVR0OBBYEFAVPWVtpTdO6KQnmVrrNlMguWNR7MB8GA1Ud\nIwQYMBaAFAVPWVtpTdO6KQnmVrrNlMguWNR7MAwGA1UdEwQFMAMBAf8wDQYJKoZI\nhvcNAQELBQADggEBAE40ViqK+UaEn++Xq6f4Cmeg3JqYHu47v9RIAASNihYRBQ/r\n3RE7Af3GqjIO5nMJJuCMzdcoAU8N9KwkgXD+GLR9fYLEoEmq5CrhgaGDsCi85vCs\nmWhj5z8r5TG207xpmvH2KT447dnG+chMBE594ma85dCv+0mCDrqNToElipgT8+rY\nAYVClnIt3kbsTg1vSRNHadd+TpgRVxJZBF0fHcCAyc/2f3UJgPYNWShIetHM6BdI\n3fZ4H+eeHPjagm5kzmffli1cUv2/N+1hKUvcI4uFCqEwZRFtp90RyIbxUfQwi+Cs\nXVnwV+BZS5qD9bTcfxZMXhuVRwO/5xWYMYPN1uY=\n-----END CERTIFICATE-----",
"effective_date" : "20251212T121212Z",
"expiry_date" : "20301212T121212Z",
"certificate_owner" : "CN=Huawei Cloud Core Network Product CA, O=Huawei, C=CN",
"certificate_issuer" : "CN=Huawei Cloud Core Network Product CA, O=Huawei, C=CN"
}
状态码
|
状态码 |
描述 |
|---|---|
|
201 |
Created |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
400 |
Bad Request |
|
500 |
Internal Server Error |
错误码
请参见错误码。
父主题： 服务器证书管理
