You need to enable JavaScript to run this app.
文档中心
负载均衡

负载均衡

复制全文
下载 pdf
证书
UploadCertificate-上传服务器证书
复制全文
下载 pdf
UploadCertificate-上传服务器证书
调用 UploadCertificate 接口,上传服务器证书。​
使用说明​
  • 单个账号在每个地域上传证书上限为100个。​
  • 每秒最多提交 10 个 API 请求。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:UploadCertificate​
接口名称。当前 API 的名称为 UploadCertificate。​
​
Version String 必选 示例值:2020-04-01​
接口版本。当前 API 的版本为 2020-04-01。​
​
CertificateName String 可选 示例值:test​
证书的名称。具体规则如下:​
  • 不能以http://或https://开头。​
  • 必须以字母或中文开头,可包含数字、点号(.)、下划线(_)和短横线(-)。​
  • 长度限制为1 ~ 128个字符。​
  • 不填默认为证书ID。​
​
CertificateType String 必选 示例值:Server​
证书的类型。取值如下:​
  • Server :服务器证书。​
​
PublicKey String 必选 示例值:public​
证书公钥,格式如下:​
-----BEGIN CERTIFICATE-----​
服务器公钥证书(BASE64编码)​
-----END CERTIFICATE-----​
!!!中间不可有空行!!!​
-----BEGIN CERTIFICATE-----​
中级签发机构公钥证书(BASE64编码)​
-----END CERTIFICATE-----​
​
PrivateKey String 必选 示例值:private​
证书私钥,格式如下:​
  • 格式1:​
  • -----BEGIN RSA PRIVATE KEY-----​
  • 证书私钥(BASE64编码)​
  • -----END RSA PRIVATE KEY-----​
  • 格式2:​
  • -----BEGIN EC PARAMETERS-----​
  • 证书私钥(BASE64编码)​
  • -----END EC PARAMETERS-----​
  • -----BEGIN EC PRIVATE KEY-----​
  • 证书私钥(BASE64编码)​
  • -----END EC PRIVATE KEY-----​
​
Description String 可选 示例值:test​
证书描述。​
​
ProjectName String 可选 示例值:default​
证书所属项目名称。​
​
Tags.N.Key String[] 可选 示例值:Tags.1.Key=k1&Tags.2.Key=k2​
用户标签的标签键。具体规则如下:​
  • 长度限制为1~128个字符。​
  • 大小写敏感。​
  • 不能以volc:和sys:的任意大小写组合开头。​
  • 不能以空格开头或结尾。​
  • 允许包含各国语言文字、数字、空格()、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。​
  • 同一资源的标签键不允许重复。​
​
Tags.N.Value String[] 可选 示例值:Tags.1.Value=v1&Tags.2.Value=v2​
用户标签的标签值。如果传入该参数,则必须先传入Tags.N.Key。具体规则如下:​
  • 长度限制为0~256个字符。​
  • 大小写敏感。​
  • 不能以空格开头或结尾。​
  • 允许包含各国语言文字、数字、空格()、下划线(_)、点号(.)、半角冒号(:)、斜杠(/)、等号(=)、加号(+)、减号(-)和@。​
​
​
返回参数​
RequestId String 示例值:20210816110638****2514606306AF947C​
请求ID。​
​
CertificateId String 示例值:cert-*****​
证书ID。​
​
​
请求示例​
​
GET /?Action=UploadCertificate&Version=2020-04-01&CertificateName=***&PublicKey=***&PrivateKey=*** HTTP/1.1​
Host: alb.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/alb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20210816110638****2514606306AF947C",​
"Action": "UploadCertificate",​
"Version": "2020-04-01",​
"Service": "alb",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "20210816110638****2514606306AF947C",​
"CertificateId": "cert-****"​
}​
}​
​
错误码​
如果响应正文包含 Error 字段,则表示 API 请求失败。此处仅展示当前 API 的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidCertificateName.Malformed​
The specified CertificateName is malformed.​
指定的 CertificateName 参数格式不合法。​
400​
InvalidDescription.Malformed​
The specified Description is malformed.​
指定的 Description 参数格式不合法。​
400​
InvalidCertificateType.Malformed​
The specified CertificateType is malformed.​
指定的 CertificateType 参数格式不合法。​
400​
InvalidPublicKey.Malformed​
The specified PublicKey is malformed.​
指定的 PublicKey 参数格式不合法。​
400​
InvalidPrivateKey.Malformed​
The specified PrivateKey is malformed.​
指定的 PrivateKey 参数格式不合法。​
400​
InvalidPublicKey.PrivateKeyMismatch​
The specified PublicKey and PrivateKey do not match.​
指定的公钥和私钥不匹配。​
400​
OperationFailed.QueryProject​
The request on the specified resource failed due to the query on project failed.​
因查询项目失败,对于该资源的操作请求失败。​
400​
QuotaExceed.CertPerRegion​
You've reached the limit on the number of server certificates the current region you can create in, usage xx/xx.​
已达到当前地域可创建的服务器证书的数量上限。目前已使用xxx,配额为xxx。​
400​
OperationFailed.AddIntoProjectFailed​
The request on the specified resource failed due to adding it into the project failed.​
因将资源加入至项目中失败,对于该资源的操作请求失败。​
404​
InvalidProject.NotFound​
The specified Project does not exist.​
指定的项目不存在。​
400​
InvalidTags.Key.Malformed​
The specified Tags.Key is malformed.​
指定的 Tags.Key 参数格式不合法。​
400​
InvalidTags.Value.Malformed​
The specified Tags.Value is malformed.​
指定的 Tags.Value 参数格式不合法。​
400​
InvalidTags.Key.Duplicated​
The specified Tags.Key is duplicated.​
指定的 Tags.Key 重复。​
​
最近更新时间:2026.02.27 11:57:36
这个页面对您有帮助吗?
有用
有用
无用
无用