全部产品
Search
文档中心

数字证书管理服务:CreateRootCACertificate - 创建根CA证书

更新时间:Nov 09, 2023

创建一个根CA证书。

接口说明

本接口用于创建一个自签名的根CA证书。根CA证书是企业内部私有证书信任链的起点。只有创建根CA证书后,您才可以使用根CA证书签发子CA证书,然后使用子CA证书签发客户端与服务端证书。

调用本接口前,您必须已经通过SSL证书服务控制台购买了私有根CA,否则会调用失败。相关操作,请参见购买私有CA

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用将会被限流,这可能影响您的业务,请合理调用。

调试

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

调试

授权信息

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

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

请求参数

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

组织机构的通用名称或简称。支持使用中文、英文字符等。

Alibaba
OrganizationUnitstring

组织机构下部门或分支的名称。支持使用中文、英文字符等。

Security
Organizationstring

根CA证书关联的组织机构(对应您的企业或单位)的名称。支持使用中文、英文字符等。

阿里巴巴网络技术有限公司
Localitystring

组织机构所在城市的名称。支持使用中文、英文字符等。

Hangzhou
Statestring

组织机构所在省份或州的名称。支持使用中文、英文字符等。

Zhejiang
CountryCodestring

组织机构所在国家或地区的代码,使用两位大写英文字母缩写表示。例如,CN表示中国,US表示美国。

关于不同国家的代码,请参见管理公司信息中的国际代号章节。

CN
Algorithmstring

根CA证书的密钥算法类型。密钥算法使用<加密算法>_<密钥长度>格式表示。取值:

  • RSA_1024:对应签名算法为Sha256WithRSA。
  • RSA_2048:对应签名算法为Sha256WithRSA。
  • RSA_4096:对应签名算法为Sha256WithRSA。
  • ECC_256:对应签名算法为Sha256WithECDSA。
  • ECC_384:对应签名算法为Sha256WithECDSA。
  • ECC_512:对应签名算法为Sha256WithECDSA。
  • SM2_256:对应签名算法为SM3WithSM2。

根CA证书的加密算法必须与您购买的私有根CA的证书算法一致。示例:如果您购买私有根CA时选择的证书算法RSA,则根CA证书的密钥算法必须是RSA_1024RSA_2048RSA_4096

RSA_2048
Yearsinteger

根CA证书的有效期,单位:年。

说明 建议设置为5~10年。
10

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。

调用API的请求格式,请参见本文示例中的请求示例。

返回参数

名称类型描述示例值
object

对象。

RequestIdstring

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

6D9B4C5F-7140-5B41-924C-329181DC00C1
Identifierstring

本次请求创建的根CA证书的唯一识别码。

1a83bcbb89e562885e40aa0108f5****
Certificatestring

本次调用创建的PEM格式根证书。

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----
CertificateChainstring

本次调用创建的根证书的CA证书链。

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n

示例

正常返回示例

JSON格式

{
  "RequestId": "6D9B4C5F-7140-5B41-924C-329181DC00C1",
  "Identifier": "1a83bcbb89e562885e40aa0108f5****",
  "Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n"
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-03-23OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更