UploadLeafCertificate - 上传私有证书--证书中心-火山引擎

文档中心

立即注册

证书中心

私有证书

UploadLeafCertificate - 上传私有证书

调用本接口上传一本私有证书。

请求说明

接口名称：UploadLeafCertificate
请求方式：POST
请求地址：
- IPv4网络接入：pca.volcengineapi.com
- 双栈网络接入（IPv4/IPv6）：pca.volcengine-api.com

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必填	示例值	描述
Action	String	是	UploadLeafCertificate	要执行的操作，取值：UploadLeafCertificate。
Version	String	是	2025-10-01	API的版本，取值：2025-10-01。

Body

参数	类型	是否必填	示例值	描述
IssuerID	String	是	pca_sub_MlRaK****	上一级CA实例的ID，即子CA实例的ID。您可以调用 ListSubInstances 接口获取所有子CA实例的ID。
Certificate	String	是	`-----BEGIN CERTIFICATE----- MIID……SI4= -----END CERTIFICATE-----`	私有证书的内容。对于国密算法证书（key_alg 为 SM2），该参数表示用于签名的证书。
Key	String	否	`-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----`	子CA证书的私钥。私钥内容必须是PEM编码的。
Tag	String	否	prod-payment-client-cert	为该私有证书设置一个备注。
Tags	Array of Object	否	-	为私有证书设置标签。
ProjectName	String	否	default	设置私有证书所属的项目组。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
InstanceId	String	pca_leaf_M6gaihuZRcO****	子CA实例的ID。上传后的私有证书实例唯一标识。
InstanceType	String	sub_instance	子CA实例的类型。

请求示例

POST /?Action=UploadLeafCertificate&Version=2025-10-01 HTTP/1.1
Host: pca.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20251030T063006Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251030/cn-beijing/pca/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "IssuerID": "pca_sub_MlRaK****",
  "Certificate": "`-----BEGIN CERTIFICATE----- MIID……SI4= -----END CERTIFICATE-----`",
  "Key": "`-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----`",
  "Tag": "prod-payment-client-cert",
  "Tags": [
    {
      "Key": "env",
      "Value": "test"
    }
  ],
  "ProjectName": "default"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2025103014301025214417820941C455",
    "Action": "UploadLeafCertificate",
    "Version": "2025-10-01",
    "Service": "pca",
    "Region": "cn-beijing"
  },
  "Result": {
    "InstanceId": "pca_leaf_M6gaihuZRcO****",
    "InstanceType": "sub_instance"
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
200	MalformedRequest	The request is malformed	请求参数格式不合法。
200	InternalError	The request has failed due to an unknown error.	未知错误。
200	QuotaExceeded	%s has exceeded the quota. example: The memory size of the specified disk has exceeded the quota.	资源超出配额限制。
200	MissingParameter	The required parameter %s is missing.	缺少必填参数。

最近更新时间：2026.01.07 17:39:55

这个页面对您有帮助吗？

有用

无用

证书中心

请求说明 #

调试 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #