調用CreateCertificateRequest申請DV認證-數位憑證管理服務（原SSL認證）-阿里雲

完成擴充服務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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。