Pobieranie szablonów profilów

Pobiera listę szablonów profilów, dla których określony użytkownik może zarejestrować. Ta metoda zwraca ograniczony widok szablonu profilu. Zwrócone dane szablonu profilu powinny być wystarczające, aby umożliwić użytkownikowi żądanie podjęcia decyzji o szablonie profilu, jeśli istnieje, muszą 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ą powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, na przykład https://api.contoso.com.

Żądanie

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

Parametry URL

Parametr	Opis
targetuser	Opcjonalny. Określa użytkownika docelowego do zwracania szablonów profilów. Jeśli nie zostanie określona, zostanie użyta 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 Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST cm.

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 Nagłówki żądań HTTP i odpowiedzi w szczegółach usługi interfejsu API REST cm.

Treść odpowiedzi

Po powodzeniu 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 pobierania listy 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
    }
]