取得智慧卡或設定檔憑證

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

注意

本文中的 Url 會相對於 API 部署期間所選擇的主機名稱,例如 https://api.contoso.com

要求

方法 要求 URL
GET /CertificateManagement/api/v1.0/profiles/{id}/certificates
/CertificateManagement/api/v1.0/smartcards/{id}/certificates

URL 參數

參數 描述
id 設定檔或智慧卡的識別碼 (GUID) 。

要求標頭

關於常見的要求標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭

要求本文

無。

回應

本節說明回應。

回應碼

程式碼 描述
200 [確定]
204 沒有內容
403 禁止
500 內部錯誤

回應標頭

關於常見的回應標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭

回應本文

成功時,會傳回包含下列屬性的 JSON 序列化 Microsoft.Clm.Shared.Certificates.X509ClmCertificate \(英文\) 物件清單:

Name 描述
ArchivedOnCa 布林值,指出憑證是否封存在憑證授權單位 (CA)。
CertificateType 憑證的類型。
IsKeyHistory 布林值,指出憑證是否為金鑰歷程記錄憑證。
SerialNumber 憑證的序號。
TemplateCommonName 憑證的憑證範本一般名稱。
Thumbprint 憑證的指紋。

範例

本節提供的範例可讓您取得與智慧卡或軟體設定檔相關聯的憑證。

範例:要求

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"
    }
]

另請參閱