購買、申請和簽發自帶CSR文件的DV證書。證書擴展服務可通過一步完成DV證書的購買和申請。
接口說明
- 本接口僅用于申請 DV 證書,不支持用于申請 OV 證書。推薦您使用 CreateCertificateForPackageRequest 接口提交證書申請(可用于申請所有規格的證書,且支持選擇 CSR 生成方式)。
- 發起請求前,請確保您已購買對應規格的證書資源包。關于如何購買證書資源包,請參見購買證書資源包。您可以調用 DescribePackageState 查詢指定規格的證書資源包的使用概況,包含已購買該規格證書資源包的總數、已提交證書申請的次數、成功簽發證書的次數。
- 您在發起請求時,可以通過 ProductCode 參數指定要申請的證書規格。
- 調用本接口提交證書申請后,將會消耗您已購買的對應規格的證書資源包證書的個數。調用本接口后,您還需要調用 DescribeCertificateState 接口,獲取完成域名驗證所需要的信息,并在域名的 DNS 管理平臺(DNS 驗證方式)或者域名服務器(文件驗證方式)手動完成驗證,然后您的證書申請訂單才會進入 CA 中心審核環節。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
yundun-cert:CreateCertificateWithCsrRequest | create | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Csr | string | 是 | 已有的 CSR 文件的內容。 說明
CSR 中的 CN 字段表示證書綁定的域名。
| -----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST----- |
ProductCode | string | 否 | 要申請的證書規格。取值:
| digicert-free-1-free |
Username | string | 是 | 申請聯系人的姓名。 | Tom |
Phone | string | 是 | 申請聯系人的手機號碼。 | 1390000**** |
string | 是 | 申請聯系人的郵箱地址。 | username@example.com | |
ValidateType | string | 是 | 域名所有權的驗證方式。取值:
關于兩種驗證方式的更多信息,請參見如何配置域名授權驗證?。 | DNS |
Tags | array<object> | 否 | 標簽列表。 | |
object | 否 | 標簽列表。 | ||
Key | string | 否 | 標簽鍵。 | database |
Value | string | 否 | 標簽的值(value)。 | 1 |
返回參數
示例
正常返回示例
JSON
格式
{
"OrderId": 98987582437920960,
"RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-09-20 | OpenAPI 描述信息更新 | 查看變更詳情 |
HttpCode | 錯誤碼 | 描述 |
---|---|---|
404 | NotFoundPackage | 沒有購買套餐包。 |
404 | NotRemainCount | 套餐中不可用的證書數量。 |
403 | CreateCertificateRequestFailed | 創建請求失敗。 |
404 | NotFoundOrder | 沒有找到證書訂單。 |
403 | OrderStateError | 證書訂單狀態錯誤。 |
403 | DeleteFail | 刪除證書訂單失敗。 |
500 | Error | 發生錯誤。 |