文档

UploadServerCertificate - 上传服务器证书

更新时间:

上传服务器证书。

接口说明

  • 一次只能上传一份服务器证书和对应的私钥。

  • 上传成功后,返回该用户的所有服务器证书列表的指纹信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
slb:UploadServerCertificateWrite
  • certificate
    acs:slb:{#regionId}:{#accountId}:certificate/*

请求参数

名称类型必填描述示例值
Tagobject []

标签列表。

Keystring

资源的标签键。N 的取值范围:1~20。一旦输入该值,则不允许为空字符串。

最多支持 64 个字符,不能以aliyunacs:开头,不能包含http://或者https://

TestKey
Valuestring

资源的标签值。N 的取值范围:1~20。一旦输入该值,可以为空字符串。 最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

TestValue
RegionIdstring

服务器证书部署的地域 ID。

您可以通过调用 DescribeRegions 接口查询地域 ID。

cn-hangzhou
AliCloudCertificateIdstring

阿里云签发证书 ID。

说明 如果使用阿里云签发证书,该参数必选。
775****
AliCloudCertificateNamestring

阿里云签发证书名称。

您可以通过调用GetUserCertificateDetail - 获取证书详情接口查询证书名称。

说明 如果使用阿里云签发证书,该参数必选。
cloudcertificate
AliCloudCertificateRegionIdstring

阿里云签发证书所属的地域 ID。

说明 如果使用阿里云签发证书,该参数必选。
cn-hangzhou
ServerCertificatestring

需要上传的公钥证书。

说明 如果上传非阿里云签发证书,该参数必选。
-----BEGIN CERTIFICATE----- MIIGDTCC****** -----END CERTIFICATE-----
PrivateKeystring

需要上传的私钥。

说明 如果上传非阿里云签发证书,该参数必选。
-----BEGIN RSA PRIVATE KEY----- MIIEogIB****** -----END RSA PRIVATE KEY-----
ServerCertificateNamestring

要上传的非阿里云签发的服务器证书的名称。长度限制为 1~80 个字符,允许包含中文、字母、数字、短划线(-)、正斜线(/)、半角句号(.)、下划线(_)和星号(*)。

说明 如果上传非阿里云签发证书,该参数必选。
mycert01
ResourceGroupIdstring

资源组 ID。

rg-atstuj3rto****

返回参数

名称类型描述示例值
object

返回数据结构体。

AliCloudCertificateNamestring

阿里云签发证书名称。

cloudcertificate****
CreateTimeStamplong

证书创建的时间戳。

1504147745000
ExpireTimestring

证书过期时间。

2022-10-18T23:59:59Z
CreateTimestring

证书创建时间。

2022-02-21T02:49:05Z
ServerCertificateIdstring

服务器证书 ID。

1321932713******_17f1b4b696b_1114720822_-1671******
ExpireTimeStamplong

证书过期的时间戳。

1504147745000
RegionIdstring

服务器证书部署的地域 ID。

cn-hangzhou
RequestIdstring

请求 ID。

365F4154-92F6-4AE4-92F8-7FF34B540710
Fingerprintstring

服务器证书的指纹。

8f:7d:cb:e5:f8:c8:33:9c:17:65:c1:92:30:9e:45:55:9c:3a:85:60
ServerCertificateNamestring

非阿里云签发的服务器证书的名称。

mycert01
CommonNamestring

域名,对应证书的Common Name字段。

example.com
ResourceGroupIdstring

资源组 ID。

rg-atstuj3rt****
AliCloudCertificateIdstring

阿里云签发证书 ID。

775****
IsAliCloudCertificateinteger

是否为阿里云证书服务中的证书。

  • 0:不是阿里云证书。
  • 1:是阿里云证书。
0
SubjectAlternativeNamesarray

返回证书的备用域名列表。

string

数组格式,返回证书的备用域名列表,对应证书的Subject Alternative Name字段。

["example.com","www.example.com"]

示例

正常返回示例

JSON格式

{
  "AliCloudCertificateName": "cloudcertificate****",
  "CreateTimeStamp": 1504147745000,
  "ExpireTime": "2022-10-18T23:59:59Z",
  "CreateTime": "2022-02-21T02:49:05Z",
  "ServerCertificateId": "1321932713******_17f1b4b696b_1114720822_-1671******",
  "ExpireTimeStamp": 1504147745000,
  "RegionId": "cn-hangzhou",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "Fingerprint": "8f:7d:cb:e5:f8:c8:33:9c:17:65:c1:92:30:9e:45:55:9c:3a:85:60",
  "ServerCertificateName": "mycert01",
  "CommonName": "example.com",
  "ResourceGroupId": "rg-atstuj3rt****",
  "AliCloudCertificateId": "775****",
  "IsAliCloudCertificate": 0,
  "SubjectAlternativeNames": {
    "SubjectAlternativeName": [
      "[\"example.com\",\"www.example.com\"]"
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400IllegalParam.ServerCertificateThe specified server certificate is illegal.指定的ServerCertificate无效。请检查参数约束,并在修改后重试。
400InvalidParameterThe specified ServerCertificate and PrivateKey fail to validate.指定的证书和私钥校验失败。
400ServerCertificate.NotSupportThe specified Region Not support ServerCertificate.指定地域不支持服务器证书。
400InvalidParameter.AliCloudCertificateIdThe specified AliCloudCertificateId is invalid.指定的AliCloudCertificateId无效。请检查参数约束,并在修改后重试。
400OperationDenied.IllegalKeyLengthThe operation is not allowed because the key length of certificate is illegal.操作被拒绝,原因是证书的密钥长度非法。
400InvalidParam.TagValue %s.-
400InvalidParam.TagKey%s.-
400SizeLimitExceeded.Tag%s.-
400MissingParam.TagKeyThe param MissingParam.TagKey is missing.-
400EccCertificateNotSupportThe ECC certificate is not support.ECC证书不支持
400CertificateFormatInvalidThe certificate format is invalid.证书格式不正确。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-09-26OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-06-02OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400

相关文档

  • 本页导读 (1)
文档反馈