1. 接口描述
接口请求域名: ssl.tencentcloudapi.com 。
使用权益点创建证书
默认接口请求频率限制:10次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:CreateCertificateByPackage。 |
Version | 是 | String | 公共参数,本接口取值:2019-12-05。 |
Region | 否 | String | 公共参数,本接口不需要传递此参数。 |
ProductPid | 是 | Integer | 证书产品PID,以下是对每个PID及其对应的证书文字说明: 1. 1022451 - CFCA-增强型(EV)SSL证书 2. 1022449 - CFCA-企业型(OV) SSL证书(通配符) 3. 1022447 - CFCA-企业型(OV)SSL证书 4. 1014028 - DNSPod亚信国密-企业型(OV)通配符证书 5. 1014030 - DNSPod亚信国密-企业型(OV)多域名证书 6. 1014026 - DNSPod亚信国密-企业型(OV)证书 7. 1014022 - DNSPod亚信国密-域名型(DV)通配符证书 8. 1014024 - DNSPod亚信国密-域名型(DV)多域名证书 9. 1014020 - DNSPod亚信国密-域名型(DV)证书 10. 1013949 - DNSPod SSL 域名型SSL证书(C1) 11. 1013953 - DNSPod SSL域名型多域名SSL证书(C1) 12. 1013951 - DNSPod-SSL域名型DV(泛域名) 13. 1013955 - DNSPod 企业型SSL证书(C1) 14. 1013959 - DNSPod 企业型多域名SSL证书(C1) 15. 1013957 - DNSPod 企业型通配符SSL证书(C1) 16. 1013961 - DNSPod 增强型 SSL 证书(C1) 17. 1013963 - DNSPod 增强型多域名SSL证书(C1) 18. 1005919 - TrustAsia-域名型DV(通配符多域名) 19. 1013882 - SecureSite-增强型专业版EVPro(多域名) 20. 1018559 - SecureSite-增强型专业版EVPro(单域名) 21. 1013910 - GlobalSign-增强型EV(多域名) 22. 1013904 - GlobalSign-增强型EV(单域名) 23. 1013898 - TrustAsia-增强型EV(多域名) 24. 1013888 - TrustAsia-增强型EV(单域名) 25. 1013886 - GeoTrust-增强型EV(多域名) 26. 1018529 - GeoTrust-增强型EV(单域名) 27. 1013880 - SecureSite-增强型EV(多域名) 28. 1018557 - SecureSite-增强型EV(单域名) 29. 1018586 - TrustAsia-域名型DV(泛域名) 30. 1018584 - TrustAsia-域名型DV(多域名) 31. 1013878 - SecureSite-企业型专业版OV Pro(多域名) 32. 1018582 - SecureSite-企业型专业版OV Pro(单域名) 33. 1013908 - GlobalSign-企业型OV(通配符多域名) 34. 1013902 - GlobalSign-企业型OV(泛域名) 35. 1013906 - GlobalSign-企业型OV(多域名) 36. 1013900 - GlobalSign-企业型OV(单域名) 37. 1013896 - TrustAsia-企业型OV(通配符多域名) 38. 1013892 - TrustAsia-企业型OV(泛域名) 39. 1013894 - TrustAsia-企业型OV(多域名) 40. 1013890 - TrustAsia-企业型OV(单域名) 41. 1004360 - GeoTrust-企业型OV(泛域名) 42. 1013884 - GeoTrust-企业型OV(单域名) 43. 1013874 - SecureSite-企业型OV(泛域名) 44. 1013876 - SecureSite-企业型OV(多域名) 45. 1018580 - SecureSite-企业型OV(单域名) 46. 1004460 - DNSPod-国密增强型证书(多域名) 47. 1004458 - DNSPod-国密增强型证书 48. 1004370 - DNSPod-国密企业型证书(通配符) 49. 1004368 - DNSPod-国密企业型证书(多域名) 50. 1004366 - DNSPod-国密企业型证书 51. 1004362 - DNSPod-国密域名型证书(通配符) 52. 1004364 - DNSPod-国密域名型证书(多域名) 53. 1004358 - DNSPod-国密域名型证书 54. 1004456 - WoTrus-增强型证书(多域名) 55. 1004454 - WoTrus-增强型证书 56. 1004168 - WoTrus-企业型证书(通配符) 57. 1004166 - WoTrus-企业型证书(多域名) 58. 1004164 - WoTrus-企业型证书 59. 1004159 - WoTrus-域名型证书(通配符) 60. 1004161 - WoTrus-域名型证书(多域名) 61. 1004157 - WoTrus-域名型证书 示例值:1022451 |
PackageIds.N | 是 | Array of String | 要消耗的权益包ID。 示例值:["Z21120315430001"] |
DomainCount | 是 | String | 证书域名数量。 示例值:4 |
Period | 是 | Integer | 多年期证书年限。 示例值:2 |
OldCertificateId | 否 | String | 要续费的原证书ID(续费时填写)。 示例值:heh**hsh |
RenewGenCsrMethod | 否 | String | 续费时CSR生成方式(original、upload、online)。 示例值:original |
RenewCsr | 否 | String | 续费时选择上传CSR时填写CSR。 示例值:CSR |
RenewAlgorithmType | 否 | String | 续费证书CSR的算法类型:RSA,ECC,SM2 示例值:RSA |
RenewAlgorithmParam | 否 | String | 续费证书CSR的算法参数:2048,4096,prime256v1 示例值:2048 |
ProjectId | 否 | Integer | 项目ID。 示例值:6737992 |
Tags.N | 否 | Array of Tags | 标签。 |
RenewKeyPass | 否 | String | 续费证书的私钥密码。 示例值:hehy**hwhwh |
DomainNames | 否 | String | 批量购买证书时预填写的域名。 示例值:a.com,b.com,c.com |
CertificateCount | 否 | Integer | 批量购买证书数量。 示例值:2 |
ManagerId | 否 | Integer | 预填写的管理人ID。 示例值:197382 |
CompanyId | 否 | Integer | 预填写的公司ID。 示例值:6782 |
VerifyType | 否 | String | 验证方式 示例值:DNS |
PriceKey | 否 | String | 询价参数,以下是对每个询价参数及其对应的证书文字说明: 1. sv_ssl_cost_cfca_ca_ev - CFCA-增强型(EV)SSL证书 2. sv_ssl_cost_cfca_ca_ovwildcard - CFCA-企业型(OV) SSL证书(通配符) 3. sv_ssl_cost_cfca_ca_ov - CFCA-企业型(OV)SSL证书 4. sv_ssl_cost_dnspod_ca_sm2_ovwildcard - DNSPod亚信国密-企业型(OV)通配符证书 5. sv_ssl_cost_dnspod_ca_sm2_ovmultidomain - DNSPod亚信国密-企业型(OV)多域名证书 6. sv_ssl_cost_dnspod_ca_sm2_ov - DNSPod亚信国密-企业型(OV)证书 7. sv_ssl_cost_dnspod_ca_sm2_dvwildcard - DNSPod亚信国密-域名型(DV)通配符证书 8. sv_ssl_cost_dnspod_ca_sm2_dvmultidomain - DNSPod亚信国密-域名型(DV)多域名证书 9. sv_ssl_cost_dnspod_ca_sm2_dv - DNSPod亚信国密-域名型(DV)证书 10. sv_ssl_cost_dnspod_ca_dv - DNSPod SSL 域名型SSL证书(C1) 11. sv_ssl_cost_dnspod_ca_dvmultidomain - DNSPod SSL域名型多域名SSL证书(C1) 12. sv_ssl_cost_dnspod_ca_dvwildcard - DNSPod-SSL域名型DV(泛域名) 13. sv_ssl_cost_dnspod_ca_ov - DNSPod 企业型SSL证书(C1) 14. sv_ssl_cost_dnspod_ca_ovmultidomain - DNSPod 企业型多域名SSL证书(C1) 15. sv_ssl_cost_dnspod_ca_ovwildcard - DNSPod 企业型通配符SSL证书(C1) 16. sv_ssl_cost_dnspod_ca_ev - DNSPod 增强型 SSL 证书(C1) 17. sv_ssl_cost_dnspod_ca_evmultidomain - DNSPod 增强型多域名SSL证书(C1) 18. sv_ssl_cost_trustasia_dvwildcardmulti - TrustAsia-域名型DV(通配符多域名) 19. sv_ssl_cost_securesiteevpromul_sh - SecureSite-增强型专业版EVPro(多域名) 20. sv_ssl_cost_symantec_evpro - SecureSite-增强型专业版EVPro(单域名) 21. sv_ssl_cost_globalsign_ev_mul_sh - GlobalSign-增强型EV(多域名) 22. sv_ssl_cost_globalsign_ev - GlobalSign-增强型EV(单域名) 23. sv_ssl_cost_trustasia_evmultidomain - TrustAsia-增强型EV(多域名) 24. sv_ssl_cost_trustasia_ev - TrustAsia-增强型EV(单域名) 25. sv_ssl_cost_geotrust_evmultidomain - GeoTrust-增强型EV(多域名) 26. sv_ssl_cost_geotrust_ev - GeoTrust-增强型EV(单域名) 27. sv_ssl_cost_symantec_evmultidomain - SecureSite-增强型EV(多域名) 28. sv_ssl_cost_symantec_ev - SecureSite-增强型EV(单域名) 29. sv_ssl_cost_trustasia_dvwildcard - TrustAsia-域名型DV(泛域名) 30. sv_ssl_cost_trustasia_dvmultidomain - TrustAsia-域名型DV(多域名) 31. sv_ssl_cost_symantec_ovpromultidomain - SecureSite-企业型专业版OV Pro(多域名) 32. sv_ssl_cost_symantec_ovpro - SecureSite-企业型专业版OV Pro(单域名) 33. sv_ssl_cost_globalsign_ovwildcardmulti - GlobalSign-企业型OV(通配符多域名) 34. sv_ssl_cost_globalsign_ovwildcard - GlobalSign-企业型OV(泛域名) 35. sv_ssl_cost_globalsign_ovmultidomain - GlobalSign-企业型OV(多域名) 36. sv_ssl_cost_globalsign_ov - GlobalSign-企业型OV(单域名) 37. sv_ssl_cost_trustasia_ovwildcardmulti - TrustAsia-企业型OV(通配符多域名) 38. sv_ssl_cost_trustasia_ovwildcard - TrustAsia-企业型OV(泛域名) 39. sv_ssl_cost_trustasia_ovmultidomain - TrustAsia-企业型OV(多域名) 40. sv_ssl_cost_trustasia_ov - TrustAsia-企业型OV(单域名) 41. sv_ssl_cost_geotrust_ovwildcard - GeoTrust-企业型OV(泛域名) 42. sv_ssl_cost_geotrust_ov - GeoTrust-企业型OV(单域名) 43. sv_ssl_cost_symantec_ovwildcard - SecureSite-企业型OV(泛域名) 44. sv_ssl_cost_symantec_ovmultidomain - SecureSite-企业型OV(多域名) 45. sv_ssl_cost_symantec_ov - SecureSite-企业型OV(单域名) 46. sv_ssl_cost_dnspod_evmultidomain - DNSPod-国密增强型证书(多域名) 47. sv_ssl_cost_dnspod_ev - DNSPod-国密增强型证书 48. sv_ssl_cost_dnspod_ovwildcard - DNSPod-国密企业型证书(通配符) 49. sv_ssl_cost_dnspod_ovmultidomain - DNSPod-国密企业型证书(多域名) 50. sv_ssl_cost_dnspod_ov - DNSPod-国密企业型证书 51. sv_ssl_cost_dnspod_dvwildcard - DNSPod-国密域名型证书(通配符) 52. sv_ssl_cost_dnspod_dvmultidomain - DNSPod-国密域名型证书(多域名) 53. sv_ssl_cost_dnspod_dv - DNSPod-国密域名型证书 54. sv_ssl_cost_wotrus_evmultidomain - WoTrus-增强型证书(多域名) 55. sv_ssl_cost_wotrus_ev - WoTrus-增强型证书 56. sv_ssl_cost_wotrus_ovwildcard - WoTrus-企业型证书(通配符) 57. sv_ssl_cost_wotrus_ovmultidomain - WoTrus-企业型证书(多域名) 58. sv_ssl_cost_wotrus_ov - WoTrus-企业型证书 59. sv_ssl_cost_wotrus_dvwildcard - WoTrus-域名型证书(通配符) 60. sv_ssl_cost_wotrus_dvmultidomain - WoTrus-域名型证书(多域名) 61. sv_ssl_cost_wotrus_dv - WoTrus-域名型证书 示例值:sv_ssl_cost_cfca_ca_ev |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
CertificateId | String | 证书ID。 示例值:hes**hww |
CertificateIds | Array of String | 批量购买证书时返回多个证书ID。 示例值:["heh*jwj","hehsj"] |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 使用权益点创建证书
使用权益点创建证书
输入示例
POST / HTTP/1.1
Host: ssl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateCertificateByPackage
<公共请求参数>
{
"PackageIds": [
"Z2*******80000"
],
"Tags": [
{
"TagKey": "z***j",
"TagValue": "m****k"
}
],
"ProjectId": 1,
"RenewAlgorithmParam": "2048",
"RenewKeyPass": "k***j",
"Period": 1,
"OldCertificateId": "Rt***9",
"ProductPid": 1,
"RenewGenCsrMethod": "online",
"RenewCsr": "CSR",
"DomainCount": "5",
"RenewAlgorithmType": "RSA",
"VerifyType": "DNS"
}
输出示例
{
"Response": {
"CertificateId": "T*****h",
"RequestId": "dh7d********jdkm",
"CertificateIds": [
"j*****uk"
]
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
FailedOperation | 操作失败。 |
FailedOperation.TradeError | 计费中心错误。 |
InvalidParameter.DomainCountInvalid | 域名数量无效。 |
InvalidParameter.DomainInvalid | 域名无效,请重新输入。 |
InvalidParameter.PackageIdsInvalid | 权益点ID列表无效。 |
InvalidParameter.PeriodInvalid | 证书期限无效。 |
InvalidParameter.ProductPidInvalid | 产品PID无效。 |
InvalidParameter.RenewAlgorithmInvalid | 算法无效。 |
InvalidParameter.RenewCsrInvalid | CSR无效。 |
InvalidParameter.RenewGenCsrMethodInvalid | 生成CSR方式无效。 |