Hämta profilmallar
Hämtar en lista över profilmallar som den angivna användaren kan registrera sig för. Den här metoden returnerar en begränsad vy av profilmallen. De profilmalldata som returneras bör vara tillräckliga för att den begärande användaren ska kunna bestämma vilken profilmall, om någon, som de behöver registreras för. Om inget arbetsflöde och behörighet anges returneras alla profilmallar som är synliga för användaren.
Anteckning
URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com
.
Förfrågan
Metod | Begärans-URL |
---|---|
GET | /CertificateManagement/api/v1.0/profiletemplates? [targetuser] |
URL-parametrar
Parameter | Beskrivning |
---|---|
targetuser | Valfritt. Anger den målanvändare som profilmallarna ska returneras för. Om inget anges används den aktuella användarens identitet. Obs! För närvarande stöds endast den aktuella användaren. |
Begärandehuvuden
Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.
Begärandetext
Inga.
Svarsåtgärder
I det här avsnittet beskrivs svaret.
Svarskoder
Kod | Description |
---|---|
200 | OK |
204 | Inget innehåll |
500 | Internt fel |
Svarshuvuden
Vanliga svarshuvuden finns i HTTP-begärande- och svarshuvuden i CM REST API-tjänstinformation.
Själva svaret
Vid lyckat resultat returneras en lista med ProfileTemplateLimitedView-objekt med följande egenskaper:
Egenskap | Typ | Beskrivning |
---|---|---|
Name | sträng | Profilmallens visningsnamn. |
Description | sträng | Beskrivningen av profilmallen. |
Uuid | GUID | Identifieraren för profilmallen. |
IsSmartcardProfileTemplate | boolesk | Anger om mallen är en profilmall för smartkort. |
IsVirtualSmartcardProfileTemplate | boolesk | Anger om profilmallen kräver ett virtuellt smartkort. |
Exempel
Det här avsnittet innehåller ett exempel för att hämta listan över profilmallar för den angivna användaren.
Exempel: Begäran
GET /certificatemanagement/api/v1.0/profiletemplates HTTP/1.1
Exempel: Svar
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
}
]