获取配置文件模板
获取指定用户可以注册的配置文件模板的列表。 此方法返回配置文件模板的有限视图。 返回的配置文件模板数据应足以使请求的用户可以决定他们需要注册哪些配置文件模板(如有)。 如果未指定工作流和权限,则返回对用户可见的所有配置文件模板。
注意
本文中的 URL 相对于 API 部署期间选择的主机名,例如 https://api.contoso.com
。
请求
方法 | 请求 URL |
---|---|
GET | /CertificateManagement/api/v1.0/profiletemplates?[targetuser] |
URL 参数
参数 | 说明 |
---|---|
targetuser | 可选。 指定返回配置文件模板的目标用户。 如果未指定,则使用当前用户的标识。 注意:目前仅支持当前用户。 |
请求标头
有关常见请求标头,请参阅 CM REST API 服务详细信息中的 HTTP 请求和响应标头。
请求正文
无。
响应
本部分介绍响应。
响应代码
代码 | 说明 |
---|---|
200 | 确定 |
204 | 无内容 |
500 | 内部错误 |
响应标头
有关常见响应标头,请参阅 CM REST API 服务详细信息中的 HTTP 请求和响应标头。
响应正文
成功后,返回具有以下属性的 ProfileTemplateLimitedView 对象的列表:
属性 | 类型 | 说明 |
---|---|---|
名称 | 字符串 | 配置文件模板的显示名称。 |
说明 | 字符串 | 配置文件模板说明。 |
Uuid | Guid | 配置文件模板的标识符。 |
IsSmartcardProfileTemplate | bool | 指示模板是否为智能卡配置文件模板。 |
IsVirtualSmartcardProfileTemplate | bool | 指示配置文件模板是否需要虚拟智能卡。 |
示例
本部分提供一个示例,用于获取指定用户的配置文件模板列表。
示例:请求
GET /certificatemanagement/api/v1.0/profiletemplates HTTP/1.1
示例:响应
HTTP/1.1 200 OK
[
{
"Name":"FIM CM Sample Profile Template",
"Description":"Description of the template goes here",
"Uuid":"12bd5120-86a2-4ee1-8d05-131066871578",
"IsSmartcardProfileTemplate":false,
"IsVirtualSmartcardProfileTemplate":false
},
{
"Name":"FIM CM Sample Smart Card Logon Profile Template",
"Description":"Description of the template goes here",
"Uuid":"2b7044cf-aa96-4911-b886-177947e9271b",
"IsSmartcardProfileTemplate":true,
"IsVirtualSmartcardProfileTemplate":false
}
]