文档中心

证书中心

私有证书

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 object[] 可选示例值：参见请求示例

为私有证书设置标签。

Key string 必选示例值：env

资源标签键。

Value string 可选示例值：test

资源标签值。

ProjectName string 可选示例值：default

设置私有证书所属的项目组。

返回参数

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

InstanceId string 示例值：pca_leaf_M6gaihuZRcO****

私有证书（叶子证书）实例的ID。

上传后的私有证书实例唯一标识。

InstanceType string 示例值：leaf_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.10.27 17:25:46

这个页面对您有帮助吗？

有用

无用