Hämta profilmallar

  • Artikel

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