调用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 |
是否为阿里云证书服务中的证书。
|
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"}
错误码
访问错误中心查看更多错误码。