全部產品
Search

搜尋本產品

    ApsaraVideo VOD：DescribeVodDomainCertificateInfo - 查詢網域名稱認證

    文件中心

    ApsaraVideo VOD：DescribeVodDomainCertificateInfo - 查詢網域名稱認證

    更新時間：Apr 24, 2026

    調用本介面擷取指定加速網域名稱的認證資訊。

    介面說明

    目前服務地區僅支援：華東 2（上海）。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:DescribeVodDomainCertificateInfo

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DomainName

    string

    是

    點播加速網域名稱。

    example.com
    HeraApiAutoVersion

    string

    否

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    5C1E43DC-9E51-4771-****-7D5ECEB547A1
    CertInfos

    object

    CertInfo

    array<object>

    認證資訊。

    object

    CertExpireTime

    string

    認證到期時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2018-06-03T13:03:39Z
    CertLife

    string

    認證時間長度。單位：months（月），years（年）。

    3 months
    Status

    string

    認證狀態。

    • success：已生效

    • checking：檢測網域名稱是否在阿里雲點播

    • cname_error：網域名稱沒有切到阿里雲點播

    • domain_invalid：網域名稱包含非法字元

    • unsupport_wildcard：不支援泛網域名稱

    • applying：認證申請中

    • failed：認證申請失敗

    說明

    僅當CertType為free時，該欄位才會傳回值，其他類型的認證該欄位返回為空白。

    success
    CertUpdateTime

    string

    認證更新時間。

    2023-04-26T20:23:38Z
    CertDomainName

    string

    認證匹配的網域名稱。

    example.com
    ServerCertificateStatus

    string

    HTTPS 認證開啟狀態。

    • on：已開啟

    • off：未開啟

    on
    CertOrg

    string

    認證組織。

    Let's Encrypt
    DomainName

    string

    加速網域名稱。

    example.com
    CertStartTime

    string

    認證開始時間。

    2023-04-26T20:23:38Z
    CertType

    string

    認證類型。取值：

    • free：免費認證

    • cas：Apsara Stack Security認證

    • upload：自訂上傳

    free
    CertName

    string

    認證名稱。

    cert-example.com
    DomainCnameStatus

    string

    網域名稱的 CNAME 狀態：

    • ok: 網域名稱指向了阿里雲 CDN 分配的 CNAME。 cname_error: 發生錯誤，網域名稱無法指向 CNAME。

    • op_domain_cname_error: 頂級網域名稱的 CNAME 發生錯誤，網域名稱無法指向 CNAME。

    • unsupport_wildcard: 不支援萬用字元網域名稱。

    ok
    ServerCertificate

    string

    認證公開金鑰。

    ****
    CertId

    string

    認證 ID。

    13227737-cn-hangzhou
    CertRegion

    string

    認證使用地區。

    cn-hangzhou

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "5C1E43DC-9E51-4771-****-7D5ECEB547A1",
  "CertInfos": {
    "CertInfo": [
      {
        "CertExpireTime": "2018-06-03T13:03:39Z",
        "CertLife": "3 months",
        "Status": "success",
        "CertUpdateTime": "2023-04-26T20:23:38Z",
        "CertDomainName": "example.com",
        "ServerCertificateStatus": "on",
        "CertOrg": "Let's Encrypt",
        "DomainName": "example.com",
        "CertStartTime": "2023-04-26T20:23:38Z",
        "CertType": "free",
        "CertName": "cert-example.com",
        "DomainCnameStatus": "ok",
        "ServerCertificate": "****",
        "CertId": "13227737-cn-hangzhou",
        "CertRegion": "cn-hangzhou"
      }
    ]
  }
}

    錯誤碼

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

    變更歷史

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