調用ApplyCertificate介面為網站申請免費認證-邊緣安全加速-阿里雲

申請免費認證。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

esa:ApplyCertificate

create

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

無

請求參數

名稱	類型	必填	描述	樣本值
SiteId	integer	是	網站 ID。	1234567890123
Domains	string	是	網域名稱列表，多個網域名稱用逗號分隔。	www.example.com,blog.example.com
Type	string	否	認證類型。可能值：lets_encrypt：Let's Encrypt 認證；digicert_single：Digicert 單網域名稱認證；digicert_wildcard：Digicert 泛網域名稱認證。枚舉值： digicert_wildcard : digicert_wildcard lets_encrypt : lets_encrypt digicert_single : digicert_single	lets_encrypt

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
SiteName	string	網站名稱。	example.com
TotalCount	integer	申請的認證個數，和輸入的網域名稱個數相同。	2
Result	array<object>	免費認證申請詳情列表。
	object	免費認證申請詳情。
Domain	string	認證網域名稱。	*.example.com
Status	string	認證申請狀態。	Applying
Id	string	認證 Id。	30000478
RequestId	string	請求 ID。	156A6B-677B1A-4297B7-9187B7-2B44792

樣本

正常返回樣本

JSON格式

{
  "SiteName": "example.com ",
  "TotalCount": 2,
  "Result": [
    {
      "Domain": "*.example.com ",
      "Status": "Applying",
      "Id": "30000478"
    }
  ],
  "RequestId": "156A6B-677B1A-4297B7-9187B7-2B44792"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	SiteNotFound	The specified site is not found.	您指定的網站不存在，請檢查輸入的網站是否正確。
400	SiteNotActivated	The site is not activated, the process is not allowed.	網站未啟用，不支援該操作。
400	MissingSiteId	Required parameter SiteId missing. Specify SiteId and try again.	缺少必填參數SiteId，請指定SiteId參數後重試。
400	InvalidParameter.Domains	You have already submitted a certificate application for the domain name.	您已提交該網域名稱認證申請任務，請勿重複提交。
400	InternalException	Failed to call the service. Try again later or contact technical support.	調用服務失敗，請稍後重試或聯絡客服諮詢詳情。
400	QuotaCheckFailed	Failed to check free certificate Quota, please try again later.	檢查免費認證Quota失敗，請稍後重試。
400	InvalidParameter.Type	The specified Type parameter is invalid, please check and try again.	您配置的Type參數有誤，請您檢查後重試。認證申請Type支援lets_encrypt，digicert_single，digicert_wildcard。
400	QuotaExceed.RecordCount	The maximum number of records has been reached. Delete some and try again or upgrade your plan.	記錄數量已達上限，請刪除部分記錄後重試或升級套餐。
403	Unauthorized.InvalidTime	The specified authentication time is invalid.	您輸入的鑒權時間參數無效，請檢查參數值後重試。
403	Unauthorized.InvalidToken	Token authentication failed.	您輸入的token無效，請檢查並輸入正確的token後進行重試。
403	QuotaExceeded	The quota is exceeded.	額度不足

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

變更歷史

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