文档

CreateCertificateForPackageRequest - 请求创建证书

更新时间:

提交证书申请。

接口说明

  • 发起请求前,请确保您已购买对应规格的证书资源包。关于如何购买证书资源包,请参见购买证书资源包。您可以调用 DescribePackageState 查询指定规格的证书资源包的使用概况,包含已购买该规格证书资源包的总数、已提交证书申请的次数、成功签发证书的次数。
  • 调用本接口提交证书申请并成功签发证书后,将会消耗您已购买的对应规格的证书资源包的个数。您在发起请求时,可以通过 ProductCode 参数指定要申请的证书规格。
  • 调用本接口提交证书申请后,您还需要调用 DescribeCertificateState 接口,获取完成域名验证所需要的信息,并在域名的 DNS 管理平台(DNS 验证方式)或者域名服务器(文件验证方式)手动完成验证,然后证书申请订单才会进入 CA 中心审核环节。

关于使用证书资源包 API 申请证书的完整流程,请参见使用 API 申请证书的流程

调试

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

授权信息

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

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

请求参数

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

您使用 OpenSSL 或 Keytool 工具为域名手动生成的 CSR 文件的内容。CSR 文件的密钥类型必须是 RSA、ECC 算法,且 RSA 算法的密钥长度必须大于等于 2048。关于 CSR 文件的制作方法,请参见创建 CSR。如果不设置该参数,表示由 SSL 证书服务自动为您创建 CSR。

CSR(Certificate Signing Request)是证书签名请求文件,包含了您的服务器信息和公司信息。申请证书时需要将您证书的 CSR 文件提交给 CA 认证中心审核,CA 中心对 CSR 文件进行根证书私钥签名后,会生成证书公钥文件(即签发给您的 SSL 证书)。

注意 CSR 中的 CN 字段表示证书绑定的域名。您设置 CSR 参数时,该字段为必填字段。
-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----
ProductCodestring

要申请的证书规格。取值:

  • digicert-free-1-free(默认):表示 DigiCert DV 单域名证书(3 个月免费证书)。

  • symantec-free-1-free:表示 DigiCert DV 免费单域名证书(1 年期免费证书)。

  • symantec-dv-1-starter:表示 DigiCert DV 通配符域名证书。

  • symantec-ov-1-personal:表示 DigiCert OV 单域名证书。

  • symantec-ov-w-personal:表示 DigiCert OV 通配符域名证书。

  • geotrust-dv-1-starter:表示 GeoTrust DV 单域名证书。

  • geotrust-dv-w-starter:表示 GeoTrust DV 通配符域名证书。

  • geotrust-ov-1-personal:表示 GeoTrust OV 单域名证书。

  • geotrust-ov-w-personal:表示 GeoTrust OV 通配符域名证书。

  • globalsign-dv-1-personal:表示 GlobalSign DV 单域名证书。

  • globalsign-dv-w-advanced:表示 GlobalSign DV 通配符域名证书。

  • globalsign-ov-1-personal:表示 GlobalSign OV 单域名证书。

  • globalsign-ov-w-advanced:表示 GlobalSign OV 通配符域名证书。

  • cfca-ov-1-personal:表示 CFCA OV 单域名证书。

  • cfca-ev-w-advanced:表示 CFCA OV 通配符域名证书。

digicert-free-1-free
Usernamestring

申请联系人的姓名。

如果不设置该参数,表示从信息管理模块中选择使用最新添加的一条联系人信息。关于在信息管理模块中添加联系人的具体操作,请参见管理联系人

Tom
Phonestring

申请联系人的手机号码。后续 CA 中心工作人员可能会通过该电话联系您,验证您的证书申请信息。

如果不设置该参数,表示从信息管理模块中选择使用最新添加的一条联系人信息。关于在信息管理模块中添加联系人的具体操作,请参见管理联系人

1390000****
Emailstring

申请联系人的邮箱地址。CA 中心收到您的证书申请后,将向该邮箱发送一封证书申请验证邮件。您需要登录该邮箱,查收相关邮件,并按照邮件提示完成验证。

如果不设置该参数,表示从信息管理模块中选择使用最新添加的一条联系人信息。关于在信息管理模块中添加联系人的具体操作,请参见管理联系人

username@example.com
Domainstring

证书要绑定的域名。具体要求如下:

  • 支持设置单域名或者通配符域名(例如,*.aliyundoc.com)。
  • 支持设置多个域名。多个域名间使用英文逗号(,)分隔。最多可以设置 5 个域名。
  • 如果设置多个域名,则多个域名只能全部是单域名或者通配符域名,不允许同时包含单域名和通配符域名。
注意 证书绑定多个域名时,该参数为必填项。该参数与 Csr 参数不允许同时为空。如果您同时设置了该参数和 Csr 参数,则取 Csr 中的 CN 字段值作为证书绑定的域名。
aliyundoc.com
CompanyNamestring

证书申请公司的名称。

说明 该参数仅适用于申请 OV 证书。申请 OV 证书时,您必须先在数字证书管理服务控制台信息管理模块添加公司信息,具体操作,请参见管理公司信息。申请 DV 证书时,无需添加公司信息。

申请 OV 证书时,如果您在此处设置了公司名称,则表示使用信息管理模块中对应的公司信息;如果您没有设置该参数,则表示从信息管理模块中选择使用最新添加的一条公司信息。

某公司
ValidateTypestring

域名所有权的验证方式。取值:

  • DNS:DNS 验证。通过在域名的 DNS 管理平台为域名添加一条 TXT 类型的 DNS 记录,验证域名的所有权。您需要域名解析的管理权限,才可以完成验证。

  • FILE:文件验证。通过在域名服务器上创建指定的文件,验证域名的所有权。您需要域名服务器的管理员权限,才可以完成验证。

关于两种验证方式的更多信息,请参见如何配置域名授权验证?

DNS

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

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

返回参数

名称类型描述示例值
object

对象。

OrderIdlong

本次证书申请订单的 ID。

说明 后续您可以使用该 ID 查询证书申请订单的状态,具体操作,请参见 DescribeCertificateState
2021010
RequestIdstring

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

5890029B-938A-589E-98B9-3DEC7BA7C400

示例

正常返回示例

JSON格式

{
  "OrderId": 2021010,
  "RequestId": "5890029B-938A-589E-98B9-3DEC7BA7C400"
}

错误码

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

  • 本页导读 (1)