调用本接口上传一本私有根CA（以下简称“根CA”）证书。

使用说明 #

• 一个火山引擎主账号在同一时间仅允许上传一本根CA证书。
• 一个火山引擎主账号最多允许上传100本根CA证书。
• 调用本接口时，仅允许上传一本根CA证书，不允许上传证书链。

请求说明 #

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

调试 #

请求参数 #

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

Query #

Body #

返回参数 #

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

请求示例 #

POST /?Action=UploadRootInstance&Version=2025-10-01 HTTP/1.1
Host: pca.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20251030T041341Z
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

{
  "Certificate": "-----BEGIN CERTIFICATE-----……-----END CERTIFICATE-----",
  "Key": "-----BEGIN PRIVATE KEY-----……-----END PRIVATE KEY-----",
  "Tag": "testupload-root",
  "Tags": [
    {
      "Key": "env",
      "Value": "test"
    }
  ],
  "IssuerID": "9FG14r6tWKM",
  "ProjectName": "default"
}

返回示例 #

{
  "ResponseMetadata": {
    "RequestId": "2025103012135316707913215261CCF8",
    "Action": "UploadRootInstance",
    "Version": "2025-10-01",
    "Service": "pca",
    "Region": "cn-beijing"
  },
  "Result": {
    "InstanceId": "pca_root_EyKa****",
    "InstanceType": "root_instance"
  }
}

错误码 #

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