提交证书申请。
接口说明
- 发起请求前,请确保您已购买对应规格的证书资源包。关于如何购买证书资源包,请参见购买证书资源包。您可以调用DescribePackageState查询指定规格的证书资源包的使用概况,包含已购买该规格证书资源包的总数、已提交证书申请的次数、成功签发证书的次数。
- 调用本接口提交证书申请并成功签发证书后,将会消耗您已购买的对应规格的证书资源包的个数。您在发起请求时,可以通过ProductCode参数指定要申请的证书规格。
- 调用本接口提交证书申请后,您还需要调用DescribeCertificateState接口,获取完成域名验证所需要的信息,并在域名的DNS管理平台(DNS验证方式)或者域名服务器(文件验证方式)手动完成验证,然后证书申请订单才会进入CA中心审核环节。
关于使用证书资源包API申请证书的完整流程,请参见使用API申请证书的流程。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
yundun-cert:CreateCertificateForPackageRequest | Write |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Csr | string | 否 | 您使用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----- |
ProductCode | string | 否 | 要申请的证书规格。取值:
| symantec-free-1-free |
Username | string | 否 | 申请联系人的姓名。 如果不设置该参数,表示从信息管理模块中选择使用最新添加的一条联系人信息。关于在信息管理模块中添加联系人的具体操作,请参见管理联系人。 | Tom |
Phone | string | 否 | 申请联系人的手机号码。后续CA中心工作人员可能会通过该电话联系您,验证您的证书申请信息。 如果不设置该参数,表示从信息管理模块中选择使用最新添加的一条联系人信息。关于在信息管理模块中添加联系人的具体操作,请参见管理联系人。 | 1390000**** |
string | 否 | 申请联系人的邮箱地址。CA中心收到您的证书申请后,将向该邮箱发送一封证书申请验证邮件。您需要登录该邮箱,查收相关邮件,并按照邮件提示完成验证。 如果不设置该参数,表示从信息管理模块中选择使用最新添加的一条联系人信息。关于在信息管理模块中添加联系人的具体操作,请参见管理联系人。 | username@example.com | |
Domain | string | 否 | 证书要绑定的域名。具体要求如下:
注意 证书绑定多个域名时,该参数为必填项。该参数与Csr参数不允许同时为空。如果您同时设置了该参数和Csr参数,则取Csr中的CN字段值作为证书绑定的域名。 | aliyundoc.com |
CompanyName | string | 否 | 证书申请公司的名称。 说明该参数仅适用于申请OV证书。申请OV证书时,您必须先在数字证书管理服务控制台的信息管理模块添加公司信息,具体操作,请参见管理公司信息。申请DV证书时,无需添加公司信息。 申请OV证书时,如果您在此处设置了公司名称,则表示使用信息管理模块中对应的公司信息;如果您没有设置该参数,则表示从信息管理模块中选择使用最新添加的一条公司信息。 | 某公司 |
ValidateType | string | 否 | 域名所有权的验证方式。取值:
关于两种验证方式的更多信息,请参见如何配置域名授权验证?。 | DNS |
调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。
调用API的请求格式,请参见本文示例中的请求示例。
返回参数
示例
正常返回示例
JSON
格式
{
"OrderId": 2021010,
"RequestId": "5890029B-938A-589E-98B9-3DEC7BA7C400"
}
错误码
访问错误中心查看更多错误码。