取得智慧卡或配置文件憑證

發行項
03/22/2025

取得與特定智慧卡或軟體配置檔相關聯的憑證清單。

備註

本文中的 URL 相對於 API 部署期間所選擇的主機名，例如 https://api.contoso.com。

請求

方法	請求 URL
獲取	/CertificateManagement/api/v1.0/profiles/{id}/certificates /CertificateManagement/api/v1.0/smartcards/{id}/certificates

URL 參數

參數	說明
識別碼	配置檔或智慧卡的識別碼（GUID）。

請求標頭

如需常見的要求標頭，請參閱 CM REST API 服務詳細數據中的 HTTP 要求和回應標頭。

請求主體

沒有。

回應

本節描述回應。

回應碼

程式碼	說明
200	還行
204	沒有內容
403	禁止
500	內部錯誤

回應標頭

如需常見的響應標頭，請參閱 CM REST API 服務詳細資料中的 HTTP 要求和回應標頭。

回應主體

成功時，傳回 JSON 串行化列表Microsoft.Clm.Shared.Certificates.X509ClmCertificate 物件，其中包含下列屬性：

名稱	說明
ArchivedOnCa	布爾值，指出憑證是否封存於證書頒發機構單位（CA）上。
證書類型	憑證的類型。
IsKeyHistory	布爾值，指出憑證是否為密鑰歷程記錄憑證。
序號	憑證的序號。
TemplateCommonName	憑證的證書範本通用名稱。
指紋	憑證的指紋。

範例

本節提供一個範例，以取得與智慧卡或軟體配置文件相關聯的憑證。

範例：請求

GET /certificatemanagement/api/v1.0/smartcards/5badfea3-de31-4837-99f9-8249515a5473/certificates HTTP/1.1

範例：回應

HTTP/1.1 200 OK

[
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B01052AFA01313FB77AC00010000B010",
        "Thumbprint":"C52B0C5FB8AAD31A5B239FF2712ED14122D67D30"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B011AB48AE7D664ED5D900010000B011",
        "Thumbprint":"E7C4324896271BE869544FF28AA2B1BF3B3BDFCF"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B01ABCF2D38A0CCEAD8F00010000B01A",
        "Thumbprint":"D9293B5414C644888444541B64631E90F2612425"
    },
    {
        "IsKeyHistory":false,
        "ArchivedOnCa":false,
        "CertificateType":1,
        "TemplateCommonName":"ContosoVirtualSmartCardLimitedRelease-KSP",
        "SerialNumber":"1B0000B1F02865CF2C3A9DD96D00010000B1F0",
        "Thumbprint":"6615DDC8603DBA789D724502627682F37D0FC2D0"
    }
]

共用方式為