CreateCertificateRequest - 完成DV证书购买申请和签发流程 - 数字证书管理服务

完成扩展服务DV证书的购买、申请和签发流程。

接口说明

本接口仅用于申请 DV 证书。如果需要申请 OV 或 EV 证书，推荐您使用 CreateCertificateForPackageRequest 接口提交证书申请（可用于申请所有规格的证书，且支持选择 CSR 生成方式）。
发起调用请求前，请确保您已购买对应规格的证书资源包。关于如何购买证书资源包，请参见购买证书资源包。您可以调用 DescribePackageState 查询指定规格的证书资源包的使用概况，包含已购买该规格证书资源包的总数、已提交证书申请的次数、成功签发证书的次数。
调用本接口时，可以通过 ProductCode 参数指定要申请的证书规格。
调用本接口提交证书申请后，SSL 证书服务将自动为您创建 CSR 文件，同时会消耗您已购买的对应规格的证书资源包中的证书个数。调用本接口后，您还需要调用 DescribeCertificateState 接口，获取完成域名验证所需要的信息，并在域名的 DNS 管理平台（DNS 验证方式）或者域名服务器（文件验证方式）手动完成验证，然后证书申请订单才会进入 CA 中心审核环节。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-cert:CreateCertificateRequest

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ProductCode	string	否	要申请的证书规格。取值： digicert-free-1-free（默认）：表示 3 个月个人测试证书（免费版）。仅中国站。 symantec-free-1-free：表示 12 个月的个人测试证书（pro）。仅中国站。 symantec-dv-1-starter：表示 DigiCert DV 通配符域名证书。 geotrust-dv-1-starter：表示 GeoTrust DV 单域名证书。 geotrust-dv-w-starter：表示 GeoTrust DV 通配符域名证书。 globalsign-dv-1-personal：表示 GlobalSign DV 单域名证书。 globalsign-dv-w-advanced：表示 GlobalSign DV 通配符域名证书。	symantec-dv-1-starter
Username	string	是	申请联系人的姓名。	Tom
Phone	string	是	申请联系人的手机号码。	1390000****
Email	string	是	申请联系人的邮箱地址。	username@example.com
Domain	string	是	证书要绑定的域名。仅支持设置一个域名。说明该域名必须与您要申请的证书规格（通过 ProductCode 参数指定）匹配。申请单域名证书时，此处必须设置一个单域名；申请通配符域名证书时，此处必须设置一个通配符域名（例如，`*.aliyundoc.com`）。	www.aliyundoc.com
ValidateType	string	是	域名所有权的验证方式。取值： DNS：DNS 验证。通过在域名的 DNS 管理平台为域名添加一条 TXT 类型的 DNS 记录，验证域名的所有权。您需要域名解析的管理权限，才可以完成验证。 FILE：文件验证。通过在域名服务器上创建指定的文件，验证域名的所有权。您需要域名服务器的管理员权限，才可以完成验证。关于两种验证方式的更多信息，请参见如何配置域名授权验证？。	DNS
Tags	array<object>	否	标签列表。
	object	否	要查询的 Tags 列表，采用 JSON 字符串的形式，最多包含 20 个子项。
Key	string	否	标签键。	acs:rm:rgId
Value	string	否	标签值。	test

返回参数

名称	类型	描述	示例值
	object	对象。
OrderId	integer	本次证书申请订单的 ID。说明后续您可以使用该 ID 查询证书申请订单的状态，具体操作，请参见 DescribeCertificateState 。	98987582437920968
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D

示例

正常返回示例

JSON格式

{
  "OrderId": 98987582437920960,
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D"
}

错误码

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

变更历史

更多信息，参考变更详情。