全部產品
Search

搜尋本產品

    Certificate Management Service：CreateExternalCACertificate

    文件中心

    Certificate Management Service：CreateExternalCACertificate

    更新時間：Aug 24, 2026

    基於 CSR 和 API 參數建立並頒發外部子 CA 憑證。

    介面說明

    請求說明

    • 本介面用於根據提供的憑證簽章請求（CSR）以及可選的 API 透傳參數來建立一個外部子 CA 憑證。

    • InstanceId 是必填項，代表需要啟用的外部子 CA 執行個體 ID。

    • Csr 欄位必須包含有效的憑證簽章請求內容。

    • Validity 參數定義了憑證的有效期間，支援相對時間和絕對時間格式。

    • 透過 ApiPassthrough 可以覆蓋 CSR 中的部分資訊或新增額外的憑證擴充項目，例如主體資訊 (Subject) 和擴充項目 (Extensions) 等。

    • 注意：對於 EndEntity CA 類型的憑證，pathLenConstraint 應設定為 0。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-cert:CreateExternalCACertificate

    create

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    InstanceId

    string

    否

    需要啟用的外部子 CA 執行個體 ID。

    cas_deposit-cn-1234abcd
    Csr

    string

    否

    憑證簽章請求。可包含 CA 憑證的 SubjectDN、CA 憑證自訂擴充項目等。SubjectKeyIdentifier、AuthorityKeyIdentifier、CRLDistributionPoints 憑證擴充項目由 CA 產生，CSR 中的值會被忽略。

    -----BEGIN CERTIFICATE REQUEST----- MIIBczCCARgCAQAwgYoxFDASBgNVBAMMC2FsaXl1bi50ZXN0MQ0wCwYDVQQ ... vbIgMQIhAKHDWD6/WAMbtezAt4bysJ/BZIDz1jPWuUR5GV4TJ/mS -----END CERTIFICATE REQUEST-----

    Validity

    string

    否

    憑證有效期間。支援使用相對時間和絕對時間。

    說明

    相對時間：支援單位年、月、日。

    • 年 - y

    • 月 - m

    • 日 - d

    說明

    絕對時間：使用 GMT 時間。格式：yyyy-MM-dd'T'HH:mm:ss'Z'

    • 指定結束時間 - $NotAfter

    • 指定開始時間和結束時間 - $NotBefore/$NotAfter

    10y
    ApiPassthrough

    object

    否

    透過 API 參數覆蓋 CSR 內容或新增到 CA 憑證中。

    Subject

    object

    否

    CA 憑證主體資訊。該值存在時會覆蓋 CSR 中的 SubjectDN。

    Country

    string

    否

    所屬國家。使用 ISO 3166-1 的二位國家代碼。

    CN
    State

    string

    否

    所屬省/自治區/直轄市。

    Zhejiang
    Locality

    string

    否

    所屬城市/區域。

    Hangzhou
    Organization

    string

    否

    所屬組織/公司。

    Alibaba
    OrganizationUnit

    string

    否

    所屬組織內部的子單位（部門、團隊、專案群組或分支機構）。

    Cloud Security
    CommonName

    string

    否

    目前 CA 憑證名稱。

    Testing CA
    Extensions

    object

    否

    CA 憑證擴充項目。該值存在時會覆蓋 CSR 中的擴充項目值，或新增到 CA 憑證擴充項目中。

    PathLenConstraint

    integer

    否

    憑證路徑長度限制。EndEntity CA 該值必須傳 0，即目前 CA 憑證用於頒發 End Entity 憑證。

    0
    ExtendedKeyUsages

    array

    否

    擴充金鑰用法。

    string

    否

    允許使用以下值：

    • any - 不限制

    • serverAuth - 伺服器驗證

    • clientAuth - 用戶端驗證

    • codeSigning - 程式碼簽章

    • emailProtection - 郵件保護

    • timeStamping - 時間戳記

    • OCSPSigning - OCSP 簽章

    • 其他擴充金鑰用法 OID

    枚舉值：

    • codeSigning :

      codeSigning

    • emailProtection :

      emailProtection

    • serverAuth :

      serverAuth

    • timeStamping :

      timeStamping

    • any :

      any

    • clientAuth :

      clientAuth

    • OCSPSigning :

      OCSPSigning

    serverAuth
    Tags

    array<object>

    否

    標籤清單。

    object

    否

    標籤清單。

    Key

    string

    否

    標籤鍵。

    database
    Value

    string

    否

    標籤值。

    1
    ResourceGroupId

    string

    否

    資源群組 ID。

    test
    CertMaxTime

    integer

    否

    簽發憑證的最長時間由 CA 的 certMaxTime 指定。單位：天。

    30

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    OpenApiResponse

    RequestId

    string

    本次請求的 ID。

    12345678-1234-1234-1234-123456789ABC
    Identifier

    string

    憑證唯一識別碼。

    1ed4068c-6f1b-6deb-8e32-3f8439a851cb
    Certificate

    string

    憑證內容。

    -----BEGIN CERTIFICATE----- MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/ ... ... ... KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg== -----END CERTIFICATE-----

    CertificateChain

    string

    CA 憑證鏈。

    -----BEGIN CERTIFICATE----- ... ... -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- ... ... -----END CERTIFICATE-----

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "12345678-1234-1234-1234-123456789ABC",
  "Identifier": "1ed4068c-6f1b-6deb-8e32-3f8439a851cb",
  "Certificate": "-----BEGIN CERTIFICATE-----\nMIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/\n...\n...\n...\nKOqkqm57TH2H3eDJAkSnh6/DNFu0Qg==\n-----END CERTIFICATE-----\n",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----\n"
}

    錯誤碼

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

    變更歷史

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