Uzyskiwanie szablonów profilów

Pobiera listę szablonów profilów, dla których określony użytkownik może się zarejestrować. Ta metoda zwraca ograniczony widok szablonu profilu. Zwrócone dane szablonu profilu powinny być wystarczające, aby umożliwić żądająceowi użytkownikowi podjęcie decyzji, w którym szablonie profilu musi się zarejestrować. Jeśli nie określono żadnego przepływu pracy i uprawnień, zostaną zwrócone wszystkie szablony profilów widoczne dla użytkownika.

Uwaga

Adresy URL w tym artykule są względne względem nazwy hosta wybranej podczas wdrażania interfejsu API, takiej jak https://api.contoso.com .

Żądanie

Metoda Adres URL żądania
GET /CertificateManagement/api/v1.0/profiletemplates? [targetuser]

Parametry URL

Parametr Opis
użytkownik docelowy Opcjonalny. Określa użytkownika docelowego, dla których mają być zwracane szablony profilów. Jeśli nie zostanie określona, używana jest tożsamość bieżącego użytkownika.

Uwaga:obecnie obsługiwany jest tylko bieżący użytkownik.

Nagłówki żądań

Aby uzyskać typowe nagłówki żądań, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
204 Brak zawartości
500 Błąd wewnętrzny

Nagłówki odpowiedzi

Aby uzyskać typowe nagłówki odpowiedzi, zobacz Http request and response headers (Nagłówki żądań i odpowiedzi HTTP) w tesłudze.

Treść odpowiedzi

W przypadku powodzenia zwraca listę obiektów ProfileTemplateLimitedView z następującymi właściwościami:

Właściwość Typ Opis
Nazwa ciąg Nazwa wyświetlana szablonu profilu.
Opis ciąg Opis szablonu profilu.
Identyfikator UUID Guid (identyfikator GUID) Identyfikator szablonu profilu.
IsSmartcardProfileTemplate bool Wskazuje, czy szablon jest szablonem profilu karty inteligentnej.
IsVirtualSmartcardProfileTemplate bool Wskazuje, czy szablon profilu wymaga wirtualnej karty inteligentnej.

Przykład

Ta sekcja zawiera przykład, w których można pobrać listę szablonów profilów dla określonego użytkownika.

Przykład: Żądanie

GET /certificatemanagement/api/v1.0/profiletemplates HTTP/1.1

Przykład: Odpowiedź

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