全部產品
Search

搜尋本產品

    ：CreateRootCACertificate - 建立根CA認證

    文件中心

    ：CreateRootCACertificate - 建立根CA認證

    更新時間：Dec 16, 2025

    建立一個根CA認證。

    介面說明

    本介面用於建立一個自簽名的根 CA 憑證。根 CA 憑證是企業內部私人認證信任鏈結的起點。只有建立根 CA 憑證後，您才可以使用根 CA 憑證簽發子 CA 憑證，然後使用子 CA 憑證簽發用戶端與服務端認證。

    調用本介面前，您必須已經通過 SSL 憑證服務控制台購買了私人根 CA，否則會調用失敗。相關操作，請參見購買私人 CA。

    QPS 限制

    本介面的單使用者 QPS 限制為 10 次/秒。超過限制，API 呼叫將會被限流，這可能影響您的業務，請合理調用。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-cert:CreateRootCACertificate

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    CommonName

    string

    是

    組織機構的通用名稱或簡稱。支援使用中文、英文字元等。

    Alibaba
    OrganizationUnit

    string

    是

    組織機構下部門或分支的名稱。支援使用中文、英文字元等。

    Security
    Organization

    string

    是

    根 CA 憑證關聯的組織機構（對應您的企業或單位）的名稱。支援使用中文、英文字元等。

    Aliyun
    Locality

    string

    是

    組織機構所在城市的名稱。支援使用中文、英文字元等。

    Hangzhou
    State

    string

    是

    組織機構所在省份或州的名稱。支援使用中文、英文字元等。

    Zhejiang
    CountryCode

    string

    否

    組織機構所在國家或地區的代碼，使用兩位大寫英文字母縮寫表示。例如，CN 表示中國，US 表示美國。

    關於不同國家的代碼，請參見管理公司資訊中的國際代號章節。

    CN
    Algorithm

    string

    否

    根 CA 憑證的密鑰演算法類型。密鑰演算法使用<密碼編譯演算法>_<密鑰長度>格式表示。取值：

    • RSA_1024：對應簽名演算法為 Sha256WithRSA。

    • RSA_2048：對應簽名演算法為 Sha256WithRSA。

    • RSA_4096：對應簽名演算法為 Sha256WithRSA。

    • ECC_256：對應簽名演算法為 Sha256WithECDSA。

    • ECC_384：對應簽名演算法為 Sha256WithECDSA。

    • ECC_512：對應簽名演算法為 Sha256WithECDSA。

    • SM2_256：對應簽名演算法為 SM3WithSM2。

    根 CA 憑證的密碼編譯演算法必須與您購買的私人根 CA 的認證演算法一致。樣本：如果您購買私人根 CA 時選擇的認證演算法為 RSA，則根 CA 憑證的密鑰演算法必須是RSA_1024、RSA_2048或RSA_4096。

    RSA_2048
    Years

    integer

    是

    根 CA 憑證的有效期間，單位：年。

    說明

    建議設定為 5~10 年。

    10
    ClientToken

    string

    否

    用戶端 Token，用於保證請求的等冪性。

    從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

    說明

    若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。

    3838B684-3075-582B-9A45-8C99104029DF
    Tags

    array<object>

    否

    標籤列表。

    object

    否

    標籤列表。

    Key

    string

    否

    標籤鍵。

    runtime
    Value

    string

    否

    標籤值。

    1
    ResourceGroupId

    string

    否

    資源分組 ID。

    rg-aek****wia

    調用 API 時，除了本文中該 API 的請求參數，還需加入阿里雲 API 公用請求參數。

    調用 API 的請求格式，請參見本文樣本中的請求樣本。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    對象。

    RequestId

    string

    本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。

    6D9B4C5F-7140-5B41-924C-329181DC00C1
    Identifier

    string

    本次請求建立的根 CA 憑證的唯一識別碼。

    1a83bcbb89e562885e40aa0108f5****
    Certificate

    string

    本次調用建立的 PEM 格式根憑證。

    -----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----
    CertificateChain

    string

    本次調用建立的根憑證的 CA 憑證鏈。

    -----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "6D9B4C5F-7140-5B41-924C-329181DC00C1",
  "Identifier": "1a83bcbb89e562885e40aa0108f5****",
  "Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n"
}

    錯誤碼

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

    變更歷史

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