Udostępnij przez


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 żądającemu podjęcie decyzji o tym, który szablon profilu, jeśli istnieje, musi zostać zarejestrowany. 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, taką jak https://api.contoso.com.

Żądanie

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

Parametry URL

Parametr Opis
targetuser Opcjonalny. Określa docelowy użytkownik, dla których ma być zwracany szablony profilów. Jeśli nie zostanie określony, zostanie użyta tożsamość bieżącego użytkownika.

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

Nagłówki zapytań

Aby uzyskać typowe nagłówki żądań, zobacz nagłówki żądań i odpowiedzi HTTP w szczegółach usługi interfejsu API REST CM.

Ciało żądania

Żaden.

Odpowiedź

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 API REST.

Ciało odpowiedzi

Po powodzeniu zwraca listę obiektów ProfileTemplateLimitedView z następującymi właściwościami:

Nieruchomość / Majątek Typ Opis
Nazwa sznurek Nazwa wyświetlana szablonu profilu.
Opis sznurek Opis szablonu profilu.
Uuid 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 umożliwiający pobranie 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
    }
]