取得使用者的軟體憑證配置檔清單。 此清單包含可由目前使用者執行的可能作業。 然後可以針對任何指定的作業起始要求。
這很重要
只有當配置檔範本原則指出應該完成時，伺服器才會設定 PIN。 否則，用戶應該提供 PIN。
備註
本文中的 URL 相對於 API 部署期間所選擇的主機名，例如 https://api.contoso.com。
請求
| 方法 | 請求 URL |
|---|---|
| 獲取 | /CertificateManagement/api/v1.0/profiles /CertificateManagement/api/v1.0/profiles/{id} /CertificateManagement/api/v1.0/requests/{requestid}/profiles |
URL 參數
| 參數 | 說明 |
|---|---|
| 識別碼 | 要傳回之配置檔的識別碼 （GUID）。 |
| 請求編號 | 要傳回配置檔之要求的標識碼。 |
查詢參數
| 參數 | 說明 |
|---|---|
| 地位 | 選擇性。 指出要擷取數據的配置文件狀態。 可能的狀態類型為「作用中」、「已核准」、「已取消」、「已完成」、「拒絕」、「執行中」、「失敗」、「無」和「擱置」。 如果未指定任何狀態，則不論傳回狀態為何，所有配置檔都會傳回。 |
請求標頭
如需常見的要求標頭，請參閱 CM REST API 服務詳細數據中的 HTTP 要求和回應標頭。
請求主體
沒有。
回應
本節描述回應。
回應碼
| 程式碼 | 說明 |
|---|---|
| 200 | 還行 |
| 204 | 沒有內容 |
| 403 | 禁止 |
| 500 | 內部錯誤 |
回應標頭
如需常見的響應標頭，請參閱 CM REST API 服務詳細資料中的 HTTP 要求和回應 標頭。
回應主體
成功時，傳回 JSON 串行化 Microsoft.Clm.Shared.Profiles.Profile 列表， 物件具有下列屬性：
| 財產 | 說明 |
|---|---|
| AssignedUserUuid | 指派配置檔之使用者的識別碼。 |
| 評論 | 描述配置檔的批注。 |
| 標誌 | 描述配置檔的旗標。 |
| ParentProfileUuid | 配置檔已取代之舊配置檔的識別碼。 |
| PrimaryProfileUuid | 主要配置文件的識別碼。 |
| ProfileOperations | 配置檔上目前用戶可執行的可能作業清單。 |
| ProfileTemplateUuid | 配置檔範本的識別碼，其中包含控管配置文件的原則和設定。 |
| ProfileTemplateVersion | 建立配置檔時設定檔範本的版本。 |
| 地位 | 配置檔的狀態。 |
| Uuid | 配置文件的識別碼。 |
範例
本節提供取得使用者配置檔數據的範例。
範例：請求
GET /certificatemanagement/api/v1.0/profiles?status=Active HTTP/1.1
範例：回應
HTTP/1.1 200 OK
[
{
"Uuid":"c0dd5c7d-ec35-4346-baca-3ad711e9722f",
"Status":2,
"Flags":1,
"ParentProfileUuid":"1c9e2606-fea2-4048-a6ac-b014e54c22df",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
"ProfileTemplateVersion":8,
"Comment":"",
"ProfileOperations":[
"renew",
"disable",
"recover"
]
},
{
"Uuid":"5ad77b40-aa42-4533-9396-c9c59fd021a8",
"Status":2,
"Flags":1,
"ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"8f31803f-8afc-49bb-911d-402ec264b589",
"ProfileTemplateVersion":8,
"Comment":"",
"ProfileOperations":[
"renew",
"disable",
"recover"
]
},
{
"Uuid":"ff342953-c444-4dc7-b144-f5515d6460c6",
"Status":2,
"Flags":1,
"ParentProfileUuid":"00000000-0000-0000-0000-000000000000",
"PrimaryProfileUuid":"00000000-0000-0000-0000-000000000000",
"AssignedUserUuid":"0378a33b-8650-4713-a727-efd233903643",
"ProfileTemplateUuid":"1e3a31fe-699b-4a6b-945c-18b83c985bc1",
"ProfileTemplateVersion":9,
"Comment":"",
"ProfileOperations":[
"renew",
"disable"
]
}
]