CreateCertificate - 创建证书

创建证书。

接口说明

创建证书时,请指定非对称密钥的类型,将私钥托管在证书管家,并获取证书请求 CSR(Certificate Signing Request)。然后将 PEM 格式的证书请求文件提交给 CA 机构,获取正式的证书和证书链,并调用 UploadCertificate 接口导入证书管家。
本文将提供一个示例,创建一个证书,并获取证书请求 CSR。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Subjectstring

证书主体(拥有者)。
按照RFC 2253定义,采用 DN(Distinguished Names)标识。DN 由一系列 RDN(Relative Distinguished Names)组成。 RDN 是一组键值对,多个 RDN 之间用英文逗号(,)隔开,格式为:attribute1=value1,attribute2=value2
证书主体字段含义如下:

  • CN(必选):名称。证书使用主体名称。

  • C(必选):国家/地区。使用ISO 3166-1的二位国家代码。例如:CN 代表中国。

  • O(必选):公司名称。企业、单位、组织或机构的法定名称。

  • OU(必选):部门名称。

  • ST(可选):省/市。省、直辖市、自治区或特别行政区名称。

  • L(可选):城市名称。

CN=userName,OU=kms,O=aliyun,C=CN
SubjectAlternativeNamesobject

证书主体别名。
支持域名列表,最多支持 10 个域名。

["test1.example.com","test2.example.com"]
KeySpecstring

密钥类型,取值:

  • RSA_2048
  • EC_P256
  • EC_SM2
RSA_2048
ExportablePrivateKeyboolean

证书私钥是否需要导出使用。取值:

  • true(默认值):证书私钥需要导出使用。

  • false:证书私钥不需要导出使用。建议选择否,以便使用更高安全级别的密钥保护。

true

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

15a735a1-8fe6-45cc-a64c-3c4ff839334e
Csrstring

PEM 格式的证书请求。

-----BEGIN CERTIFICATE REQUEST-----\nMIIDADCCAegCAQAwgboxCzAJBgNVBAYTAkNOMREwDwYDVQQIEwhaaGVqaWFuZzER\n****\nmkj4rg==\n-----END CERTIFICATE REQUEST-----\n
CertificateIdstring

证书 ID。证书管家中证书的全局唯一标识符。

9a28de48-8d8b-484d-a766-dec4****
Arnstring

证书 ARN。

acs:kms:cn-hangzhou:154035569884****:certificate/98e85c94-52d0-40c9-b3b2-afda52f4****

示例

正常返回示例

JSON格式

{
  "RequestId": "15a735a1-8fe6-45cc-a64c-3c4ff839334e",
  "Csr": "-----BEGIN CERTIFICATE REQUEST-----\\nMIIDADCCAegCAQAwgboxCzAJBgNVBAYTAkNOMREwDwYDVQQIEwhaaGVqaWFuZzER\\n****\\nmkj4rg==\\n-----END CERTIFICATE REQUEST-----\\n",
  "CertificateId": "9a28de48-8d8b-484d-a766-dec4****",
  "Arn": "acs:kms:cn-hangzhou:154035569884****:certificate/98e85c94-52d0-40c9-b3b2-afda52f4****"
}

错误码

HTTP status code错误码错误信息描述
400InvalidParameterThe specified parameter is not valid.参数非法。
404InvalidAccessKeyId.NotFoundThe specified AccessKey ID does not exist.AccessKey ID找不到。请检查调用时是否使用了正确的AccessKey。

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