调用UploadServerCertificate上传服务器证书。

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

该接口保证事务性,即上传的证书和私钥要么都上传成功,要么都不成功。上传成功后,返回该用户的所有服务器证书列表的Fingerprint。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String UploadServerCertificate

要执行的操作。

取值:UploadServerCertificate

RegionId String cn-hangzhou

服务器证书的地域ID。

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

AliCloudCertificateId String 730912673xxxxxx_15d97e7709a_71445759hr_7892******

阿里云的云上证书ID。

使用阿里云的云上证书,该参数必选。

AliCloudCertificateName String cloudcertificate******

阿里云的云上证书名称。

AliCloudCertificateRegionId String cn-hangzhou

阿里云的云上证书所在的地域ID。

ServerCertificate String servercertifictetest

需要上传的公钥证书。

说明 如果不使用阿里云的云上证书,该参数必选。
PrivateKey String wmsa*****

需要上传的私钥。

说明 如果不使用阿里云的云上证书,该参数必选。
ServerCertificateName String mycert01

要上传的服务器证书的名称。长度为 1~80 个英文或中文字符,必须以大小字母或中文开头,可包含数字、半角句号(.),下划线(_)和短划线(-)。

ResourceGroupId String rg-atstuj3rto****

企业资源组ID。

返回数据

名称 类型 示例值 描述
ServerCertificateId String xxxxidkp-123-cn-test******

服务器证书ID。

ServerCertificateName String mycert01

服务器证书名称。

Fingerprint String 01:DF:AB:**

服务器证书的指纹。

AliCloudCertificateId String 730912xxxxx_15d97e7709a_71445759hr_7*******

阿里云证书服务中的服务器证书ID。

AliCloudCertificateName String cloudcertificate******

阿里云证书服务中的服务器证书名称。

CommonName String www.example.com

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

CreateTime String 2017-08-31T02:49:05Z

证书创建时间。

CreateTimeStamp Long 1504147745000

证书创建时间戳。

ExpireTime String 2018-08-31T02:49:05Z

证书过期时间。

ExpireTimeStamp Long 1504147745000

证书过期时间戳。

IsAliCloudCertificate Integer 0

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

  • 0:表示不是阿里云证书。
  • 1:表示是阿里云证书。
RegionId String cn-hangzhou

证书所属的地域ID。

RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

请求ID。

ResourceGroupId String rg-atstuj3rt******

企业资源组ID。

SubjectAlternativeNames List test

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

示例

请求示例

http(s)://[Endpoint]/?Action=UploadServerCertificate
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<UploadServerCertificateResponse>
  <Fingerprint>01:DF:AB:**</Fingerprint>
  <ExpireTimeStamp>1504147745000</ExpireTimeStamp>
  <ResourceGroupId>rg-atstuj3rt******</ResourceGroupId>
  <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
  <CreateTime>2017-08-31T02:49:05Z</CreateTime>
  <SubjectAlternativeNames>
        <SubjectAlternativeName>test</SubjectAlternativeName>
  </SubjectAlternativeNames>
  <AliCloudCertificateId>730912xxxxx_15d97e7709a_71445759hr_7*******</AliCloudCertificateId>
  <AliCloudCertificateName>cloudcertificate******</AliCloudCertificateName>
  <IsAliCloudCertificate>0</IsAliCloudCertificate>
  <ServerCertificateName>mycert01</ServerCertificateName>
  <ServerCertificateId>xxxxidkp-123-cn-test******</ServerCertificateId>
  <RegionId>cn-hangzhou</RegionId>
  <ExpireTime>2018-08-31T02:49:05Z</ExpireTime>
  <CreateTimeStamp>1504147745000</CreateTimeStamp>
  <CommonName>www.example.com</CommonName>
</UploadServerCertificateResponse>

JSON格式

{"Fingerprint":"01:DF:AB:**",
"ExpireTimeStamp":"1504147745000",
"ResourceGroupId":"rg-atstuj3rt******",
"RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
"CreateTime":"2017-08-31T02:49:05Z",
"SubjectAlternativeNames":
{
    "SubjectAlternativeName":"test"
    },
    "AliCloudCertificateId":"730912xxxxx_15d97e7709a_71445759hr_7*******",
    "AliCloudCertificateName":"cloudcertificate******",
    "IsAliCloudCertificate":"0",
    "ServerCertificateName":"mycert01",
    "ServerCertificateId":"xxxxidkp-123-cn-test******",
    "RegionId":"cn-hangzhou",
    "ExpireTime":"2018-08-31T02:49:05Z",
    "CreateTimeStamp":"1504147745000",
    "CommonName":"www.example.com"}

错误码

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